r7857 - in trunk/BOOK: . general/graphlib introduction/welcome

Randy McMurchy randy at linuxfromscratch.org
Wed Jul 22 14:56:08 PDT 2009


gdalziel at linuxfromscratch.org wrote these words on 07/22/09 15:46 CST:
> Author: gdalziel
> Date: 2009-07-22 14:46:33 -0600 (Wed, 22 Jul 2009)
> New Revision: 7857
> +    <bridgehead renderas="sect4">Recommended</bridgehead>
> +    <para role="recommended"><xref linkend="libjpeg"/>, <xref linkend="cairo"/>,
> +    <xref linkend="glib2"/>, <ulink url="http://www.openjpeg.org">OpenJPEG</ulink>
> +    </para>

You should add "and" before the last item in the list.


>      <para>If you're installing <application>Poppler</application> to support
> -    <xref linkend="kdegraphics"/>, you will need to have <xref linkend="qt"/>
> +    <xref linkend="kdegraphics"/>, then you will need to have <xref linkend="qt"/>
>      installed so that the <filename class='libraryfile'>libpoppler-qt</filename>
>      library is built.</para>

I remember writing that sentence. According to my training, in technical
writing if you can avoid using a conjunctive adverb, in this case "then",
you should avoid using it. This keeps the document from being deemed "wordy".

Notice in the sentence above, I could have added "then", right before "you
should avoid using it", as it would be used for the identical purpose. It
doesn't really matter, because either way it is technically correct, I just
tend to think in a technical document, less is better. :-)

-- 
Randy

rmlscsi: [bogomips 1003.25] [GNU ld version 2.16.1] [gcc (GCC) 4.0.3]
[GNU C Library stable release version 2.3.6] [Linux 2.6.14.3 i686]
16:49:01 up 16 days, 5:17, 1 user, load average: 0.00, 0.00, 0.06



More information about the blfs-book mailing list