On Mon, Jul 9, 2018 at 6:29 PM Yuya Nishihara <y...@tcha.org> wrote:

> On Sun, 8 Jul 2018 18:29:37 +0530, Pulkit Goyal wrote:
> > > --- a/mercurial/help/config.txt
> > > +++ b/mercurial/help/config.txt
> > > @@ -702,6 +702,9 @@ for related options for the annotate com
> > >  ``unified``
> > >      Number of lines of context to show.
> > >
> > > +``word-diff``
> > > +    Highlight changed words.
> > > +
> > >
> >
> > ​TBH, I am not fan of documenting config options in `hg help config`.
> > Rather we should document this in commands' help text where it is
> > applicable so that this is more discoverable.​
>
> I agree that it's nice if each command help includes reference to related
> configs, but I think 'help config' should be the canonical source of all
> supported options. Otherwise we would have to grep all command helps to
> find a meaning of a certain config option.
>

​Can't we have the documentation at both places? I don't think that's
harmful.​
_______________________________________________
Mercurial-devel mailing list
Mercurial-devel@mercurial-scm.org
https://www.mercurial-scm.org/mailman/listinfo/mercurial-devel

Reply via email to