# HG changeset patch # User Steve Losh # Date 1479642760 0 # Node ID a6371635b645ab425b7f36a42ff34d9805df52f9 # Parent 168328ff4a519c9ab2a04e3679d4332c0d8562e6# Parent 66e2a34005b447d321a96838d7fe2b161e78b7a9 Merge. diff -r 168328ff4a51 -r a6371635b645 README.rst --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.rst Sun Nov 20 11:52:40 2016 +0000 @@ -0,0 +1,73 @@ +Mercurial CLI Templates +*********************** + +by `Steve Losh`_ + +Mercurial has a great command line interface and many people use it without +ever feeling the need for a GUI to manage their repositories. However, we can +make it even better by taking advantage of Mercurial’s templating features. + +This repository contains three new templates for Mercurial: + +- Short Log +- Nice Log +- Short Graphlog + +Check out ``hg help templating`` or the chapter on `customizing the output of +Mercurial`_ in the Mercurial book if you want more details on how the +templating actually works. + +Short Log +========= + +This command will print out a log of all the changesets in the repository, one +per line, with each line having the revision number, hash identifier, and +summary. + +To use this template you can edit your ``~/.hgrc`` file to contain the +following:: + + [alias] + slog = log --style=/full/path/to/map-cmdline.slog + +After adding the alias ``hg slog`` should display the short log. + +Nice Log +======== + +The short log is great a quick review of the past few changesets, but for a +much more detailed view of a particular changeset nice log is more suitable. + +To use this template you can edit your ``~/.hgrc`` file to contain the +following:: + + [alias] + nlog = log --style=/full/path/to/map-cmdline.nlog + +Now you should be able to display the nice log with the ``hg nlog`` command. + +Short Graphlog +============== + +The ``graphlog`` command is wonderful for reviewing the history of repositories +with branches, but we can make it more compact and easier to read with another +template. + +To use this template you can edit your ``~/.hgrc`` file to contain the +following:: + + [alias] + sglog = glog --style=/full/path/to/map-cmdline.sglog + +To show the short graphlog just type ``hg sglog``. + +.. _Steve Losh: http://stevelosh.com/ +.. _customizing the output of Mercurial: http://hgbook.red-bean.com/read/customizing-the-output-of-mercurial.html + +Changelog +========= + +* 2012-05-18: Add README +* 2012-02-04: Support phases +* 2011-09-28: Show desc in quiet slog +* 2011-03-09: Wrap bookmarks in [] and show them even in non-verbose mode