From patchwork Mon Aug  8 14:53:05 2016
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Subject: [STABLE] help: add example of '[templates]' usage
From: =?utf-8?q?Mathias_De_Mar=C3=A9?= <mathias.demare@gmail.com>
X-Patchwork-Id: 16197
Message-Id: <bbcf7bff5bac8b56b619.1470667985@waste.org>
To: mercurial-devel@mercurial-scm.org
Date: Mon, 08 Aug 2016 09:53:05 -0500

# HG changeset patch
# User Mathias De Maré <mathias.demare@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::