[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