[PATCH 2 of 2] Describe all files related to commands provided by standard extensions

[Matt Mackall]

On Tue, 2011-12-06 at 16:38 +0100, Olav Reinert wrote:
> # HG changeset patch
> # User Olav Reinert <seroton10 at gmail.com>
> # Date 1323185246 -3600
> # Branch stable
> # Node ID a9ad1209116ba556096f055e78d4d5e403829e03
> # Parent  ebf25ffdff96f8419dac57ffe64f55c1dcb3c24c
> Describe all files related to commands provided by standard extensions.

Not entirely convinced documenting all these here is appropriate?

> diff -r ebf25ffdff96 -r a9ad1209116b doc/hg.1.txt
> --- a/doc/hg.1.txt	Tue Dec 06 15:50:28 2011 +0100
> +++ b/doc/hg.1.txt	Tue Dec 06 16:27:26 2011 +0100
> @@ -89,6 +89,46 @@
>  if the ``.orig`` file already exists and is not tracked by Mercurial,
>  it will be overwritten.
>  
> +The following files and directories are used by the standard extensions:
> +
> +``.hgchurn``
> +    This file is used by the ``churn`` extension to define email address
> +    mappings. For details, see :hg:`help churn`.
> +
> +``.hgeol``
> +    This file is for configuring the ``eol`` extension to automatically
> +    manage newlines in repository files. For details, see :hg:`help eol`.
> +
> +``.hglf/``
> +    This directory is used by the ``largefiles`` extension to manage the
> +    standin file for each large binary file. For details, see
> +    :hg:`help largefiles`.
> +
> +``.hg/last-email.txt``
> +    This file is used by :hg:`email` command to store a backup of the patch
> +    series introductory message in case email sending fails. For details, see 
> +    :hg:`help patchbomb`.
> +
> +``.hg/patches/``
> +    This is the default directory used by the ``mq`` extension to manage
> +    the stack of patches. For details, see :hg:`help mq`.
> +
> +``.hg/shamap``
> +    This file is created by the ``convert`` command from the ``convert``
> +    extension. It is a simple text file that maps each source commit ID
> +    to the destination ID for that revision. For details, see
> +    :hg:`help convert`.
> +
> +``.hg/strip-backup/``
> +    This is the directory in which the ``strip`` command of the ``mq``
> +    extension stores backups of stripped changesets. For details, see
> +    :hg:`help strip`.
> +
> +``.hg/transplant``
> +    This directory is used by the ``transplant`` extension to store
> +    information about transplanted patches. For details, see
> +    :hg:`help transplant`.
> +
>  Bugs
>  ----
>  Probably lots, please post them to the mailing list (see Resources_
> _______________________________________________
> Mercurial-devel mailing list
> Mercurial-devel at selenic.com
> http://selenic.com/mailman/listinfo/mercurial-devel


-- 
Mathematics is the supreme nostalgia of our time.