r7026 - in trunk/BOOK: introduction/welcome xsoft/office

randy at linuxfromscratch.org randy at linuxfromscratch.org
Tue Aug 7 09:50:50 PDT 2007


Author: randy
Date: 2007-08-07 10:50:50 -0600 (Tue, 07 Aug 2007)
New Revision: 7026

Modified:
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/xsoft/office/abiword.xml
   trunk/BOOK/xsoft/office/gnumeric.xml
Log:
Minor modifications to the Gnumeric build instructions; added notes to the AbiWord and Gnumeric instructions that the versions of libgda/libgnomedb will conflict with each other

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2007-08-07 13:30:46 UTC (rev 7025)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2007-08-07 16:50:50 UTC (rev 7026)
@@ -45,6 +45,15 @@
       <para>August 7th, 2007</para>
       <itemizedlist>
         <listitem>
+          <para>[randy] - Added notes to the AbiWord and Gnumeric instructions
+          that the versions of libgda/libgnomedb will conflict with each
+          other.</para>
+        </listitem>
+        <listitem>
+          <para>[randy] - Minor modifications to the Gnumeric build
+          instructions.</para>
+        </listitem>
+        <listitem>
           <para>[randy] - Updated to AbiWord-2.4.6.</para>
         </listitem>
       </itemizedlist>

Modified: trunk/BOOK/xsoft/office/abiword.xml
===================================================================
--- trunk/BOOK/xsoft/office/abiword.xml	2007-08-07 13:30:46 UTC (rev 7025)
+++ trunk/BOOK/xsoft/office/abiword.xml	2007-08-07 16:50:50 UTC (rev 7026)
@@ -83,7 +83,7 @@
     <ulink url="&gnome-download-http;/goffice/0.2/">GOffice <0.3.0</ulink>),
     <ulink url="http://www.abisource.com/projects/link-grammar/">Link Grammar</ulink>,
     <ulink url="http://aiksaurus.sourceforge.net/">Aiksaurus</ulink>,
-    <ulink url="http://www.gnome-db.org/">libgnomedb version <1.3.0</ulink> (requires
+    <ulink url="http://www.gnome-db.org/">libgnomedb version <1.3.0</ulink>* (requires
     <ulink url="http://www.gnome-db.org/">libgda version <1.3.0</ulink>),
     <ulink url="http://sourceforge.net/projects/wvware">libwmf</ulink>,
     <ulink url="http://helm.cs.unibo.it/mml-widget/">GtkMathView</ulink> (requires
@@ -93,6 +93,18 @@
     <ulink url="http://libots.sourceforge.net/">OTS</ulink>, and
     <ulink url="http://software.frodo.looijaard.name/psiconv/">Psiconv</ulink></para>
 
+    <para>* The
+    <application>libgda</application>/<application>libgnomedb</application>
+    stack required for <application>AbiWord</application> database
+    access may conflict with the versions used by the
+    <xref linkend="gnumeric"/> database plugin. Though the libraries
+    themselves pose no conflict, the executables and support files will
+    overwrite one another. Note that the current (version 3.0.x) stack does not
+    pose a conflict with any of the previous versions (but does not support
+    <application>AbiWord</application> or <application>Gnumeric</application>
+    database access. <application>AbiWord</application> requires versions
+    <1.3.0 (1.2.2 is known to work).</para>
+
     <para condition="html" role="usernotes">User Notes:
     <ulink url="&blfs-wiki;/abiword"/></para>
 
@@ -176,7 +188,7 @@
     description file:</para>
 
 <screen role="root"><userinput>install -v -m644 abidistfiles/GNOME_AbiWord_Control_&AbiWord-under-version;.server \
-                 $GNOME_PREFIX/lib/bonobo/servers</userinput></screen>
+        $(pkg-config --variable=prefix ORBit-2.0)/lib/bonobo/servers</userinput></screen>
 
     <para>If the <application>GNOME</application> installation is in any prefix
     other than <filename class='directory'>/usr</filename>, remove unneeded

Modified: trunk/BOOK/xsoft/office/gnumeric.xml
===================================================================
--- trunk/BOOK/xsoft/office/gnumeric.xml	2007-08-07 13:30:46 UTC (rev 7025)
+++ trunk/BOOK/xsoft/office/gnumeric.xml	2007-08-07 16:50:50 UTC (rev 7026)
@@ -62,14 +62,11 @@
     url="&gnome-download-http;/goffice/0.2/">GOffice <0.3.0</ulink>)</para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional"><xref linkend="python"/>,
-    <ulink url="http://www.pygtk.org/">PyGTK</ulink>,
+    <para role="optional"><ulink url="http://www.pygtk.org/">PyGTK</ulink>,
     <xref linkend="libgnomeui"/> (combined with the
     <filename class='libraryfile'>libgsf-gnome-1</filename> library from the
     <xref linkend="libgsf"/> package will provide GNOME-2 support),
-    <xref linkend="gnome-doc-utils"/> (to convert the XML help documentation
-    into HTML),
-    <ulink url="http://www.gnome-db.org/">libgnomedb</ulink>
+    <ulink url="http://www.gnome-db.org/">libgnomedb</ulink>*
     (requires <ulink url="http://www.gnome-db.org/">libgda</ulink>),
     <ulink url="http://pxlib.sourceforge.net/">pxlib</ulink>,
     <ulink url="http://www.frodol.dds.nl/psiconv/index.html">Psiconv</ulink>,
@@ -77,6 +74,18 @@
     <ulink url="http://packages.ubuntu.com/warty/libdevel/libgb-dev">Gnome
     Basic</ulink> (this package is no longer under active development)</para>
 
+    <para>* The
+    <application>libgda</application>/<application>libgnomedb</application>
+    stack required for <application>Gnumeric</application> database
+    access may conflict with the versions used by the
+    <xref linkend="abiword"/> database plugin. Though the libraries
+    themselves pose no conflict, the executables and support files will
+    overwrite one another. Note that the current (version 3.0.x) stack does not
+    pose a conflict with any of the previous versions (but does not support
+    <application>Gnumeric</application> or <application>AbiWord</application>
+    database access. <application>Gnumeric</application> requires versions
+    >1.2.x and <2.x.x (1.99.1 is known to work).</para>
+
     <note>
       <para>Though only a run-time dependency, if you don't install the
       <xref linkend="yelp"/> package, the built-in help functionality in
@@ -103,41 +112,39 @@
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
-<screen role='root'><userinput>make install</userinput></screen>
+<screen role='root'><userinput>make install &&
+ln -v -s -f /usr/share/gnome/help/gnumeric \
+            /usr/share/gnumeric/&gnumeric-version;/doc</userinput></screen>
 
-    <para>There is a bug in the program. The help system looks for the docs in
-    one location, but they are actually installed in the wrong place. See
-    <ulink url="http://bugzilla.gnome.org/show_bug.cgi?id=330339"/>. If you have
-    <xref linkend="yelp"/> installed and would like to be able to use it to view
-    the help documentation from within <application>Gnumeric</application>, work
-    around the problem by creating a symbolic link. As
-    <systemitem class="username">root</systemitem>:</para>
+    <para>If you have a <application>GNOME</application> installation in any
+    prefix other than <filename class='directory'>/usr</filename>, issue
+    the following commands as the <systemitem class="username">root</systemitem>
+    user to move the <application>Gnumeric</application> Bonobo component
+    description file into the <envar>$GNOME_PREFIX</envar> heirarchy and
+    then remove the unneeded directories:</para>
 
-<screen role='root'><userinput>ln -vsf /usr/share/gnome/help/gnumeric \
-        /usr/share/gnumeric/&gnumeric-version;/doc</userinput></screen>
+<screen role='root'><userinput>mv -v /usr/lib/bonobo/servers/GNOME_Gnumeric.server \
+    $(pkg-config --variable=prefix ORBit-2.0)/lib/bonobo/servers &&
+rmdir -v /usr/lib/{bonobo/servers,bonobo}</userinput></screen>
 
-    <para>If you have GNOME installed in a prefix other than /usr, as the
-    <systemitem class="username">root</systemitem> user create the
-    following symlink for the <application>Gnumeric</application>
-    <application>Bonobo</application> server file:</para>
-
-<screen role='root'><userinput>ln -v -s /usr/lib/bonobo/servers/GNOME_Gnumeric.server \
-    $(pkg-config --variable=prefix ORBit-2.0)/lib/bonobo/servers</userinput></screen>
-
     <para>If you have <xref linkend="gnome-doc-utils"/> installed you can
-    convert the XML help files into HTML by issuing the following commands:</para>
+    create an HTML version of the Help documentation by issuing the following
+    commands:</para>
 
 <screen><userinput>./configure \
     --prefix=$(pkg-config --variable=prefix gnome-doc-utils) &&
 make -C doc html</userinput></screen>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user,
-    install the documentation files:</para>
+    <para>If you created the HTML documentation, install it by issuing the
+    following commands as the
+    <systemitem class="username">root</systemitem> user:</para>
 
 <screen role='root'><userinput>install -v -m755 -d /usr/share/doc/gnumeric-&gnumeric-version;/figures &&
-install -v -m644 doc/C/html/* /usr/share/doc/gnumeric-&gnumeric-version; &&
-install -v -m644 doc/C/figures/* \
-    /usr/share/doc/gnumeric-&gnumeric-version;/figures &&
+install -v -m644    doc/C/figures/* \
+                    /usr/share/doc/gnumeric-&gnumeric-version;/figures &&
+install -v -m644    doc/C/html/* \
+                    /usr/share/doc/gnumeric-&gnumeric-version; &&
+
 ln -v -s /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;/images \
     /usr/share/doc/gnumeric-&gnumeric-version;/stylesheet</userinput></screen>
 
@@ -146,8 +153,9 @@
     <systemitem class="username">root</systemitem> user:</para>
 
 <screen role='root'><userinput>install -v -m755 -d /usr/share/doc/gnumeric-&gnumeric-version;/developer &&
-install -v -m644 doc/developer/* \
-    /usr/share/doc/gnumeric-&gnumeric-version;/developer &&
+install -v -m644    doc/developer/* \
+                    /usr/share/doc/gnumeric-&gnumeric-version;/developer &&
+
 rm -v /usr/share/doc/gnumeric-&gnumeric-version;/developer/Makefile*</userinput></screen>
 
   </sect2>
@@ -161,15 +169,19 @@
     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     href="../../xincludes/scrollkeeper-dir.xml"/>
 
+    <para><command>ln -v -s -f ...
+    /usr/share/gnumeric/&gnumeric-version;/doc</command>: There is a bug which
+    prevents the Help files from being properly displayed. The Help system
+    looks for the files in one location, but they are actually installed in
+    another. See
+    <ulink url="http://bugzilla.gnome.org/show_bug.cgi?id=330339"/>. Creating
+    the symbolic link works around this issue.</para>
+
     <para><parameter>--prefix=$(pkg-config
     --variable=prefix gnome-doc-utils)</parameter>:
-    This rebuilds the <filename>Makefile</filename>s with the same prefix as
-    <application>GNOME Doc Utils</application></para>
+    This rebuilds the <filename>Makefile</filename>s with the same prefix used 
+    in the <application>GNOME Doc Utils</application> installation.</para>
 
-    <para><command>make -C doc html</command>: This command runs
-    <command>make</command> in the <filename class="directory">doc</filename>
-    directory with html as the <filename>Makefile</filename> target.</para>
-
   </sect2>
 
   <sect2 role="content">




More information about the blfs-book mailing list