Chapter 9 ideas
Brian W. Fitzpatrick
fitz at red-bean.com
Fri Apr 25 14:59:43 CDT 2008
OK. No probs. GIve me 10 days or so to get the copyedits done and
then let's take a look at it a few commands at a time to make sure
we're on the same page.
Thanks for the help!
On Fri, Apr 25, 2008 at 2:00 PM, Larry Shatzer, Jr. <larrys at gmail.com> wrote:
> (Sorry for the second copy Fitz, I thought I hit reply to all, and wanted
> this to go to the list as well).
> On Fri, Apr 25, 2008 at 12:48 PM, Brian W. Fitzpatrick <fitz at red-bean.com>
> > On Fri, Apr 25, 2008 at 12:57 PM, Larry Shatzer, Jr. <larrys at gmail.com>
> > > (Resending this as I got a bounce back...)
> > >
> > > I was looking over the reference in chapter 9 to make sure the sections
> > > list all the options for each of the subcommands was up to date, and
> > > it varied between command on order,
> > I mostly mirrored the ordering on the output of svn help, but I could
> > be convinced that alphabetical is better...
> I was going to have it mirror the output of svn help as well, I found a few
> in my first few that did not match, but that could be the output differed
> between 1.4 and 1.5.
> > > and some had all the "global" options,
> > > and some did not.
> > Can you give some examples? I will say that I specifically did not
> > list --username and --password for commands that do not use them (and
> > for the record, I still *strongly* disagree with the decision to just
> > have every command--even the ones that don't use them--accept these
> > options)
> Just a misunderstanding on my part. I was meaning some would have stuff like
> --username and --config-dir, etc. was listed in some of the subcommands, yet
> not others.
> > > was also hoping to somehow include the layout of the global options also
> > > including some documentation about each option in each subcommands
> > > Maybe to start off with the text from svn help SUBCOMMAND could be a
> > > start. It would be even better if it could be automated to grab the
> > > docstrings from the svn help output and drop them into the docbook
> > >
> > > So before I continue with this (if it is something that is needed),
> should I
> > > include all the output of svn help SUBCOMMAND in the <screen> sections
> > > start off with? I also had questions about adding --non-recursive in
> > > since the output says it is obsolete, and I doubt we want to document it
> > > the book.
> > Maybe I missed a previous email, but what are you planning to do here?
> > I'm about to start copyediting Chapter 9, and that's going to tear it
> > apart, so unless it's really impt, it should probably wait...
> There was no other email. I tried to send one, but got bounced back, so I
> resent it. I was just looking to improve this section by making sure all the
> subcommands were listed, etc. If you are about to start ripping this chapter
> apart and edit it, I'll leave it alone.
> -- Larry
> svnbook-dev mailing list
> svnbook-dev at red-bean.com
More information about the svnbook-dev