Proper, filename classes, Part X

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@1271 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Larry Lawrence 2003-10-02 13:29:48 +00:00
parent c30e8cc71b
commit a294e13300
21 changed files with 83 additions and 61 deletions

View File

@ -1,62 +1,76 @@
<partintro>
<title>Introduction to GNOME</title>
<title>Introduction to <application><acronym>GNOME</acronym></application></title>
<para>This chapter attempts to install a complete GNOME-&gnome-version; desktop
environment and a limited GNOME 1.4 library environment that is
sufficient to run GNOME 1.4 applications included in this book. The
<para>This chapter attempts to install a complete
<application><acronym>GNOME</acronym></application>-&gnome-version; desktop
environment and a limited
<application><acronym>GNOME</acronym></application> 1.4 library environment that is
sufficient to run <application><acronym>GNOME</acronym></application> 1.4 applications included in this book. The
order of the pages are meant to follow the build order defined by the
GNOME development team as published in the <ulink
url="http://www.gnome.org/start/&gnome-version;/notes/rninstallation.html">release notes</ulink>, with two exceptions. If a package is in the release notes build list, but not in this chapter, it has been installed elsewhere in the book.</para>
<para>The installation of GNOME-&gnome-version; is a large undertaking and one we would
<para>The installation of <application><acronym>GNOME</acronym></application>-&gnome-version; is a large undertaking and one we would
like to see you complete with the least amount of stress. One
of our first goals in this installation is to protect your previously
installed software, especially if you are testing GNOME on your machine.
GNOME-&gnome-version; packages utilize the --prefix= option for configure, so we will
installed software, especially if you are testing
<application><acronym>GNOME</acronym></application> on your machine.
<application><acronym>GNOME</acronym></application>-&gnome-version; packages utilize the --prefix= option for configure, so we will
use that and an Environment variable (<envar>GNOME_PREFIX</envar>) to add flexibility to
the install.</para>
<para>If you know that you want GNOME as your desktop, it is recommended that
<para>If you know that you want
<application><acronym>GNOME</acronym></application> as your desktop, it is recommended that
you install with --prefix=/usr. If you are not sure that you are going
to keep GNOME on your installation, it is recommended that you install with
to keep <application><acronym>GNOME</acronym></application> on your installation, it is recommended that you install with
--prefix=/opt/gnome-&gnome-version;. Setting the Environment variable and the
additional edits required by the second option are covered on the
pre-installation page.</para>
<para>If you choose the second option, removal of GNOME-2.2 is as easy
<para>If you choose the second option, removal of
<application><acronym>GNOME</acronym></application>-&gnome-version; is as easy
as removing the edits from the pre-installation page and issueing the
following command:</para>
<screen><userinput><command>rm /opt/gnome-&gnome-version; -r </command></userinput></screen>
<para>If your system was completely built per <acronym>LFS</acronym> and
<acronym>BLFS</acronym>
instructions, you have a very good chance of using GNOME-&gnome-version;
instructions, you have a very good chance of using
<application><acronym>GNOME</acronym></application>-&gnome-version;
after your first install. If you are a typical <acronym>LFS</acronym> user, you have made
modifications to the instructions along the way knowing that you have to
take those modifications into account on future installations. You
should have no problems integrating GNOME-&gnome-version; into your unique setup, but
you will have 28 to 33 packages installed before you can run GNOME
should have no problems integrating
<application><acronym>GNOME</acronym></application>-&gnome-version; into your unique setup, but
you will have 28 to 33 packages installed before you can run
<application><acronym>GNOME</acronym></application>
through any testing (assuming your window manager is preinstalled and
tested). We would anticipate that you will be rebuilding GNOME at least
tested). We would anticipate that you will be rebuilding
<application><acronym>GNOME</acronym></application> at least
once to make adjustments for your setup.</para>
<para>If you are building a GNOME 1.4 desktop environment, you would
install only those libraries in the GNOME 1.4 chapter
<emphasis>and</emphasis> any dependencies listed on those pages, whether labeled or not. GNOME packages without pages are simply installed with:
<para>If you are building a
<application><acronym>GNOME</acronym></application> 1.4 desktop environment, you would
install only those libraries in the
<application><acronym>GNOME</acronym></application> 1.4 chapter
<emphasis>and</emphasis> any dependencies listed on those pages, whether
labeled or not. <application><acronym>GNOME</acronym></application> packages without pages are simply installed with:
<screen><command>./configure --prefix=/opt/gnome &amp;&amp;
make &amp;&amp;
make install</command></screen>
These instructions are simplistic to facilitate removal of GNOME 1.4
These instructions are simplistic to facilitate removal of
<application><acronym>GNOME</acronym></application> 1.4
from <acronym>BLFS</acronym> systems when it is no longer necessary. These instructions
may be refined later to comply with <acronym>BLFS</acronym> standards for file locations,
specifically <filename class='directory'>/opt/gnome/etc</filename> to
<filename class='directory'>/etc</filename> and <filename
class='directory'>/opt/gnome/var</filename> to
<filename class='directory'>/var</filename>. You should consider using the GNOME 1.4 hint
<filename class='directory'>/var</filename>. You should consider using
the <application><acronym>GNOME</acronym></application> 1.4 hint
located at <ulink url="http://hints.linuxfromscratch.org/hints"/> if you
have no interest in GNOME-&gnome-version;.</para>
have no interest in <application><acronym>GNOME</acronym></application>-&gnome-version;.</para>
<para>GNOME-&gnome-version; dependencies</para>
<para><application><acronym>GNOME</acronym></application>-&gnome-version; dependencies</para>
<para>Required</para>
<para><xref linkend="xfree86"/>, <xref linkend="GTK2"/>, <xref
linkend="libpng"/>,

View File

@ -1,6 +1,6 @@
<sect1 id="bonobo-activation" xreflabel="bonobo-activation-&bonobo-activation-version;">
<sect1 id="bonobo-activation" xreflabel="Bonobo Activation-&bonobo-activation-version;">
<?dbhtml filename="bonobo-activation.html" dir="gnome"?>
<title>bonobo-activation-&bonobo-activation-version;</title>
<title>Bonobo Activation-&bonobo-activation-version;</title>
&bonobo-activation-intro;
&bonobo-activation-inst;

View File

@ -1,5 +1,5 @@
<sect2>
<title>Configuring <application>bonobo-activation</application></title>
<title>Configuring <application>Bonobo Activation</application></title>
<sect3><title>Configuration Information</title>

View File

@ -1,8 +1,8 @@
<sect2>
<title>Contents</title>
<para>The <application>bonobo-activation</application> package contains
<filename>libbonobo-activation</filename> libraries.</para>
<para>The <application>Bonobo Activation</application> package contains
<filename class="directory">libbonobo-activation</filename> libraries.</para>
</sect2>

View File

@ -1,7 +1,7 @@
<sect2>
<title>Installation of <application>bonobo-activation</application></title>
<title>Installation of <application>Bonobo Activation</application></title>
<para>Install <application>bonobo-activation</application> by running the following commands:</para>
<para>Install <application>Bonobo Activation</application> by running the following commands:</para>
<screen><userinput><command>./configure --prefix=$GNOME_PREFIX --libexecdir=$GNOME_PREFIX/sbin \
--sysconfdir=/etc/gnome --disable-gtk-doc &amp;&amp;

View File

@ -1,10 +1,11 @@
<sect2>
<title>Introduction to <application>bonobo-activation</application></title>
<title>Introduction to <application>Bonobo Activation</application></title>
<para>The <application>bonobo-activation</application> package contains libbonobo-activation
<para>The <application>Bonobo Activation</application> package contains
<filename class="libraryfile">libbonobo-activation</filename>
libraries. This is the new Object Activation Framework
(<acronym>OAF</acronym>) for
GNOME.</para>
<application><acronym>GNOME</acronym></application>.</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
@ -19,7 +20,7 @@ url="&bonobo-activation-download-ftp;"/></para></listitem>
&bonobo-activation-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title><application>bonobo-activation</application> dependencies</title>
<sect3><title><application>Bonobo Activation</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="ORBit2"/></para></sect4>
<sect4><title>Optional</title>

View File

@ -1,6 +1,6 @@
<sect1 id="gnome-mime-data" xreflabel="gnome-mime-data-&gnome-mime-data-version;">
<sect1 id="gnome-mime-data" xreflabel="GNOME MIME Data-&gnome-mime-data-version;">
<?dbhtml filename="gnome-mime-data.html" dir="gnome"?>
<title>gnome-mime-data-&gnome-mime-data-version;</title>
<title>GNOME MIME Data-&gnome-mime-data-version;</title>
&gnome-mime-data-intro;
&gnome-mime-data-inst;

View File

@ -1,7 +1,8 @@
<sect2>
<title>Contents</title>
<para>The gnome-mime-data package contains
<para>The <application><acronym>GNOME</acronym> <acronym>MIME</acronym>
Data</application> package contains
<filename>$GNOME_PREFIX/share/icons</filename>,
<filename>$GNOME_PREFIX/share/application-registry</filename> and
<filename>$GNOME_PREFIX/share/mime-info</filename>.</para>

View File

@ -1,7 +1,7 @@
<sect2>
<title>Installation of <application>gnome-mime-data</application></title>
<title>Installation of <application><acronym>GNOME</acronym> <acronym>MIME</acronym> Data</application></title>
<para>Install <application>gnome-mime-data</application> by running the following commands:</para>
<para>Install <application><acronym>GNOME</acronym> <acronym>MIME</acronym> Data</application> by running the following commands:</para>
<screen><userinput><command>./configure --prefix=$GNOME_PREFIX --sysconfdir=/etc/gnome &amp;&amp;
make &amp;&amp;

View File

@ -1,8 +1,8 @@
<sect2>
<title>Introduction to <application>gnome-mime-data</application></title>
<title>Introduction to <application><acronym>GNOME</acronym> <acronym>MIME</acronym> Data</application></title>
<para>The <application>gnome-mime-data</application> package contains the base set of file types
and applications for GNOME.</para>
<para>The <application><acronym>GNOME</acronym> <acronym>MIME</acronym> Data</application> package contains the base set of file types
and applications for <application><acronym>GNOME</acronym></application>.</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>

View File

@ -1,6 +1,6 @@
<sect1 id="gtk-doc" xreflabel="gtk-doc-&gtk-doc-version;">
<sect1 id="gtk-doc" xreflabel="GTK-Doc-&gtk-doc-version;">
<?dbhtml filename="gtk-doc.html" dir="gnome"?>
<title>gtk-doc-&gtk-doc-version;</title>
<title>GTK-Doc-&gtk-doc-version;</title>
&gtk-doc-intro;
&gtk-doc-inst;

View File

@ -1,7 +1,7 @@
<sect2>
<title>Contents</title>
<para>The <application>gtk-doc</application> package contains
<para>The <application><acronym>GTK</acronym>-Doc</application> package contains
<command>gtkdoc-fixxref</command>,
<command>gtkdoc-mkdb</command>,
<command>gtkdoc-mkhtml</command>,

View File

@ -1,7 +1,7 @@
<sect2>
<title>Installation of <application>gtk-doc</application></title>
<title>Installation of <application><acronym>GTK</acronym>-Doc</application></title>
<para>Install <application>gtk-doc</application> by running the following commands:</para>
<para>Install <application><acronym>GTK</acronym>-Doc</application> by running the following commands:</para>
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make install</command></userinput></screen>

View File

@ -1,11 +1,12 @@
<sect2>
<title>Introduction to gtk-doc</title>
<title>Introduction to <application><acronym>GTK</acronym>-Doc</application></title>
<para>The gtk-doc package contains a code documentor. This is useful for
extracting specially-formatted comments from the code to create API
<para>The <application><acronym>GTK</acronym>-Doc</application> package contains a code documentor. This is useful for
extracting specially formatted comments from the code to create
<acronym>API</acronym>
documentation. This package is <emphasis>optional</emphasis>, if it is not
installed, packages will not build the documentation. This does not mean
that you will not have any documentation, if gtk-doc is not available, the
that you will not have any documentation, if <application><acronym>GTK</acronym>-Doc</application> is not available, the
install process will copy pre-built documentation to your system.
</para>
@ -28,7 +29,7 @@ url="&gtk-doc-download-ftp;"/></para></listitem>
<listitem><para><ulink
url="http://www.labs.redhat.com/png/png-support-3.1.dtd">png-support-3.1.dtd</ulink></para></listitem></itemizedlist></sect3> -->
<sect3><title><application>gtk-doc</application> dependencies</title>
<sect3><title><application><application><acronym>GTK</acronym>-Doc</application></application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="openjade"/>, <xref linkend="libxslt"/>, <xref
linkend="DocBook"/>,

View File

@ -1,7 +1,7 @@
<sect2>
<title>Contents</title>
<para>The intltool package contains <command>intltoolize</command>,
<para>The <application>intltool</application> package contains <command>intltoolize</command>,
<command>intltool-update</command>,
<command>intltool-extract</command>,
<command>intltool-merge</command>,

View File

@ -6,8 +6,8 @@ is useful for extracting translatable strings from source files,
collecting the extracted strings with messages from traditional source
files (<filename class="directory">&lt;source
directory&gt;/&lt;package&gt;/po</filename>)
and merging the translations into <filename>.xml</filename>,
<filename>.desktop</filename> and <filename>.oaf</filename>
and merging the translations into <filename>XML</filename>,
<filename>.desktop</filename> and <filename>OAF</filename>
files.</para>
<sect3><title>Package information</title>

View File

@ -1,6 +1,6 @@
<sect1 id="gnome-lib-config">
<?dbhtml filename="lib-config.html" dir="gnome"?>
<title>pre-installation configuration</title>
<title>Pre-installation configuration</title>
<para>Set an Environment variable to resolve the prefix destination.</para>
<para>If <application><acronym>GNOME</acronym></application> is your desktop of choice:</para>

View File

@ -1,14 +1,15 @@
<sect2>
<title>Contents</title>
<para>The <application>libIDL</application> package contains <filename>libIDL</filename> libraries.</para>
<para>The <application>libIDL</application> package contains <filename
class="libraryfile">libIDL</filename> libraries.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>libIDL libraries</title>
<para>libIDL libraries provide the functions to create and maintain
<para><filename class="libraryfile">libIDL</filename> libraries provide the functions to create and maintain
trees of <acronym>CORBA</acronym> Interface Definition Language
(<acronym>IDL</acronym>) files.</para></sect3>

View File

@ -9,7 +9,7 @@ class="directory">liblinc</filename> libraries.</para>
<sect2><title>Description</title>
<sect3><title>liblinc libraries</title>
<para>liblinc libraries provide the functions to take care of connection
<para><filename class="libraryfile">liblinc</filename> libraries provide the functions to take care of connection
initiation and maintenance, and the details of various transports
(<acronym>IP</acronym>v4, Unix domain sockets,
<acronym>IP</acronym>v6 and <acronym>IrDA</acronym>).</para></sect3>

View File

@ -1,12 +1,13 @@
<sect2>
<title>Command explanations</title>
<para><command>--with-openssl</command> : This switch compiles
<para><option>--with-openssl</option>: This switch compiles
<application>linc</application>
with <application>OpenSSL</application> support.</para>
with <application>Open<acronym>SSL</acronym></application> support.</para>
<para><command>--disable-gtk-doc</command> : This switch will
prevent the rebuilding of the <acronym>API</acronym> documentation during the make command.</para>
<para><option>--disable-gtk-doc</option>: This switch will
prevent the rebuilding of the <acronym>API</acronym> documentation
during the <command>make</command> command.</para>
</sect2>

View File

@ -11,6 +11,9 @@ who wrote what.</para>
<itemizedlist>
<listitem><para>October 2nd, 2003 [larry]: Many edits it Part X to put
application's proper names in and class filename tags.</para></listitem>
<listitem><para>October 2nd, 2003 [igor]: Modified Evolution
instructions.</para></listitem>