Skip to content

breaking-changes: deprecate support for core.commentChar=auto

Phillip Wood git 4 versions – New

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v4 Latest3 patches 0 repliesNew
  2. v33 patches 3 repliesSuperseded
  3. v23 patches 13 repliesSuperseded
Earlier versions · 1
VersionPostedPatchesRepliesStatus
v12 patches14 repliesSuperseded

Changes in v4 from the cover letter

- Patch 2: Remove repeated word from commit message

Patches in v4 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/3breaking-changes: deprecate support for core.commentString=autoDocumentation/BreakingChanges.adoc Documentation/config/core.adoc builtin/commit.c +5 more+41 -80 replies
2/3config: warn on core.commentString=autobuiltin/commit.c builtin/merge.c builtin/rebase.c +8 more+157 -40 replies
3/3commit: print advice when core.commentString=autoconfig.c t/t3404-rebase-interactive.sh t/t7502-commit-porcelain.sh+234 -110 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v4 yet.

Read the v4 thread

Cover letter [PATCH v4 0/3] breaking-changes: deprecate support for core.commentChar=auto

From: Phillip Wood <[email protected]>

This series implements the plan to deprecate and remove support for core.commentChar=auto outlined in [1]. This feature has been the source of a couple of bug reports recently [2,3] and it is hard to see how the design can be fixed as it is incompatible with preparing a commit message template containing comments. When git sees the deprecated config setting it will print advice based on the user's config setting to help the user either remove the setting or set a custom comment string. In the example below core.commentString is set multiple times in $XDG_CONFIG_HOME/git/config and core.commentChar is set in ~/.gitconfig and $XDG_CONFIG_HOME/git/config.

warning: Support for 'core.commentChar=auto' is deprecated and will be removed in Git 3.0 hint:
hint: To use the default comment string (#) please run
hint:

hint:     git config unset --file ~/.config/git/config --all core.commentString
hint:     git config unset --file ~/.config/git/config core.commentChar
hint:     git config unset --global core.commentChar

hint:
hint: To set a custom comment string please run hint:
hint: git config set --global core.commentChar <comment string>
hint:
hint: where '<comment string>' is the string you wish to use.

[1] https://lore.kernel.org/git/[email protected]
[2] https://lore.kernel.org/git/[email protected]
[3] https://lore.kernel.org/git/[email protected]

Changes since V3:
- Patch 2: Remove repeated word from commit message

Changes since V2:
- Patch 1: Punctuation fixes
- Patch 2: Reworded the commit message slightly Remove unnecessary include of advice.h Fix variable declaration
- Patch 3: Include advice.h

Changes since V1:
- Rebased onto a merge of 'ps/config-wo-the-repository' and 'master'
- Reworded commit messages
- What was patch 2 has been split into two separate patches and reworked to die when core.commentChar=auto and WITH_BREAKING_CHANGES is enabled.

Base-Commit: 1ae5bd276bdf101e37c1a8f2904a2eae05fbb744
Published-As: https://github.com/phillipwood/git/releases/tag/pw%2Fremove-auto-comment-char%2Fv4
View-Changes-At: https://github.com/phillipwood/git/compare/1ae5bd276...39d824db4
Fetch-It-Via: git fetch https://github.com/phillipwood/git pw/remove-auto-comment-char/v4

Phillip Wood (3):
breaking-changes: deprecate support for core.commentString=auto
config: warn on core.commentString=auto
commit: print advice when core.commentString=auto

 Documentation/BreakingChanges.adoc |   5 +
 Documentation/config/core.adoc     |  20 +-
 builtin/commit.c                   |   7 +
 builtin/merge.c                    |   3 +
 builtin/rebase.c                   |   3 +
 builtin/revert.c                   |   7 +
 config.c                           | 297 ++++++++++++++++++++++++++++-
 environment.c                      |  11 +-
 environment.h                      |   3 +
 repository.c                       |   1 +
 repository.h                       |   3 +
 t/t3404-rebase-interactive.sh      |  19 +-
 t/t3418-rebase-continue.sh         |   2 +-
 t/t7502-commit-porcelain.sh        |  52 ++++-
 14 files changed, 421 insertions(+), 12 deletions(-)

Range-diff against v3:

1:  5b921064f1e = 1:  5b921064f1e breaking-changes: deprecate support for core.commentString=auto
2:  5dd897c95e6 ! 2:  e92511ce21c config: warn on core.commentString=auto

@@ Commit message

As support for this setting was deprecated in the last commit print a warning (or die when WITH_BREAKING_CHANGES is enabled) if it is set.
- Avoid bombarding the user with warnings by only printing it (a) when
- running commands commands that call "git commit" and (b) only once
- per command. Some scaffolding is added to repo_read_config() to allow
+ Avoid bombarding the user with warnings by only printing it (a)
+ when running commands that call "git commit" and (b) only once per
+ command. Some scaffolding is added to repo_read_config() to allow
it to detect deprecated config settings and warn about them. As both "core.commentChar" and "core.commentString" set the comment character we record which one of them is used and tailor the warning message
3: ee6cf11a82c = 3: 39d824db4ab commit: print advice when core.commentString=auto

Signature · 1 line
2.49.0.897.gfad3eb7d210