I had to read the source to make sense of the feature, which is clearly not an acceptable state. Make the docu more specific and less misleading. Signed-off-by: Oswald Buddenhagen <oswald.buddenhagen@xxxxxx> --- Cc: Nguyễn Thái Ngọc Duy <pclouds@xxxxxxxxx> given the rather crippling limitations of this feature, does anyone actually use it? --- Documentation/config/core.adoc | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/Documentation/config/core.adoc b/Documentation/config/core.adoc index 8f6d8e7754..b470da72ba 100644 --- a/Documentation/config/core.adoc +++ b/Documentation/config/core.adoc @@ -526,8 +526,11 @@ core.commentString:: commented, and removes them after the editor returns (default '#'). + -If set to "auto", `git-commit` would select a character that is not -the beginning character of any line in existing commit messages. +If set to "auto", `git-commit` will select the first character +from the set "#;@!$%^&|:" that does not appear at the beginning +of any line in the prepared commit message prior to editing. +Note that this makes it impossible to include comments in the +prepare-commit-msg hook's output or the commit message template. + Note that these two variables are aliases of each other, and in modern versions of Git you are free to use a string (e.g., `//` or `⁑⁕⁑`) with -- 2.49.0.416.g2f302f2ef0.dirty
