[svnbook commit] r2895 - trunk/src/en/book
Ben Collins-Sussman
sussman at red-bean.com
Tue Dec 4 09:11:36 CST 2007
Ah, must have been in an older version of the book....
On Dec 3, 2007 7:53 PM, Brian W. Fitzpatrick <fitz at red-bean.com> wrote:
> $ grep -i 'oh my' *xml
> ch02-basic-usage.xml: <title>Options and Switches and Flags, Oh
> My!</title>
>
> ??? I don't see the other instance...
>
> -Fitz
>
>
> On Dec 3, 2007 2:13 PM, Ben Collins-Sussman <sussman at red-bean.com> wrote:
> > Are we really going to have "oh my!" used twice in the book? :-)
> >
> >
> > On Dec 2, 2007 10:19 PM, fitz <noreply at red-bean.com> wrote:
> > > Author: fitz
> > > Date: Sun Dec 2 22:19:00 2007
> > > New Revision: 2895
> > >
> > > Log:
> > > Discuss our option notation and long vs short form options in a nice
> > > sidebar in Chapter 2.
> > >
> > > This fixes issue #53.
> > >
> > > * src/en/book/ch02-basic-usage.xml: Option is not a failure.
> > >
> > >
> > > Modified:
> > > trunk/src/en/book/ch02-basic-usage.xml
> > >
> > > Modified: trunk/src/en/book/ch02-basic-usage.xml
> > > ==============================================================================
> > > --- trunk/src/en/book/ch02-basic-usage.xml (original)
> > > +++ trunk/src/en/book/ch02-basic-usage.xml Sun Dec 2 22:19:00 2007
> > > @@ -49,6 +49,29 @@
> > > -N [--non-recursive] : operate on single directory only
> > > …
> > > </screen>
> > > +
> > > + <sidebar>
> > > + <title>Options and Switches and Flags, Oh My!</title>
> > > +
> > > + <para>The Subversion command line client has numerous command
> > > + modifiers (which we call options), but there are two
> > > + distinct kinds of options—<quote>short options</quote>
> > > + that are a single hyphen followed by a single letter, and
> > > + <quote>long options</quote> that consist of two hyphens
> > > + followed by a number of letters (eg <literal>-s</literal>
> > > + and <literal>--this-is-a-long-option</literal>
> > > + respectively). Every option has a long format, but only
> > > + certain options have an additional short format (these are
> > > + typically options that are frequently used). In order to
> > > + maintain clarity, we <emphasis>usually</emphasis> use the
> > > + long form in code examples, but when describing options, if
> > > + there's a short form, we'll provide the long form (to
> > > + improve clarity), and the short form (to make it easier to
> > > + remember). You should use whichever one you're more
> > > + comfortable with, but don't try to use both.</para>
> > > +
> > > + </sidebar>
> > > +
> > > </sect1>
> > >
> > > <!-- ================================================================= -->
> > >
> > > _______________________________________________
> > > svnbook-dev mailing list
> > > svnbook-dev at red-bean.com
> > > http://www.red-bean.com/mailman/listinfo/svnbook-dev
> > >
> >
> > _______________________________________________
> > svnbook-dev mailing list
> > svnbook-dev at red-bean.com
> > http://www.red-bean.com/mailman/listinfo/svnbook-dev
> >
> >
>
More information about the svnbook-dev
mailing list