hi dscho,
On 22/11/2020 23:23, Johannes Schindelin via GitGitGadget wrote:
> From: Johannes Schindelin <johannes.schindelin@xxxxxx>
>
> To give ample warning in case we decide to change the fall-back for an
> unconfigured `init.defaultBranch`, let's introduce some advice that is
> shown upon `git init` when that value is not set.
>
> Note: three test cases in Git's test suite want to verify that the
> `stderr` output of `git init` is empty. With this patch, that is only
> true if `init.defaultBranch` is configured, so let's do exactly that in
> those test cases. The same reasoning applies to `test_create_repo()`.
>
> Signed-off-by: Johannes Schindelin <johannes.schindelin@xxxxxx>
> ---
> refs.c | 13 ++++++++++++-
> t/t0001-init.sh | 9 ++++++++-
> t/t1510-repo-setup.sh | 2 +-
> t/t7414-submodule-mistakes.sh | 2 +-
> t/test-lib-functions.sh | 3 ++-
> 5 files changed, 24 insertions(+), 5 deletions(-)
>
> diff --git a/refs.c b/refs.c
> index 8df03122d6..61d712ca05 100644
> --- a/refs.c
> +++ b/refs.c
> @@ -562,6 +562,14 @@ void expand_ref_prefix(struct strvec *prefixes, const char *prefix)
> strvec_pushf(prefixes, *p, len, prefix);
> }
>
> +static const char default_branch_name_advice[] = N_(
> +"Using '%s' as the name for the initial branch. This name is subject\n"
> +"to change.
This sounds like Git will change the branch name within the user's repo,
rather than "The default" being subject to change. So maybe
s/This/The default/ ?
Philip
> To configure the name to use as the initial branch name in\n"
> +"new repositories, or to silence this warning, run:\n"
> +"\n"
> +"\tgit config --global init.defaultBranch <name>\n"
> +);
> +
> char *repo_default_branch_name(struct repository *r, int quiet)
> {
> const char *config_key = "init.defaultbranch";
> @@ -574,8 +582,11 @@ char *repo_default_branch_name(struct repository *r, int quiet)
> else if (repo_config_get_string(r, config_key, &ret) < 0)
> die(_("could not retrieve `%s`"), config_display_key);
>
> - if (!ret)
> + if (!ret) {
> ret = xstrdup("master");
> + if (!quiet)
> + advise(_(default_branch_name_advice), ret);
> + }
>
> full_ref = xstrfmt("refs/heads/%s", ret);
> if (check_refname_format(full_ref, 0))
> diff --git a/t/t0001-init.sh b/t/t0001-init.sh
> index 69a320489f..754dab3bab 100755
> --- a/t/t0001-init.sh
> +++ b/t/t0001-init.sh
> @@ -163,7 +163,7 @@ test_expect_success 'reinit' '
> (
> mkdir again &&
> cd again &&
> - git init >out1 2>err1 &&
> + git -c init.defaultBranch=initial init >out1 2>err1 &&
> git init >out2 2>err2
> ) &&
> test_i18ngrep "Initialized empty" again/out1 &&
> @@ -558,6 +558,13 @@ test_expect_success 'overridden default initial branch name (config)' '
> grep nmb actual
> '
>
> +test_expect_success 'advice on unconfigured init.defaultBranch' '
> + GIT_TEST_DEFAULT_INITIAL_BRANCH_NAME= git -c color.advice=always \
> + init unconfigured-default-branch-name 2>err &&
> + test_decode_color <err >decoded &&
> + test_i18ngrep "<YELLOW>hint: " decoded
> +'
> +
> test_expect_success 'overridden default main branch name (env)' '
> test_config_global init.defaultBranch nmb &&
> GIT_TEST_DEFAULT_INITIAL_BRANCH_NAME=env git init main-branch-env &&
> diff --git a/t/t1510-repo-setup.sh b/t/t1510-repo-setup.sh
> index 9974457f56..5189a520a2 100755
> --- a/t/t1510-repo-setup.sh
> +++ b/t/t1510-repo-setup.sh
> @@ -79,7 +79,7 @@ setup_repo () {
> name=$1 worktreecfg=$2 gitfile=$3 barecfg=$4 &&
> sane_unset GIT_DIR GIT_WORK_TREE &&
>
> - git init "$name" &&
> + git -c init.defaultBranch=repo init "$name" &&
> maybe_config "$name/.git/config" core.worktree "$worktreecfg" &&
> maybe_config "$name/.git/config" core.bare "$barecfg" &&
> mkdir -p "$name/sub/sub" &&
> diff --git a/t/t7414-submodule-mistakes.sh b/t/t7414-submodule-mistakes.sh
> index f2e7df59cf..0ed02938f9 100755
> --- a/t/t7414-submodule-mistakes.sh
> +++ b/t/t7414-submodule-mistakes.sh
> @@ -30,7 +30,7 @@ test_expect_success 'no warning when updating entry' '
>
> test_expect_success 'submodule add does not warn' '
> test_when_finished "git rm -rf submodule .gitmodules" &&
> - git submodule add ./embed submodule 2>stderr &&
> + git -c init.defaultBranch=x submodule add ./embed submodule 2>stderr &&
> test_i18ngrep ! warning stderr
> '
>
> diff --git a/t/test-lib-functions.sh b/t/test-lib-functions.sh
> index 59bbf75e83..772152320a 100644
> --- a/t/test-lib-functions.sh
> +++ b/t/test-lib-functions.sh
> @@ -1202,7 +1202,8 @@ test_create_repo () {
> mkdir -p "$repo"
> (
> cd "$repo" || error "Cannot setup test environment"
> - "${GIT_TEST_INSTALLED:-$GIT_EXEC_PATH}/git$X" init \
> + "${GIT_TEST_INSTALLED:-$GIT_EXEC_PATH}/git$X" \
> + -c init.defaultBranch=master init \
> "--template=$GIT_BUILD_DIR/templates/blt/" >&3 2>&4 ||
> error "cannot run git init -- have you built things yet?"
> mv .git/hooks .git/hooks-disabled
