From: Jonathan Nieder <jrnieder@gmail.com>
Date: Wed, 12 May 2010 10:50:02 GMT
Subject: Re: [PATCH 6/8] Documentation/notes: simplify treatment of default display refs
Message-ID: <20100512105002.GB17740@progeny.tock>
In-Reply-To: <20100510060630.GC13340@coredump.intra.peff.net>

Jeff King wrote:

> Searching
> for "conflict" even in just a list of options should come up with
> "merge.conflictstyle", and I had always intended for such a gitconfig.5
> to have a full list.

Makes sense.  So the breakdown of that page might be

  Synopsis
  Description
    Syntax
  Configuration items
    Sections
    Index
  Core configuration
  Identity
  Suppressing advice
  Command aliases
  Colored output
  Paginated output
  Examples
  See also

with the index listing all configuration items, with a short phrase
describing each.

To keep this maintainable, I would like to have a single source file
with a short and long description for each configuration item.  Then
a script would process it into an index and snippets for the relevant
command pages.

I’m anxious to get started.  Thanks for the pointers.
Jonathan