Date: Thu, 18 Jul 2013 11:50:23 -0400 (EDT) From: Benjamin Kaduk <kaduk@MIT.EDU> To: Warren Block <wblock@freebsd.org> Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org Subject: Re: svn commit: r42309 - head/en_US.ISO8859-1/books/fdp-primer/structure Message-ID: <alpine.GSO.1.10.1307181148550.24720@multics.mit.edu> In-Reply-To: <201307180021.r6I0LcRM094168@svn.freebsd.org> References: <201307180021.r6I0LcRM094168@svn.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, 18 Jul 2013, Warren Block wrote: > Author: wblock > Date: Thu Jul 18 00:21:37 2013 > New Revision: 42309 > URL: http://svnweb.freebsd.org/changeset/doc/42309 > > Log: > Edit, update, and simplify the structure chapter. > > Reviewed by: bps and Allan Jude on IRC > > Modified: head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml Wed Jul 17 23:27:59 2013 (r42308) > +++ head/en_US.ISO8859-1/books/fdp-primer/structure/chapter.xml Thu Jul 18 00:21:37 2013 (r42309) > - > - <para>This is unfortunate as it makes it impossible to treat > - these as generic XML files and simply convert them to > - HTML, RTF, PS, and other formats in the same way the main > - Handbook is generated. This <emphasis>would</emphasis> > - force you to rebuild the Handbook every time you want to > - see the effect a change has had on just one > - chapter.</para> > + <para>The <filename>chapter.xml</filename> files are not > + complete <acronym>XML</acronym> documents. They cannot be > + individually rendered to output formats, but must be built > + as part of the Handbook.</para> I think "and" is slightly better than "but" as a conjunction, here. There is not really a contrast between the two clauses, they are saying similar/related things. -Ben > </sect4> > </sect3> > </sect2> >
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.GSO.1.10.1307181148550.24720>