Re: [RFC/PATCH] Formatting variables in the documentation

On Mon, May 23, 2016 at 07:57:43PM +0200, Matthieu Moy wrote:

Samuel GROOT [off-list ref] writes:

quoted

Since 2.8.3 was out recently, we could flip MAN_BOLD_LITERAL on by
default for this cycle to shake out problems as Jeff King suggested
[2].

2.8.3 was a bufix release, and flipping a controversial flag should
clearly not be done on a bugfix release. So, in this context, "beginning
of a cycle" means after a x.y.0 release.

Anyway, a patch enabling MAN_BOLD_LITERAL by default would need to cook
in pu and next as any other patches, so the time when the patch is sent
does not really matter.

Yeah, I think a reasonable plan is:

  1. Somebody produces a patch flipping the default. The patch is
     trivial, but the commit message should tell why, and try to dig up
     any possible problems we might see (e.g., why wasn't this the
     default? Particular versions of tools? Some platforms?)

  2. Assuming no problems, Junio merges the patch to "next". We get
     any reports of issues from people using "next" day-to-day.

  3. Assuming no problems, Junio merges to "master". We hit more people
     (who build from master). And also it would be part of the
     pre-generated pages that Junio ships, so we might get reports
     there.

  4. Eventually it's released. We hope to get no problem reports there,
     though it _does_ hit a wider audience at that point.

Steps 1 and 2 can happen now. As we are in the -rc cycle right now,
probably step 3 would happen post-v2.9. But there's no reason not to
start the clock ticking now.

-Peff