Chapter 9 ideas
Larry Shatzer, Jr.
larrys at gmail.com
Fri Apr 25 12:57:03 CDT 2008
(Resending this as I got a bounce back...)
I was looking over the reference in chapter 9 to make sure the sections that
list all the options for each of the subcommands was up to date, and noticed
it varied between command on order, and some had all the "global" options,
and some did not. I was also confused as to the inclusion of some of the
options in the global section at the top, when they are not really that
global, some commands don't even list them, such as --targets for import. I
was also hoping to somehow include the layout of the global options also
including some documentation about each option in each subcommands section.
Maybe to start off with the text from svn help SUBCOMMAND could be a good
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 sections.
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 to
start off with? I also had questions about adding --non-recursive in there,
since the output says it is obsolete, and I doubt we want to document it in
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the svnbook-dev