On Mon, Oct 10, 2016 at 10:52:47PM +0200, René Scharfe wrote: > > I like the intent here, though I found "Values, color" hard to parse (it > > was not immediately clear that you mean "the color paragraph of the > > Values section", as commas are already being used in that sentence for > > the parenthetical phrase). > > > > I'm not sure how to say that succinctly, as we are four levels deep > > (git-config -> configuration file -> values -> color). Too bad there is > > no good link syntax for it. Maybe: > > > > ...color specification, as described in linkgit:git-config[1] (see the > > paragraph on colors in the "Values" section, under "CONFIGURATION > > FILE") > > > > or something. > > That's better. Or we could remove the "color" part and trust readers to > find the right paragraph in the Values sub-section? > > -- '%C(...)': color specification, as described in color.branch.* config option; > +- '%C(...)': color specification, as described under Values in the > + "CONFIGURATION FILE" section of linkgit:git-config[1]; Yeah, I think that is plenty of roadmap to give the user. -Peff