# HG changeset patch # User Sean Farley <s...@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. _______________________________________________ Mercurial-devel mailing list Mercurial-devel@mercurial-scm.org https://www.mercurial-scm.org/mailman/listinfo/mercurial-devel