r7885 - trunk/BOOK/general/genutils

Randy McMurchy randy at linuxfromscratch.org
Mon Jul 27 07:16:11 PDT 2009


randy at linuxfromscratch.org wrote these words on 07/27/09 09:06 CST:
> Author: randy
> Fixed some typos in the rarian package
> 
> -  <!ENTITY rarian-download-http "http://ftp.gnome.org/pub/gnome/sources/rarian/0.8/rarian-0.8.1.tar.bz2">
> -  <!ENTITY rarian-download-ftp  "ftp://ftp.gnome.org/pub/gnome/sources/rarian/0.8/rarian-0.8.1.tar.bz2">
> +  <!ENTITY rarian-download-http "&gnome-download-http;/rarian/0.8/rarian-0.8.1.tar.bz2">
> +  <!ENTITY rarian-download-ftp  "&gnome-download-ftp;/rarian/0.8/rarian-0.8.1.tar.bz2">

Notice the use of entities for the gnome download locations. If for
whatever reason, GNOME moves to a different directory structure, we
only need to change the entity.



> -  <!ENTITY rarian-buildsize     "6 MB">
> +  <!ENTITY rarian-buildsize     "6.0 MB">

I'm not sure why I did this. I think just the plain 6 MB is probably
best.


> -    <para role="recommended"><xref linkend="libxslt"/> (rarian-sk-extract will not be built without this)</para>
> +    <para role="recommended"><xref linkend="libxslt"/>
> +    (rarian-sk-extract will not be built without this)</para>

Try to keep XML lines of code to 80 chars or less has been the convention.


>        <varlistentry id="rarian-example">
>          <term><command>rarian-example</command></term>
>          <listitem>
> -          <para>Prints a nice list of all available documents found by the
> +          <para>prints a nice list of all available documents found by the
>            library.</para>

What we try to do here is sort of make a sentence. The command is followed
by a description to complete the sentence. Opposite of what LFS does.

-- 
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]
09:11:03 up 20 days, 21:39, 1 user, load average: 1.21, 0.72, 0.62



More information about the blfs-book mailing list