[PATCH STABLE] help: add example of '[templates]' usage

Mathias De Maré mathias.demare at gmail.com
Mon Aug 8 14:53:05 UTC 2016


# HG changeset patch
# User Mathias De Maré <mathias.demare at gmail.com>
# Date 1470667662 -7200
#      Mon Aug 08 16:47:42 2016 +0200
# Branch stable
# Node ID bbcf7bff5bac8b56b61942a50a562f0d45448297
# Parent  b8f9cdca88077e97d4869320b9d18481fbe252ef
help: add example of '[templates]' usage

diff --git a/mercurial/help/templates.txt b/mercurial/help/templates.txt
--- a/mercurial/help/templates.txt
+++ b/mercurial/help/templates.txt
@@ -71,6 +71,21 @@
 defines two symbol aliases, ``r`` and ``rn``, and a function alias
 ``leftpad()``.
 
+It's also possible to specify entirely new template commands,
+using the ``templates`` section.
+The syntax is the same as with ``templatealias``.
+
+For example,
+
+::
+
+  [templates]
+  short = "{shortest(node, 8)}"
+
+defines a template, ``short``, which can be called like::
+
+  $ hg log -r . -Tshort
+
 Some sample command line templates:
 
 - Format lists, e.g. files::


More information about the Mercurial-devel mailing list