From: Johannes Schindelin <Johannes.Schindelin@gmx.de>
To: Alban Gruin <alban.gruin@gmail.com>
Cc: git@vger.kernel.org, Junio C Hamano <gitster@pobox.com>,
Phillip Wood <phillip.wood123@gmail.com>,
Derrick Stolee <stolee@gmail.com>
Subject: Re: [PATCH v7 08/15] merge-one-file: rewrite in C
Date: Mon, 22 Mar 2021 23:20:33 +0100 (CET) [thread overview]
Message-ID: <nycvar.QRO.7.76.6.2103222303210.50@tvgsbejvaqbjf.bet> (raw)
In-Reply-To: <20210317204939.17890-9-alban.gruin@gmail.com>
Hi Alban,
On Wed, 17 Mar 2021, Alban Gruin wrote:
> This rewrites `git merge-one-file' from shell to C. This port is not
> completely straightforward: to save precious cycles by avoiding reading
> and flushing the index repeatedly, write temporary files when an
> operation can be performed in-memory, or allow other function to use the
> rewrite without forking nor worrying about the index, the calls to
> external processes are replaced by calls to functions in libgit.a:
>
> - calls to `update-index --add --cacheinfo' are replaced by calls to
> add_to_index_cacheinfo();
>
> - calls to `update-index --remove' are replaced by calls to
> remove_file_from_index();
>
> - calls to `checkout-index -u -f' are replaced by calls to
> checkout_entry();
>
> - calls to `unpack-file' and `merge-files' are replaced by calls to
> read_mmblob() and xdl_merge(), respectively, to merge files
> in-memory;
>
> - calls to `checkout-index -f --stage=2' are removed, as this is needed
> to have the correct permission bits on the merged file from the
> script, but not in the C version;
>
> - calls to `update-index' are replaced by calls to add_file_to_index().
>
> The bulk of the rewrite is done in a new file in libgit.a,
> merge-strategies.c. This will enable the resolve and octopus strategies
> to directly call it instead of forking.
>
> This also fixes a bug present in the original script: instead of
> checking if a _regular_ file exists when a file exists in the branch to
> merge, but not in our branch, the rewritten version checks if a file of
> any kind (ie. a directory, ...) exists. This fixes the tests t6035.14,
> where the branch to merge had a new file, `a/b', but our branch had a
> directory there; it should have failed because a directory exists, but
> it did not because there was no regular file called `a/b'. This test is
> now marked as successful.
>
> This also teaches `merge-index' to call merge_three_way() (when invoked
> with `--use=merge-one-file') without forking using a new callback,
> merge_one_file_func().
>
> To avoid any issue with a shrinking index because of the merge function
> used (directly in the process or by forking), as described earlier, the
> iterator of the loop of merge_all_index() is increased by the number of
> entries with the same name, minus the difference between the number of
> entries in the index before and after the merge.
>
> This should handle a shrinking index correctly, but could lead to issues
> with a growing index. However, this case is not treated, as there is no
> callback that can produce such a case.
Nice!
> diff --git a/builtin/merge-index.c b/builtin/merge-index.c
> index fd5b1a5a92..04d38aa130 100644
> --- a/builtin/merge-index.c
> +++ b/builtin/merge-index.c
> @@ -38,7 +38,7 @@ static int merge_one_file_spawn(struct index_state *istate,
> int cmd_merge_index(int argc, const char **argv, const char *prefix)
> {
> int i, force_file = 0, err = 0, one_shot = 0, quiet = 0;
> - merge_fn merge_action = merge_one_file_spawn;
> + merge_fn merge_action;
> struct lock_file lock = LOCK_INIT;
> struct repository *r = the_repository;
> const char *use_internal = NULL;
> @@ -69,10 +69,13 @@ int cmd_merge_index(int argc, const char **argv, const char *prefix)
>
> if (skip_prefix(pgm, "--use=", &use_internal)) {
> if (!strcmp(use_internal, "merge-one-file"))
> - pgm = "git-merge-one-file";
> + merge_action = merge_one_file_func;
> else
> die(_("git merge-index: unknown internal program %s"), use_internal);
> - }
> +
> + repo_hold_locked_index(r, &lock, LOCK_DIE_ON_ERROR);
> + } else
> + merge_action = merge_one_file_spawn;
I would have a slight preference to keep the default initializer, because
that makes it easer to reason about. But if you _want_ to keep this patch
as-is, I won't object.
It is a bit sad that the conversion cannot be done more incrementally, as
there is a lot to unpack in the many different cases that are handled. It
looks correct, though.
Just one thing:
>
> for (; i < argc; i++) {
> const char *arg = argv[i];
> diff --git a/builtin/merge-one-file.c b/builtin/merge-one-file.c
> new file mode 100644
> index 0000000000..ad99c6dbd4
> --- /dev/null
> +++ b/builtin/merge-one-file.c
> @@ -0,0 +1,94 @@
> +/*
> + * Builtin "git merge-one-file"
> + *
> + * Copyright (c) 2020 Alban Gruin
> + *
> + * Based on git-merge-one-file.sh, written by Linus Torvalds.
> + *
> + * This is the git per-file merge utility, called with
> + *
> + * argv[1] - original file object name (or empty)
> + * argv[2] - file in branch1 object name (or empty)
> + * argv[3] - file in branch2 object name (or empty)
> + * argv[4] - pathname in repository
> + * argv[5] - original file mode (or empty)
> + * argv[6] - file in branch1 mode (or empty)
> + * argv[7] - file in branch2 mode (or empty)
> + *
> + * Handle some trivial cases. The _really_ trivial cases have been
> + * handled already by git read-tree, but that one doesn't do any merges
> + * that might change the tree layout.
> + */
> +
> +#include "cache.h"
> +#include "builtin.h"
> +#include "lockfile.h"
> +#include "merge-strategies.h"
> +
> +static const char builtin_merge_one_file_usage[] =
> + "git merge-one-file <orig blob> <our blob> <their blob> <path> "
> + "<orig mode> <our mode> <their mode>\n\n"
> + "Blob ids and modes should be empty for missing files.";
> +
> +static int read_mode(const char *name, const char *arg, unsigned int *mode)
> +{
> + char *last;
> + int ret = 0;
> +
> + *mode = strtol(arg, &last, 8);
> +
> + if (*last)
> + ret = error(_("invalid '%s' mode: expected nothing, got '%c'"), name, *last);
> + else if (!(S_ISREG(*mode) || S_ISDIR(*mode) || S_ISLNK(*mode)))
> + ret = error(_("invalid '%s' mode: %o"), name, *mode);
> +
> + return ret;
> +}
> +
> +int cmd_merge_one_file(int argc, const char **argv, const char *prefix)
> +{
> + struct object_id orig_blob, our_blob, their_blob,
> + *p_orig_blob = NULL, *p_our_blob = NULL, *p_their_blob = NULL;
> + unsigned int orig_mode = 0, our_mode = 0, their_mode = 0, ret = 0;
> + struct lock_file lock = LOCK_INIT;
> + struct repository *r = the_repository;
> +
> + if (argc != 8)
> + usage(builtin_merge_one_file_usage);
> +
> + if (repo_read_index(r) < 0)
> + die("invalid index");
> +
> + repo_hold_locked_index(r, &lock, LOCK_DIE_ON_ERROR);
> +
> + if (!get_oid_hex(argv[1], &orig_blob)) {
> + p_orig_blob = &orig_blob;
> + ret = read_mode("orig", argv[5], &orig_mode);
> + } else if (!*argv[1] && *argv[5])
> + ret = error(_("no 'orig' object id given, but a mode was still given."));
Here, it looks as if the case of an empty `argv[1]` is not handled
_explicitly_, but we rely on `get_oid_hex()` to return non-zero, and then
we rely on the second arm _also_ not re-assigning `orig_blob`.
I wonder whether this could be checked, and whether it would make sense to
fold this, along with most of these 5 lines, into the `read_mode()` helper
function (DRYing up the code even further).
As for the rest of the patch, it is totally possible that I missed a bug,
but it looks correct to me, and the added regression tests give me a good
feeling about the patch, too.
Thanks,
Dscho
> +
> + if (!get_oid_hex(argv[2], &our_blob)) {
> + p_our_blob = &our_blob;
> + ret = read_mode("our", argv[6], &our_mode);
> + } else if (!*argv[2] && *argv[6])
> + ret = error(_("no 'our' object id given, but a mode was still given."));
> +
> + if (!get_oid_hex(argv[3], &their_blob)) {
> + p_their_blob = &their_blob;
> + ret = read_mode("their", argv[7], &their_mode);
> + } else if (!*argv[3] && *argv[7])
> + ret = error(_("no 'their' object id given, but a mode was still given."));
> +
> + if (ret)
> + return ret;
> +
> + ret = merge_three_way(r->index, p_orig_blob, p_our_blob, p_their_blob,
> + argv[4], orig_mode, our_mode, their_mode);
> +
> + if (ret) {
> + rollback_lock_file(&lock);
> + return !!ret;
> + }
> +
> + return write_locked_index(r->index, &lock, COMMIT_LOCK);
> +}
> diff --git a/git-merge-one-file.sh b/git-merge-one-file.sh
> deleted file mode 100755
> index f6d9852d2f..0000000000
> --- a/git-merge-one-file.sh
> +++ /dev/null
> @@ -1,167 +0,0 @@
> -#!/bin/sh
> -#
> -# Copyright (c) Linus Torvalds, 2005
> -#
> -# This is the git per-file merge script, called with
> -#
> -# $1 - original file SHA1 (or empty)
> -# $2 - file in branch1 SHA1 (or empty)
> -# $3 - file in branch2 SHA1 (or empty)
> -# $4 - pathname in repository
> -# $5 - original file mode (or empty)
> -# $6 - file in branch1 mode (or empty)
> -# $7 - file in branch2 mode (or empty)
> -#
> -# Handle some trivial cases.. The _really_ trivial cases have
> -# been handled already by git read-tree, but that one doesn't
> -# do any merges that might change the tree layout.
> -
> -USAGE='<orig blob> <our blob> <their blob> <path>'
> -USAGE="$USAGE <orig mode> <our mode> <their mode>"
> -LONG_USAGE="usage: git merge-one-file $USAGE
> -
> -Blob ids and modes should be empty for missing files."
> -
> -SUBDIRECTORY_OK=Yes
> -. git-sh-setup
> -cd_to_toplevel
> -require_work_tree
> -
> -if test $# != 7
> -then
> - echo "$LONG_USAGE"
> - exit 1
> -fi
> -
> -case "${1:-.}${2:-.}${3:-.}" in
> -#
> -# Deleted in both or deleted in one and unchanged in the other
> -#
> -"$1.." | "$1.$1" | "$1$1.")
> - if { test -z "$6" && test "$5" != "$7"; } ||
> - { test -z "$7" && test "$5" != "$6"; }
> - then
> - echo "ERROR: File $4 deleted on one branch but had its" >&2
> - echo "ERROR: permissions changed on the other." >&2
> - exit 1
> - fi
> -
> - if test -n "$2"
> - then
> - echo "Removing $4"
> - else
> - # read-tree checked that index matches HEAD already,
> - # so we know we do not have this path tracked.
> - # there may be an unrelated working tree file here,
> - # which we should just leave unmolested. Make sure
> - # we do not have it in the index, though.
> - exec git update-index --remove -- "$4"
> - fi
> - if test -f "$4"
> - then
> - rm -f -- "$4" &&
> - rmdir -p "$(expr "z$4" : 'z\(.*\)/')" 2>/dev/null || :
> - fi &&
> - exec git update-index --remove -- "$4"
> - ;;
> -
> -#
> -# Added in one.
> -#
> -".$2.")
> - # the other side did not add and we added so there is nothing
> - # to be done, except making the path merged.
> - exec git update-index --add --cacheinfo "$6" "$2" "$4"
> - ;;
> -"..$3")
> - echo "Adding $4"
> - if test -f "$4"
> - then
> - echo "ERROR: untracked $4 is overwritten by the merge." >&2
> - exit 1
> - fi
> - git update-index --add --cacheinfo "$7" "$3" "$4" &&
> - exec git checkout-index -u -f -- "$4"
> - ;;
> -
> -#
> -# Added in both, identically (check for same permissions).
> -#
> -".$3$2")
> - if test "$6" != "$7"
> - then
> - echo "ERROR: File $4 added identically in both branches," >&2
> - echo "ERROR: but permissions conflict $6->$7." >&2
> - exit 1
> - fi
> - echo "Adding $4"
> - git update-index --add --cacheinfo "$6" "$2" "$4" &&
> - exec git checkout-index -u -f -- "$4"
> - ;;
> -
> -#
> -# Modified in both, but differently.
> -#
> -"$1$2$3" | ".$2$3")
> -
> - case ",$6,$7," in
> - *,120000,*)
> - echo "ERROR: $4: Not merging symbolic link changes." >&2
> - exit 1
> - ;;
> - *,160000,*)
> - echo "ERROR: $4: Not merging conflicting submodule changes." >&2
> - exit 1
> - ;;
> - esac
> -
> - src1=$(git unpack-file $2)
> - src2=$(git unpack-file $3)
> - case "$1" in
> - '')
> - echo "Added $4 in both, but differently."
> - orig=$(git unpack-file $(git hash-object /dev/null))
> - ;;
> - *)
> - echo "Auto-merging $4"
> - orig=$(git unpack-file $1)
> - ;;
> - esac
> -
> - git merge-file "$src1" "$orig" "$src2"
> - ret=$?
> - msg=
> - if test $ret != 0 || test -z "$1"
> - then
> - msg='content conflict'
> - ret=1
> - fi
> -
> - # Create the working tree file, using "our tree" version from the
> - # index, and then store the result of the merge.
> - git checkout-index -f --stage=2 -- "$4" && cat "$src1" >"$4" || exit 1
> - rm -f -- "$orig" "$src1" "$src2"
> -
> - if test "$6" != "$7"
> - then
> - if test -n "$msg"
> - then
> - msg="$msg, "
> - fi
> - msg="${msg}permissions conflict: $5->$6,$7"
> - ret=1
> - fi
> -
> - if test $ret != 0
> - then
> - echo "ERROR: $msg in $4" >&2
> - exit 1
> - fi
> - exec git update-index -- "$4"
> - ;;
> -
> -*)
> - echo "ERROR: $4: Not handling case $1 -> $2 -> $3" >&2
> - ;;
> -esac
> -exit 1
> diff --git a/git.c b/git.c
> index 9bc077a025..95eb74efe1 100644
> --- a/git.c
> +++ b/git.c
> @@ -544,6 +544,7 @@ static struct cmd_struct commands[] = {
> { "merge-file", cmd_merge_file, RUN_SETUP_GENTLY },
> { "merge-index", cmd_merge_index, RUN_SETUP | NO_PARSEOPT },
> { "merge-ours", cmd_merge_ours, RUN_SETUP | NO_PARSEOPT },
> + { "merge-one-file", cmd_merge_one_file, RUN_SETUP | NEED_WORK_TREE | NO_PARSEOPT },
> { "merge-recursive", cmd_merge_recursive, RUN_SETUP | NEED_WORK_TREE | NO_PARSEOPT },
> { "merge-recursive-ours", cmd_merge_recursive, RUN_SETUP | NEED_WORK_TREE | NO_PARSEOPT },
> { "merge-recursive-theirs", cmd_merge_recursive, RUN_SETUP | NEED_WORK_TREE | NO_PARSEOPT },
> diff --git a/merge-strategies.c b/merge-strategies.c
> index c80f964612..2717af51fd 100644
> --- a/merge-strategies.c
> +++ b/merge-strategies.c
> @@ -1,5 +1,197 @@
> #include "cache.h"
> +#include "dir.h"
> #include "merge-strategies.h"
> +#include "xdiff-interface.h"
> +
> +static int add_merge_result_to_index(struct index_state *istate, unsigned int mode,
> + const struct object_id *oid, const char *path,
> + int checkout)
> +{
> + struct cache_entry *ce;
> + int res;
> +
> + res = add_to_index_cacheinfo(istate, mode, oid, path, 0, 1, 1, &ce);
> + if (res == -1)
> + return error(_("Invalid path '%s'"), path);
> + else if (res == -2)
> + return -1;
> +
> + if (checkout) {
> + struct checkout state = CHECKOUT_INIT;
> +
> + state.istate = istate;
> + state.force = 1;
> + state.base_dir = "";
> + state.base_dir_len = 0;
> +
> + if (checkout_entry(ce, &state, NULL, NULL) < 0)
> + return error(_("%s: cannot checkout file"), path);
> + }
> +
> + return 0;
> +}
> +
> +static int merge_one_file_deleted(struct index_state *istate,
> + const struct object_id *our_blob,
> + const struct object_id *their_blob, const char *path,
> + unsigned int orig_mode, unsigned int our_mode, unsigned int their_mode)
> +{
> + if ((!our_blob && orig_mode != their_mode) ||
> + (!their_blob && orig_mode != our_mode))
> + return error(_("File %s deleted on one branch but had its "
> + "permissions changed on the other."), path);
> +
> + if (our_blob) {
> + printf(_("Removing %s\n"), path);
> +
> + if (file_exists(path))
> + remove_path(path);
> + }
> +
> + if (remove_file_from_index(istate, path))
> + return error("%s: cannot remove from the index", path);
> + return 0;
> +}
> +
> +static int do_merge_one_file(struct index_state *istate,
> + const struct object_id *orig_blob,
> + const struct object_id *our_blob,
> + const struct object_id *their_blob, const char *path,
> + unsigned int orig_mode, unsigned int our_mode, unsigned int their_mode)
> +{
> + int ret, i, dest;
> + ssize_t written;
> + mmbuffer_t result = {NULL, 0};
> + mmfile_t mmfs[3];
> + xmparam_t xmp = {{0}};
> +
> + if (our_mode == S_IFLNK || their_mode == S_IFLNK)
> + return error(_("%s: Not merging symbolic link changes."), path);
> + else if (our_mode == S_IFGITLINK || their_mode == S_IFGITLINK)
> + return error(_("%s: Not merging conflicting submodule changes."), path);
> +
> + if (orig_blob) {
> + printf(_("Auto-merging %s\n"), path);
> + read_mmblob(mmfs + 0, orig_blob);
> + } else {
> + printf(_("Added %s in both, but differently.\n"), path);
> + read_mmblob(mmfs + 0, &null_oid);
> + }
> +
> + read_mmblob(mmfs + 1, our_blob);
> + read_mmblob(mmfs + 2, their_blob);
> +
> + xmp.level = XDL_MERGE_ZEALOUS_ALNUM;
> + xmp.style = 0;
> + xmp.favor = 0;
> +
> + ret = xdl_merge(mmfs + 0, mmfs + 1, mmfs + 2, &xmp, &result);
> +
> + for (i = 0; i < 3; i++)
> + free(mmfs[i].ptr);
> +
> + if (ret < 0) {
> + free(result.ptr);
> + return error(_("Failed to execute internal merge"));
> + }
> +
> + if (ret > 0 || !orig_blob)
> + ret = error(_("content conflict in %s"), path);
> + if (our_mode != their_mode)
> + ret = error(_("permission conflict: %o->%o,%o in %s"),
> + orig_mode, our_mode, their_mode, path);
> +
> + unlink(path);
> + if ((dest = open(path, O_WRONLY | O_CREAT, our_mode)) < 0) {
> + free(result.ptr);
> + return error_errno(_("failed to open file '%s'"), path);
> + }
> +
> + written = write_in_full(dest, result.ptr, result.size);
> + close(dest);
> +
> + free(result.ptr);
> +
> + if (written < 0)
> + return error_errno(_("failed to write to '%s'"), path);
> + if (ret)
> + return ret;
> +
> + return add_file_to_index(istate, path, 0);
> +}
> +
> +int merge_three_way(struct index_state *istate,
> + const struct object_id *orig_blob,
> + const struct object_id *our_blob,
> + const struct object_id *their_blob, const char *path,
> + unsigned int orig_mode, unsigned int our_mode, unsigned int their_mode)
> +{
> + if (orig_blob &&
> + ((!our_blob && !their_blob) ||
> + (!their_blob && our_blob && oideq(orig_blob, our_blob)) ||
> + (!our_blob && their_blob && oideq(orig_blob, their_blob)))) {
> + /* Deleted in both or deleted in one and unchanged in the other. */
> + return merge_one_file_deleted(istate, our_blob, their_blob, path,
> + orig_mode, our_mode, their_mode);
> + } else if (!orig_blob && our_blob && !their_blob) {
> + /*
> + * Added in ours. The other side did not add and we
> + * added so there is nothing to be done, except making
> + * the path merged.
> + */
> + return add_merge_result_to_index(istate, our_mode, our_blob, path, 0);
> + } else if (!orig_blob && !our_blob && their_blob) {
> + printf(_("Adding %s\n"), path);
> +
> + if (file_exists(path))
> + return error(_("untracked %s is overwritten by the merge."), path);
> +
> + return add_merge_result_to_index(istate, their_mode, their_blob, path, 1);
> + } else if (!orig_blob && our_blob && their_blob &&
> + oideq(our_blob, their_blob)) {
> + /* Added in both, identically (check for same permissions). */
> + if (our_mode != their_mode)
> + return error(_("File %s added identically in both branches, "
> + "but permissions conflict %o->%o."),
> + path, our_mode, their_mode);
> +
> + printf(_("Adding %s\n"), path);
> +
> + return add_merge_result_to_index(istate, our_mode, our_blob, path, 1);
> + } else if (our_blob && their_blob) {
> + /* Modified in both, but differently. */
> + return do_merge_one_file(istate,
> + orig_blob, our_blob, their_blob, path,
> + orig_mode, our_mode, their_mode);
> + } else {
> + char orig_hex[GIT_MAX_HEXSZ] = {0}, our_hex[GIT_MAX_HEXSZ] = {0},
> + their_hex[GIT_MAX_HEXSZ] = {0};
> +
> + if (orig_blob)
> + oid_to_hex_r(orig_hex, orig_blob);
> + if (our_blob)
> + oid_to_hex_r(our_hex, our_blob);
> + if (their_blob)
> + oid_to_hex_r(their_hex, their_blob);
> +
> + return error(_("%s: Not handling case %s -> %s -> %s"),
> + path, orig_hex, our_hex, their_hex);
> + }
> +
> + return 0;
> +}
> +
> +int merge_one_file_func(struct index_state *istate,
> + const struct object_id *orig_blob,
> + const struct object_id *our_blob,
> + const struct object_id *their_blob, const char *path,
> + unsigned int orig_mode, unsigned int our_mode, unsigned int their_mode,
> + void *data)
> +{
> + return merge_three_way(istate,
> + orig_blob, our_blob, their_blob, path,
> + orig_mode, our_mode, their_mode);
> +}
>
> static int merge_entry(struct index_state *istate, int quiet, unsigned int pos,
> const char *path, int *err, merge_fn fn, void *data)
> @@ -54,17 +246,24 @@ int merge_all_index(struct index_state *istate, int oneshot, int quiet,
> merge_fn fn, void *data)
> {
> int err = 0, ret;
> - unsigned int i;
> + unsigned int i, prev_nr;
>
> for (i = 0; i < istate->cache_nr; i++) {
> const struct cache_entry *ce = istate->cache[i];
> if (!ce_stage(ce))
> continue;
>
> + prev_nr = istate->cache_nr;
> ret = merge_entry(istate, quiet || oneshot, i, ce->name, &err, fn, data);
> - if (ret > 0)
> - i += ret - 1;
> - else if (ret == -1)
> + if (ret > 0) {
> + /*
> + * Don't bother handling an index that has
> + * grown, since merge_one_file_func() can't grow
> + * it, and merge_one_file_spawn() can't change
> + * it.
> + */
> + i += ret - (prev_nr - istate->cache_nr) - 1;
> + } else if (ret == -1)
> return -1;
>
> if (err && !oneshot)
> diff --git a/merge-strategies.h b/merge-strategies.h
> index 88f476f170..8705a550ca 100644
> --- a/merge-strategies.h
> +++ b/merge-strategies.h
> @@ -3,6 +3,12 @@
>
> #include "object.h"
>
> +int merge_three_way(struct index_state *istate,
> + const struct object_id *orig_blob,
> + const struct object_id *our_blob,
> + const struct object_id *their_blob, const char *path,
> + unsigned int orig_mode, unsigned int our_mode, unsigned int their_mode);
> +
> typedef int (*merge_fn)(struct index_state *istate,
> const struct object_id *orig_blob,
> const struct object_id *our_blob,
> @@ -10,6 +16,13 @@ typedef int (*merge_fn)(struct index_state *istate,
> unsigned int orig_mode, unsigned int our_mode, unsigned int their_mode,
> void *data);
>
> +int merge_one_file_func(struct index_state *istate,
> + const struct object_id *orig_blob,
> + const struct object_id *our_blob,
> + const struct object_id *their_blob, const char *path,
> + unsigned int orig_mode, unsigned int our_mode, unsigned int their_mode,
> + void *data);
> +
> int merge_index_path(struct index_state *istate, int oneshot, int quiet,
> const char *path, merge_fn fn, void *data);
> int merge_all_index(struct index_state *istate, int oneshot, int quiet,
> diff --git a/t/t6060-merge-index.sh b/t/t6060-merge-index.sh
> index d0cdfeddc1..d9c07965dc 100755
> --- a/t/t6060-merge-index.sh
> +++ b/t/t6060-merge-index.sh
> @@ -72,7 +72,7 @@ test_expect_success 'merge-one-file fails without a work tree' '
> (cd bare.git &&
> GIT_INDEX_FILE=$PWD/merge.index &&
> export GIT_INDEX_FILE &&
> - test_must_fail git merge-index git-merge-one-file -a
> + test_must_fail git merge-index --use=merge-one-file -a
> )
> '
>
> diff --git a/t/t6415-merge-dir-to-symlink.sh b/t/t6415-merge-dir-to-symlink.sh
> index 2ce104aca7..075da1f55f 100755
> --- a/t/t6415-merge-dir-to-symlink.sh
> +++ b/t/t6415-merge-dir-to-symlink.sh
> @@ -97,7 +97,7 @@ test_expect_success SYMLINKS 'a/b was resolved as symlink' '
> test -h a/b
> '
>
> -test_expect_failure 'do not lose untracked in merge (resolve)' '
> +test_expect_success 'do not lose untracked in merge (resolve)' '
> git reset --hard &&
> git checkout baseline^0 &&
> >a/b/c/e &&
> --
> 2.31.0
>
>
next prev parent reply other threads:[~2021-03-22 22:21 UTC|newest]
Thread overview: 221+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-06-25 12:19 [RFC PATCH v1 00/17] Rewrite the remaining merge strategies from shell to C Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 01/17] t6027: modernise tests Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 02/17] merge-one-file: rewrite in C Alban Gruin
2020-06-25 14:55 ` Chris Torek
2020-06-25 15:16 ` Phillip Wood
2020-06-25 18:17 ` Phillip Wood
2020-06-26 14:33 ` Phillip Wood
2020-07-12 11:22 ` Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 03/17] merge-one-file: remove calls to external processes Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 04/17] merge-one-file: use error() instead of fprintf(stderr, ...) Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 05/17] merge-one-file: libify merge_one_file() Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 06/17] merge-index: libify merge_one_path() and merge_all() Alban Gruin
2020-06-26 10:13 ` Phillip Wood
2020-06-26 14:32 ` Phillip Wood
2020-07-12 11:36 ` Alban Gruin
2020-07-12 18:02 ` Phillip Wood
2020-07-12 20:10 ` Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 07/17] merge-resolve: rewrite in C Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 08/17] merge-resolve: remove calls to external processes Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 09/17] merge-resolve: libify merge_resolve() Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 10/17] merge-recursive: move better_branch_name() to merge.c Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 11/17] merge-octopus: rewrite in C Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 12/17] merge-octopus: remove calls to external processes Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 13/17] merge-octopus: libify merge_octopus() Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 14/17] merge: use the "resolve" strategy without forking Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 15/17] merge: use the "octopus" " Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 16/17] sequencer: use the "resolve" " Alban Gruin
2020-06-25 16:11 ` Phillip Wood
2020-07-12 11:27 ` Alban Gruin
2020-06-25 12:19 ` [RFC PATCH v1 17/17] sequencer: use the "octopus" merge " Alban Gruin
2020-09-01 10:56 ` [PATCH v2 00/11] Rewrite the remaining merge strategies from shell to C Alban Gruin
2020-09-01 10:56 ` [PATCH v2 01/11] t6027: modernise tests Alban Gruin
2020-09-01 10:56 ` [PATCH v2 02/11] merge-one-file: rewrite in C Alban Gruin
2020-09-01 21:06 ` Junio C Hamano
2020-09-02 14:50 ` Alban Gruin
2020-09-01 10:56 ` [PATCH v2 03/11] merge-index: libify merge_one_path() and merge_all() Alban Gruin
2020-09-01 21:11 ` Junio C Hamano
2020-09-02 15:37 ` Alban Gruin
2020-09-01 10:56 ` [PATCH v2 04/11] merge-index: don't fork if the requested program is `git-merge-one-file' Alban Gruin
2020-09-01 10:56 ` [PATCH v2 05/11] merge-resolve: rewrite in C Alban Gruin
2020-09-01 10:57 ` [PATCH v2 06/11] merge-recursive: move better_branch_name() to merge.c Alban Gruin
2020-09-01 10:57 ` [PATCH v2 07/11] merge-octopus: rewrite in C Alban Gruin
2020-09-01 10:57 ` [PATCH v2 08/11] merge: use the "resolve" strategy without forking Alban Gruin
2020-09-01 10:57 ` [PATCH v2 09/11] merge: use the "octopus" " Alban Gruin
2020-09-01 10:57 ` [PATCH v2 10/11] sequencer: use the "resolve" " Alban Gruin
2020-09-01 10:57 ` [PATCH v2 11/11] sequencer: use the "octopus" merge " Alban Gruin
2020-10-05 12:26 ` [PATCH v3 00/11] Rewrite the remaining merge strategies from shell to C Alban Gruin
2020-10-05 12:26 ` [PATCH v3 01/11] t6027: modernise tests Alban Gruin
2020-10-06 20:50 ` Junio C Hamano
2020-10-05 12:26 ` [PATCH v3 02/11] merge-one-file: rewrite in C Alban Gruin
2020-10-06 22:01 ` Junio C Hamano
2020-10-21 19:47 ` Alban Gruin
2020-10-21 20:28 ` Junio C Hamano
2020-10-21 21:20 ` Junio C Hamano
2020-10-21 20:30 ` Junio C Hamano
2020-10-05 12:26 ` [PATCH v3 03/11] merge-index: libify merge_one_path() and merge_all() Alban Gruin
2020-10-09 4:48 ` Junio C Hamano
2020-11-06 19:53 ` Alban Gruin
2020-10-05 12:26 ` [PATCH v3 04/11] merge-index: don't fork if the requested program is `git-merge-one-file' Alban Gruin
2020-10-16 19:07 ` Junio C Hamano
2020-10-05 12:26 ` [PATCH v3 05/11] merge-resolve: rewrite in C Alban Gruin
2020-10-16 19:19 ` Junio C Hamano
2020-11-06 19:53 ` Alban Gruin
2020-10-05 12:26 ` [PATCH v3 06/11] merge-recursive: move better_branch_name() to merge.c Alban Gruin
2020-10-05 12:26 ` [PATCH v3 07/11] merge-octopus: rewrite in C Alban Gruin
2020-10-05 12:26 ` [PATCH v3 08/11] merge: use the "resolve" strategy without forking Alban Gruin
2020-10-05 12:26 ` [PATCH v3 09/11] merge: use the "octopus" " Alban Gruin
2020-10-05 12:26 ` [PATCH v3 10/11] sequencer: use the "resolve" " Alban Gruin
2020-10-05 12:26 ` [PATCH v3 11/11] sequencer: use the "octopus" merge " Alban Gruin
2020-10-07 6:57 ` [PATCH v3 00/11] Rewrite the remaining merge strategies from shell to C Johannes Schindelin
2020-11-13 11:04 ` [PATCH v4 00/12] " Alban Gruin
2020-11-13 11:04 ` [PATCH v4 01/12] t6027: modernise tests Alban Gruin
2020-11-13 11:04 ` [PATCH v4 02/12] update-index: move add_cacheinfo() to read-cache.c Alban Gruin
2020-11-13 11:04 ` [PATCH v4 03/12] merge-one-file: rewrite in C Alban Gruin
2020-11-13 11:04 ` [PATCH v4 04/12] merge-index: libify merge_one_path() and merge_all() Alban Gruin
2020-11-13 11:04 ` [PATCH v4 05/12] merge-index: don't fork if the requested program is `git-merge-one-file' Alban Gruin
2020-11-13 11:04 ` [PATCH v4 06/12] merge-resolve: rewrite in C Alban Gruin
2020-11-13 11:04 ` [PATCH v4 07/12] merge-recursive: move better_branch_name() to merge.c Alban Gruin
2020-11-13 11:04 ` [PATCH v4 08/12] merge-octopus: rewrite in C Alban Gruin
2020-11-13 11:04 ` [PATCH v4 09/12] merge: use the "resolve" strategy without forking Alban Gruin
2020-11-13 11:04 ` [PATCH v4 10/12] merge: use the "octopus" " Alban Gruin
2020-11-13 11:04 ` [PATCH v4 11/12] sequencer: use the "resolve" " Alban Gruin
2020-11-13 11:04 ` [PATCH v4 12/12] sequencer: use the "octopus" merge " Alban Gruin
2020-11-16 10:21 ` [PATCH v5 00/12] Rewrite the remaining merge strategies from shell to C Alban Gruin
2020-11-16 10:21 ` [PATCH v5 01/12] t6027: modernise tests Alban Gruin
2020-11-16 10:21 ` [PATCH v5 02/12] update-index: move add_cacheinfo() to read-cache.c Alban Gruin
2020-11-16 10:21 ` [PATCH v5 03/12] merge-one-file: rewrite in C Alban Gruin
2020-11-16 10:21 ` [PATCH v5 04/12] merge-index: libify merge_one_path() and merge_all() Alban Gruin
2020-11-16 10:21 ` [PATCH v5 05/12] merge-index: don't fork if the requested program is `git-merge-one-file' Alban Gruin
2020-11-16 10:21 ` [PATCH v5 06/12] merge-resolve: rewrite in C Alban Gruin
2020-11-16 10:21 ` [PATCH v5 07/12] merge-recursive: move better_branch_name() to merge.c Alban Gruin
2020-11-16 10:21 ` [PATCH v5 08/12] merge-octopus: rewrite in C Alban Gruin
2020-11-16 10:21 ` [PATCH v5 09/12] merge: use the "resolve" strategy without forking Alban Gruin
2020-11-16 10:21 ` [PATCH v5 10/12] merge: use the "octopus" " Alban Gruin
2020-11-16 10:21 ` [PATCH v5 11/12] sequencer: use the "resolve" " Alban Gruin
2020-11-16 10:21 ` [PATCH v5 12/12] sequencer: use the "octopus" merge " Alban Gruin
2020-11-24 11:53 ` [PATCH v6 00/13] Rewrite the remaining merge strategies from shell to C Alban Gruin
2020-11-24 11:53 ` [PATCH v6 01/13] t6407: modernise tests Alban Gruin
2020-11-24 11:53 ` [PATCH v6 02/13] t6060: modify multiple files to expose a possible issue with merge-index Alban Gruin
2020-11-24 11:53 ` [PATCH v6 03/13] update-index: move add_cacheinfo() to read-cache.c Alban Gruin
2020-12-22 20:54 ` Junio C Hamano
2020-11-24 11:53 ` [PATCH v6 04/13] merge-one-file: rewrite in C Alban Gruin
2020-12-22 21:36 ` Junio C Hamano
2021-01-03 22:41 ` Alban Gruin
2021-01-08 6:54 ` Junio C Hamano
2020-11-24 11:53 ` [PATCH v6 05/13] merge-index: libify merge_one_path() and merge_all() Alban Gruin
2021-01-05 15:59 ` Derrick Stolee
2021-01-05 23:20 ` Alban Gruin
2020-11-24 11:53 ` [PATCH v6 06/13] merge-index: don't fork if the requested program is `git-merge-one-file' Alban Gruin
2021-01-05 16:11 ` Derrick Stolee
2021-01-05 17:35 ` Martin Ågren
2021-01-05 23:20 ` Alban Gruin
2021-01-05 23:20 ` Alban Gruin
2021-01-06 2:04 ` Junio C Hamano
2021-01-10 17:15 ` Alban Gruin
2021-01-10 20:51 ` Junio C Hamano
2021-03-08 20:32 ` Alban Gruin
2020-11-24 11:53 ` [PATCH v6 07/13] merge-resolve: rewrite in C Alban Gruin
2020-11-24 11:53 ` [PATCH v6 08/13] merge-recursive: move better_branch_name() to merge.c Alban Gruin
2021-01-05 16:19 ` Derrick Stolee
2020-11-24 11:53 ` [PATCH v6 09/13] merge-octopus: rewrite in C Alban Gruin
2021-01-05 16:40 ` Derrick Stolee
2020-11-24 11:53 ` [PATCH v6 10/13] merge: use the "resolve" strategy without forking Alban Gruin
2021-01-05 16:45 ` Derrick Stolee
2020-11-24 11:53 ` [PATCH v6 11/13] merge: use the "octopus" " Alban Gruin
2020-11-24 11:53 ` [PATCH v6 12/13] sequencer: use the "resolve" " Alban Gruin
2020-11-24 11:53 ` [PATCH v6 13/13] sequencer: use the "octopus" merge " Alban Gruin
2020-11-24 19:34 ` [PATCH v6 00/13] Rewrite the remaining merge strategies from shell to C SZEDER Gábor
2021-01-05 16:50 ` Derrick Stolee
2021-03-17 20:49 ` [PATCH v7 00/15] " Alban Gruin
2021-03-17 20:49 ` [PATCH v7 01/15] t6407: modernise tests Alban Gruin
2021-03-17 20:49 ` [PATCH v7 02/15] t6060: modify multiple files to expose a possible issue with merge-index Alban Gruin
2021-03-17 20:49 ` [PATCH v7 03/15] t6060: add tests for removed files Alban Gruin
2021-03-22 21:36 ` Johannes Schindelin
2021-03-23 20:43 ` Alban Gruin
2021-03-17 20:49 ` [PATCH v7 04/15] merge-index: libify merge_one_path() and merge_all() Alban Gruin
2021-03-17 20:49 ` [PATCH v7 05/15] merge-index: drop the index Alban Gruin
2021-03-17 20:49 ` [PATCH v7 06/15] merge-index: add a new way to invoke `git-merge-one-file' Alban Gruin
2021-03-17 20:49 ` [PATCH v7 07/15] update-index: move add_cacheinfo() to read-cache.c Alban Gruin
2021-03-22 21:59 ` Johannes Schindelin
2021-03-23 20:45 ` Alban Gruin
2021-03-17 20:49 ` [PATCH v7 08/15] merge-one-file: rewrite in C Alban Gruin
2021-03-22 22:20 ` Johannes Schindelin [this message]
2021-03-23 20:53 ` Alban Gruin
2021-03-24 9:10 ` Johannes Schindelin
2021-04-10 14:17 ` Alban Gruin
2021-03-17 20:49 ` [PATCH v7 09/15] merge-resolve: " Alban Gruin
2021-03-23 22:21 ` Johannes Schindelin
2021-04-10 14:17 ` Alban Gruin
2021-03-17 20:49 ` [PATCH v7 10/15] merge-recursive: move better_branch_name() to merge.c Alban Gruin
2021-03-17 20:49 ` [PATCH v7 11/15] merge-octopus: rewrite in C Alban Gruin
2021-03-23 23:58 ` Johannes Schindelin
2021-03-17 20:49 ` [PATCH v7 12/15] merge: use the "resolve" strategy without forking Alban Gruin
2021-03-17 20:49 ` [PATCH v7 13/15] merge: use the "octopus" " Alban Gruin
2021-03-17 20:49 ` [PATCH v7 14/15] sequencer: use the "resolve" " Alban Gruin
2021-03-17 20:49 ` [PATCH v7 15/15] sequencer: use the "octopus" merge " Alban Gruin
2022-08-09 18:54 ` [PATCH v8 00/14] Rewrite the remaining merge strategies from shell to C Alban Gruin
2022-08-09 18:54 ` [PATCH v8 01/14] t6060: modify multiple files to expose a possible issue with merge-index Alban Gruin
2022-08-09 18:54 ` [PATCH v8 02/14] t6060: add tests for removed files Alban Gruin
2022-08-09 18:54 ` [PATCH v8 03/14] merge-index: libify merge_one_path() and merge_all() Alban Gruin
2022-08-17 2:10 ` Ævar Arnfjörð Bjarmason
2022-08-09 18:54 ` [PATCH v8 04/14] merge-index: drop the index Alban Gruin
2022-08-09 18:54 ` [PATCH v8 05/14] merge-index: add a new way to invoke `git-merge-one-file' Alban Gruin
2022-08-09 21:36 ` Johannes Schindelin
2022-08-10 13:14 ` Phillip Wood
2022-08-09 18:54 ` [PATCH v8 06/14] update-index: move add_cacheinfo() to read-cache.c Alban Gruin
2022-08-09 18:54 ` [PATCH v8 07/14] merge-one-file: rewrite in C Alban Gruin
2022-08-09 22:01 ` Johannes Schindelin
2022-08-09 18:54 ` [PATCH v8 08/14] merge-resolve: " Alban Gruin
2022-08-10 15:03 ` Phillip Wood
2022-08-10 21:20 ` Junio C Hamano
2022-08-16 12:09 ` Johannes Schindelin
2022-08-16 19:36 ` Junio C Hamano
2022-08-17 9:42 ` Johannes Schindelin
2022-08-17 19:06 ` Elijah Newren
2022-08-17 19:18 ` Junio C Hamano
2022-08-18 14:24 ` Ævar Arnfjörð Bjarmason
2022-08-18 17:32 ` Junio C Hamano
2022-08-19 1:43 ` Elijah Newren
2022-08-19 2:45 ` Ævar Arnfjörð Bjarmason
2022-08-19 4:27 ` Elijah Newren
2022-08-17 19:12 ` Junio C Hamano
2022-08-16 12:17 ` Johannes Schindelin
2022-08-16 14:02 ` Phillip Wood
2022-08-17 2:16 ` Ævar Arnfjörð Bjarmason
2022-08-18 14:43 ` Ævar Arnfjörð Bjarmason
2022-08-09 18:54 ` [PATCH v8 09/14] merge-recursive: move better_branch_name() to merge.c Alban Gruin
2022-08-09 18:54 ` [PATCH v8 10/14] merge-octopus: rewrite in C Alban Gruin
2022-08-09 18:54 ` [PATCH v8 11/14] merge: use the "resolve" strategy without forking Alban Gruin
2022-08-13 16:18 ` Junio C Hamano
2022-08-09 18:54 ` [PATCH v8 12/14] merge: use the "octopus" " Alban Gruin
2022-08-09 18:54 ` [PATCH v8 13/14] sequencer: use the "resolve" " Alban Gruin
2022-08-09 18:54 ` [PATCH v8 14/14] sequencer: use the "octopus" " Alban Gruin
2022-11-18 11:18 ` [PATCH v9 00/12] merge-index: prepare to rewrite merge drivers in C Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 01/12] merge-index doc & -h: fix padding, labels and "()" use Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 02/12] t6060: modify multiple files to expose a possible issue with merge-index Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 03/12] t6060: add tests for removed files Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 04/12] merge-index tests: add usage tests Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 05/12] merge-index: migrate to parse_options() API Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 06/12] merge-index: improve die() error messages Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 07/12] merge-index i18n: mark die() messages for translation Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 08/12] merge-index: stop calling ensure_full_index() twice Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 09/12] builtin/merge-index.c: don't USE_THE_INDEX_COMPATIBILITY_MACROS Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 10/12] merge-index: libify merge_one_path() and merge_all() Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 11/12] merge-index: use "struct strvec" and helper to prepare args Ævar Arnfjörð Bjarmason
2022-11-18 11:18 ` [PATCH v9 12/12] merge-index: make the argument parsing sensible & simpler Ævar Arnfjörð Bjarmason
2022-11-18 23:30 ` [PATCH v9 00/12] merge-index: prepare to rewrite merge drivers in C Taylor Blau
2022-11-19 12:46 ` Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 " Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 01/12] merge-index doc & -h: fix padding, labels and "()" use Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 02/12] t6060: modify multiple files to expose a possible issue with merge-index Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 03/12] t6060: add tests for removed files Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 04/12] merge-index tests: add usage tests Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 05/12] merge-index: migrate to parse_options() API Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 06/12] merge-index: improve die() error messages Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 07/12] merge-index i18n: mark die() messages for translation Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 08/12] merge-index: stop calling ensure_full_index() twice Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 09/12] builtin/merge-index.c: don't USE_THE_INDEX_VARIABLE Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 10/12] merge-index: libify merge_one_path() and merge_all() Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 11/12] merge-index: use "struct strvec" and helper to prepare args Ævar Arnfjörð Bjarmason
2022-12-15 8:52 ` [PATCH v10 12/12] merge-index: make the argument parsing sensible & simpler Ævar Arnfjörð Bjarmason
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=nycvar.QRO.7.76.6.2103222303210.50@tvgsbejvaqbjf.bet \
--to=johannes.schindelin@gmx.de \
--cc=alban.gruin@gmail.com \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=phillip.wood123@gmail.com \
--cc=stolee@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).