# HG changeset patch # User Steve Losh # Date 1479642994 0 # Node ID 1fc4a9fbead7e0acc4c828b346f3be2658ec3df9 # Parent a6371635b645ab425b7f36a42ff34d9805df52f9 Restructured text is awful diff -r a6371635b645 -r 1fc4a9fbead7 README.markdown --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.markdown Sun Nov 20 11:56:34 2016 +0000 @@ -0,0 +1,69 @@ +Mercurial CLI Templates +======================= + +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][hgbook] 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. + +It also contains a verbose version that's great for reviewing single changesets: + + [alias] + show = log --style=/full/path/to/map-cmdline.nlog --verbose --patch --rev + +And now you can use `hg show tip` to show a nice summary of the tip revision. + +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`. + +[hgbook]: http://hgbook.red-bean.com/read/customizing-the-output-of-mercurial.html + diff -r a6371635b645 -r 1fc4a9fbead7 README.rst --- a/README.rst Sun Nov 20 11:52:40 2016 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,73 +0,0 @@ -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