Re: Git documentation writing guidelines (was: Re: ghost refs)

[Jakub Narebski <jnareb@gmail.com>]

Junio C Hamano <gitster@pobox.com> writes:

> Jeff King <peff@peff.net> writes:

> > git-config (or perhaps even gitconfig(7)) should have a list of all
> > variables and where they are described, like:
> >
> >   apply.ignorewhitespace        git-apply(1)
> >   apply.whitespace              git-apply(1)
> >   branch.autosetupmerge         git-branch(1)
> >   [etc]
> >
> > There is not much point in having full descriptions in one giant list.
> > Instead, you can peruse the whole list, and then go to the configuration
> > section of the relevant manpage to see a bunch of related options. Such
> > a list should be pretty easy to generate automatically from the other
> > documentation.
> 
> Yes, I like it.

Well, there are some variables, like advice.*, or core.*, or alias.*, or
color.*, or browser.<tool>.path, or i18n.*, or interactive.singlekey,
or notes.*, or user.* that do not really belong to single git command
(well, perhaps they could be put in git(1) manpage), or belong to more
than one command.

-- 
Jakub Narebski
Poland
ShadeHawk on #git