[PATCH] help: document about {extras} template keyword

[Henrik Stuart]

On 24-03-2010 13:46, Yuya Nishihara wrote:
> # HG changeset patch
> # User Yuya Nishihara <yuya at tcha.org>
> # Date 1269434740 -32400
> # Node ID 87b74683ea3e16445ca8bb88fac96f9a15007482
> # Parent  53313405b54d25f0f30ae64f9df3d33a239cb559
> help: document about {extras} template keyword
> 
> diff --git a/mercurial/help/templates.txt b/mercurial/help/templates.txt
> --- a/mercurial/help/templates.txt
> +++ b/mercurial/help/templates.txt
> @@ -34,6 +34,8 @@ keywords are usually available for templ
>  :diffstat: String. Statistics of changes with the following format:
>      "modified files: +added/-removed lines"
>  
> +:extras: List of items. The extra information of the changeset.
> +
>  :files: List of strings. All files modified, added, or removed by this
>      changeset.

While extras might be a bit secret as it is now, I think that the
documentation you propose maintains at least some of the secrecy.

Perhaps something like:

":extras: List of escaped colon-delimited strings. Extra metadata
concerning the changeset."

would be more appropriate/better?

Commence the bike-shedding.

-- 
Kind regards,
  Henrik Stuart