[svnbook commit] r3043 - trunk/src/en
Brian W. Fitzpatrick
fitz at red-bean.com
Fri May 2 09:34:51 CDT 2008
On Fri, May 2, 2008 at 9:32 AM, C. Michael Pilato <cmpilato at red-bean.com> wrote:
> fitz wrote:
> > Author: fitz
> > Date: Fri May 2 07:04:00 2008
> > New Revision: 3043
> > Log:
> > Update our style guide to reflect the wishes of the O'Reilly
> > copyeditors (and besides, it makes the markeup a *little* easier to
> > read.
> Whoa, whoa! We must have had different editors, because mine (correctly,
> in my opinion) marked up *every time* that I grouped the long and short
> options in one tag, complaining about the fact that the space between them
> got rendered in a fixed-width font.
> Actually, I'm looking at the copyedit pages now, and I see no indications
> from the editors that this was something you should have changed. Whoever
> edited chapter 2 seemed not to care about formatting of this sort (we have
> examples of both ways in the version O'Reilly edited).
> Sorry, Fitz, but unless there is a good reason for you to have made this
> change, I'm -1 on it and the tweak to HACKING. Plunking your "wow to write
> useful markup" hat on, it becomes clear that the option names are not "--foo
> (-f)", but "--foo" and "-f". Our markup should reflect that.
Maybe I'm misreading the proofreading marks? I keep seeing --foo (-f)
with each parenthesis circled and marked 'cw'. I assumed that this
meant to just glom the whole thing into fixed width, but maybe the
intent was to just glom the parens inside of the markeup?
-Fitz, clearly confused.
More information about the svnbook-dev