changeset 30729:a4bc8fff67fc

help: apply the section headings from revsets to filesets This has the nice property of visually breaking up the wall of text. It also allows specific smaller sections to be called out. For example, `hg help filesets.predicates` now prints just the predicate section. At the moment, the revset headings are a superset of the fileset headings, so there is consistency in how example, predicate and operator help is called out. The reference to `hg help patterns` was moved to the overview section, so that it isn't stuck in the examples section.
author Matt Harbison <matt_harbison@yahoo.com>
date Sun, 08 Jan 2017 02:40:36 -0500
parents 7438cb35979a
children 107014f4848b
files mercurial/help/filesets.txt
diffstat 1 files changed, 14 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/mercurial/help/filesets.txt	Fri Jan 06 16:14:52 2017 +0000
+++ b/mercurial/help/filesets.txt	Sun Jan 08 02:40:36 2017 -0500
@@ -15,11 +15,19 @@
 e.g., ``\n`` is interpreted as a newline. To prevent them from being
 interpreted, strings can be prefixed with ``r``, e.g. ``r'...'``.
 
+See also :hg:`help patterns`.
+
+Prefix
+======
+
 There is a single prefix operator:
 
 ``not x``
   Files not in x. Short form is ``! x``.
 
+Infix
+=====
+
 These are the supported infix operators:
 
 ``x and y``
@@ -32,10 +40,16 @@
 ``x - y``
   Files in x but not in y.
 
+Predicates
+==========
+
 The following predicates are supported:
 
 .. predicatesmarker
 
+Examples
+========
+
 Some sample queries:
 
 - Show status of files that appear to be binary in the working directory::
@@ -61,5 +75,3 @@
 - Remove files listed in foo.lst that contain the letter a or b::
 
     hg remove "set: 'listfile:foo.lst' and (**a* or **b*)"
-
-See also :hg:`help patterns`.