[PATCH] diff: graduate word-diff option from experimental

Pulkit Goyal 7895pulkit at gmail.com
Wed Jul 11 13:38:37 EDT 2018


On Mon, Jul 9, 2018 at 6:29 PM Yuya Nishihara <yuya at 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.​
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.mercurial-scm.org/pipermail/mercurial-devel/attachments/20180711/70355036/attachment.html>


More information about the Mercurial-devel mailing list