git/Documentation/technical
Junio C Hamano eff80a9fd9 Allow custom "comment char"
Some users do want to write a line that begin with a pound sign, #,
in their commit log message.  Many tracking system recognise
a token of #<bugid> form, for example.

The support we offer these use cases is not very friendly to the end
users.  They have a choice between

 - Don't do it.  Avoid such a line by rewrapping or indenting; and

 - Use --cleanup=whitespace but remove all the hint lines we add.

Give them a way to set a custom comment char, e.g.

    $ git -c core.commentchar="%" commit

so that they do not have to do either of the two workarounds.

[jc: although I started the topic, all the tests and documentation
updates, many of the call sites of the new strbuf_add_commented_*()
functions, and the change to git-submodule.sh scripted Porcelain are
from Ralf.]

Signed-off-by: Junio C Hamano <gitster@pobox.com>
Signed-off-by: Ralf Thielow <ralf.thielow@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2013-01-16 12:48:22 -08:00
..
.gitignore
api-allocation-growing.txt
api-argv-array.txt Merge branch 'fa/remote-svn' 2012-10-25 06:42:02 -04:00
api-builtin.txt
api-config.txt docs: fix cross-directory linkgit references 2012-06-08 08:31:52 -07:00
api-credentials.txt add 'git credential' plumbing command 2012-06-25 11:55:51 -07:00
api-decorate.txt
api-diff.txt
api-directory-listing.txt
api-gitattributes.txt
api-grep.txt
api-hash.txt
api-history-graph.txt graph.c: infinite loop in git whatchanged --graph -m 2012-09-25 11:07:15 -07:00
api-in-core-index.txt
api-index-skel.txt Remove misleading date from api-index-skel.txt 2012-12-16 11:57:41 -08:00
api-index.sh
api-lockfile.txt
api-merge.txt docs: fix cross-directory linkgit references 2012-06-08 08:31:52 -07:00
api-object-access.txt
api-parse-options.txt docs: stop using asciidoc no-inline-literal 2012-04-26 13:19:06 -07:00
api-quote.txt
api-ref-iteration.txt
api-remote.txt
api-revision-walking.txt Teach revision walking machinery to walk multiple times sequencially 2012-03-30 08:57:49 -07:00
api-run-command.txt
api-setup.txt
api-sha1-array.txt sha1-array.c: mark a private file-scope symbol as static 2012-09-15 22:58:21 -07:00
api-sigchain.txt
api-strbuf.txt Allow custom "comment char" 2013-01-16 12:48:22 -08:00
api-string-list.txt Merge branch 'mh/ceiling' 2013-01-02 10:36:59 -08:00
api-tree-walking.txt
api-xdiff-interface.txt
index-format.txt Merge branch 'nd/index-format-doc' 2012-12-21 15:18:32 -08:00
pack-format.txt Documentation/technical: convert plain text files to asciidoc 2012-10-16 16:09:09 -07:00
pack-heuristics.txt
pack-protocol.txt Documentation/technical: convert plain text files to asciidoc 2012-10-16 16:09:09 -07:00
protocol-capabilities.txt
protocol-common.txt docs: stop using asciidoc no-inline-literal 2012-04-26 13:19:06 -07:00
racy-git.txt
send-pack-pipeline.txt Change headline of technical/send-pack-pipeline.txt to not confuse its content with content from git-send-pack.txt 2012-10-16 16:09:09 -07:00
shallow.txt Documentation/technical: convert plain text files to asciidoc 2012-10-16 16:09:09 -07:00
trivial-merge.txt Documentation/technical: convert plain text files to asciidoc 2012-10-16 16:09:09 -07:00