[PATCH 2 of 2 V2] config: add docs for ignoring all text below in the editor
Sean Farley
sean at farley.io
Thu Jan 5 02:45:08 EST 2017
# HG changeset patch
# User Sean Farley <sean at farley.io>
# Date 1483590762 21600
# Wed Jan 04 22:32:42 2017 -0600
# Node ID db9f05a54af42bfb8d6c194b2a7d2e304c6faae6
# Parent 0ca4ce1550141b0372c916b9964c510788685e54
config: add docs for ignoring all text below in the editor
This is an example of how to use the new string "HG:
------------------------ >8 ------------------------" for ignoring
the diff in a commit message.
diff --git a/mercurial/help/config.txt b/mercurial/help/config.txt
--- a/mercurial/help/config.txt
+++ b/mercurial/help/config.txt
@@ -416,10 +416,30 @@ one shown by default::
"HG: added {file}\n" }{file_mods %
"HG: changed {file}\n" }{file_dels %
"HG: removed {file}\n" }{if(files, "",
"HG: no files changed\n")}
+``diff()``
+ String: show the diff (see :hg:`help templates` for detail)
+
+Sometimes it is helpful to show the diff of the changeset in the editor without
+having to prefix 'HG: ' to each line so that highlighting works correctly. For
+this, Mercurial provides the special string ``HG: ------------------------ >8
+------------------------`` which will ignore everything below it.
+
+For example, the template configuration below will show the diff below the
+extra message::
+
+ [committemplate]
+ changeset = {desc}\n\n
+ HG: Enter commit message. Lines beginning with 'HG:' are removed.
+ HG: {extramsg}
+ HG: ------------------------ >8 ------------------------
+ HG: Do not touch the line above.
+ HG: Everything below will be removed.
+ {diff()}
+
.. note::
For some problematic encodings (see :hg:`help win32mbcs` for
detail), this customization should be configured carefully, to
avoid showing broken characters.
More information about the Mercurial-devel
mailing list