Re: [PATCH] docs: stop using asciidoc no-inline-literal

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Thu, Apr 26, 2012 at 11:09:11AM +0200, Matthieu Moy wrote:

> Jeff King <peff@xxxxxxxx> writes:
> 
> > The patch is below. I'm slightly nervous because it means topics in
> > flight will need to have their documentation tweaked, too.
> 
> ... or, at worse, they will be broken for a while, and we can grep again
> the tip of pu after a few weeks to fix them.

Yes. Though having just done that grep, it is quite tedious.  You will
get many false positives in the existing documentation that do not need
changed (e.g., stash@{0}, or a literal backslash that is meant to be in
the output). So I think it will be simpler to just diff Documentation/
for the new topics and scan them manually (or grep the diff output).

> Plus, the possible breakage due to your patch are compensated by the
> existing breakage you fixed ;-). So, I'd say this is a valid concern,
> but the benefit seem clearly greater than the drawbacks.

Yeah, that was my conclusion, too.

-Peff
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]