diff doc/hg.1.txt @ 1907:7718885070b1

let commands that show changesets use templates. mechanism is same as hgweb templates. old show_changeset code is still used for now if no template given, because it is faster than template code when verbose or debug. simple template can be given on command line using -t, --template. example: hg log -t '{author|person}\n' complex template can be put in template map file, given on command line using --map-file. we give two example map files: map-log.compact prints 3 lines of output for every change. map-log.verbose prints exact same output as default "hg log -v". map files are searched where user says, then in template path as backup. example: hg log --map-file map-log.compact defaults can be set in hgrc with ui.logtemplate and ui.logmap.
author Vadim Gelfer <vadim.gelfer@gmail.com>
date Mon, 27 Feb 2006 13:18:57 -0800
parents 47f4fbee32c5
children 74cf2b2f43d4
line wrap: on
line diff
--- a/doc/hg.1.txt
+++ b/doc/hg.1.txt
@@ -294,6 +294,12 @@ heads::
     changesets. They are where development generally takes place and
     are the usual targets for update and merge operations.
 
+    options:
+    -b, --branches         show branches
+    --map-file <file>      display using template map file
+    -r, --rev <rev>        show only heads which are descendants of rev
+    -t, --template <tpl>   display using template
+
 identify::
     Print a short summary of the current state of the repo.
 
@@ -331,7 +337,11 @@ incoming [-p] [source]::
     Currently only local repositories are supported.
 
     options:
+    -M, --no-merges       do not show merges
+    --map-file <file>     display using template map file
+    -n, --newest-first    show newest records first
     -p, --patch           show patch
+    -t, --template <tpl>  display using template
 
     aliases: in
 
@@ -379,10 +389,12 @@ log [-r revision ...] [-p] [files]::
     -b, --branch          show branches
     -k, --keyword <str>   search for keywords
     -l, --limit <num>     print no more than this many changes
+    --map-file <file>     display using template map file
     -M, --no-merges       do not show merges
     -m, --only-merges     only show merges
     -r, --rev <A>         show the specified revision or range
     -p, --patch           show patch
+    -t, --template <tpl>  display using template
 
     aliases: history
 
@@ -400,13 +412,22 @@ outgoing [-p] [dest]::
     See pull for valid source format details.
 
     options:
+    -M, --no-merges       do not show merges
+    --map-file <file>     display using template map file
     -p, --patch           show patch
+    -n, --newest-first    show newest records first
+    -t, --template <tpl>  display using template
 
     aliases: out
 
 parents::
     Print the working directory's parent revisions.
 
+    options:
+    -b, --branches        show branches
+    --map-file <file>     display using template map file
+    -t, --template <tpl>  display using template
+
 paths [NAME]::
     Show definition of symbolic path name NAME. If no name is given, show
     definition of available names.
@@ -613,7 +634,10 @@ tip [-p]::
     Show the tip revision.
 
     options:
-    -p, --patch      show patch
+    -b, --branches         show branches
+    --map-file <file>      display using template map file
+    -p, --patch            show patch
+    -t, --template <tpl>   display using template
 
 unbundle <file>::
     (EXPERIMENTAL)