svn commit: r42309 - head/en_US.ISO8859-1/books/fdp-primer/structure

[Benjamin Kaduk]

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>
>