Author: ken
Date: 2009-01-20 09:58:14 -0700 (Tue, 20 Jan 2009)
New Revision: 7731
Modified:
trunk/BOOK/general.ent
trunk/BOOK/general/genutils/gtk-doc.xml
trunk/BOOK/introduction/welcome/changelog.xml
Log:
Update gtk-doc.
Modified: trunk/BOOK/general/genutils/gtk-doc.xml
===================================================================
--- trunk/BOOK/general/genutils/gtk-doc.xml 2009-01-17 18:38:09 UTC (rev
7730)
+++ trunk/BOOK/general/genutils/gtk-doc.xml 2009-01-20 16:58:14 UTC (rev
7731)
@@ -6,9 +6,9 @@
<!ENTITY gtk-doc-download-http
"&gnome-download-http;/gtk-doc/>k-doc-version;/gtk-doc->k-doc-version;.tar.bz2">
<!ENTITY gtk-doc-download-ftp
"&gnome-download-ftp;/gtk-doc/>k-doc-version;/gtk-doc->k-doc-version;.tar.bz2">
- <!ENTITY gtk-doc-md5sum "e61595df21431db28c83fe4c7d4a4fa8">
- <!ENTITY gtk-doc-size "186 KB">
- <!ENTITY gtk-doc-buildsize "2 MB">
+ <!ENTITY gtk-doc-md5sum "b5e268c71fa90aad890cf53715664d0a">
+ <!ENTITY gtk-doc-size "443 KB">
+ <!ENTITY gtk-doc-buildsize "4.8 MB">
<!ENTITY gtk-doc-time "less than 0.1 SBU">
]>
@@ -67,12 +67,16 @@
<xref linkend="DocBook"/>, and
<xref linkend="docbook-xsl"/></para>
+ <bridgehead renderas="sect4">Recommended</bridgehead>
+ <para role="optional"><xref linkend="python"/></para>
+
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="pkgconfig"/>,
<xref linkend="scrollkeeper"/>,
<xref linkend="openjade"/>,
- <xref linkend="sgml-dtd"/>, and
- <xref linkend="docbook-dsssl"/></para>
+ <xref linkend="sgml-dtd"/>,
+ <xref linkend="docbook-dsssl"/>, also
+ <xref linkend="glib2"/> (for the testsuite)</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gtk-doc"/></para>
@@ -85,22 +89,32 @@
<para>Install <application>GTK-Doc</application> by running
the following commands:</para>
-<screen><userinput>./configure --prefix=/usr --localstatedir=/var/lib
&&
+<screen><userinput>sed -i '/^pkgconfigdir/s/datadir/libdir/' &&
+./configure --prefix=/usr &&
make</userinput></screen>
- <para>This package does not come with a test suite.</para>
-
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make install</userinput></screen>
+ <para>The test suite requires that the package has been installed first,
and
+ in any case it fails because of a missing file, so there is little point
+ in running it. If you insist on seeing the results, as a normal user run:
+ <command>make check</command>.</para>
+
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
+ <para><command>sed -i '/^pkgconfigdir/s/datadir/libdir/'</command>:
+ this installs the pkgconfig file in a place which is on
+ <envar>PKG_CONFIG_PATH</envar> instead of in
+ <filename class='directory'>/usr/share/pkgconfig</filename>.</para>
+
+ <!-- no scrollkeeper files with this version
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude";
- href="../../xincludes/scrollkeeper-dir.xml"/>
+ href="../../xincludes/scrollkeeper-dir.xml"/>-->
</sect2>
@@ -113,11 +127,12 @@
<segtitle>Installed Directories</segtitle>
<seglistitem>
- <seg>gtkdocize, gtkdoc-fixxref, gtkdoc-mkdb, gtkdoc-mkhtml,
gtkdoc-mkman,
- gtkdoc-mktmpl, gtkdoc-scan, gtkdoc-scangobj, and gtkdoc-scanobj</seg>
+ <seg>gtkdocize, gtkdoc-check, gtkdoc-depscan, gtkdoc-fixxref,
gtkdoc-mkdb,
+ gtkdoc-mkhtml, gtkdoc-mkman, gtkdoc-mktmpl, gtkdoc-rebase, gtkdoc-scan,
+ gtkdoc-scangobj, and gtkdoc-scanobj</seg>
<seg>None</seg>
<seg>The following subdirectories of /usr/share/:
- doc/gtk-doc->k-doc-version;,
+ <!--doc/gtk-doc->k-doc-version;, -->
gnome/help/gtk-doc-manual,
gtk-doc/data and
{omf,sgml}/gtk-doc</seg>
@@ -132,7 +147,8 @@
<varlistentry id="gtkdoc">
<term><command>gtkdoc*</command></term>
<listitem>
- <para>these are all <application>Perl</application> scripts used by
+ <para>these are all shell, <application>Perl</application>, or
+ <application>Python</application> scripts used by
package <filename>Makefile</filename> scripts to generate
documentation for the package being built.</para>
<indexterm zone="gtk-doc gtkdoc">
Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent 2009-01-17 18:38:09 UTC (rev 7730)
+++ trunk/BOOK/general.ent 2009-01-20 16:58:14 UTC (rev 7731)
@@ -3,7 +3,7 @@
$Date$
-->
-<!ENTITY day "17"> <!-- Always 2 digits -->
+<!ENTITY day "20"> <!-- Always 2 digits -->
<!ENTITY month "01"> <!-- Always 2 digits -->
<!ENTITY year "2009">
<!ENTITY copyrightdate "2001-&year;">
@@ -171,7 +171,7 @@
<!ENTITY compface-version "1.5.2">
<!ENTITY imagemagick-version "6.3.5">
<!ENTITY hd2u-version "1.0.1">
-<!ENTITY gtk-doc-version "1.8">
+<!ENTITY gtk-doc-version "1.11">
<!ENTITY scrollkeeper-version "0.3.14">
<!ENTITY intltool-version "0.40.5">
<!ENTITY screen-version "4.0.3">
Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml 2009-01-17 18:38:09 UTC
(rev 7730)
+++ trunk/BOOK/introduction/welcome/changelog.xml 2009-01-20 16:58:14 UTC
(rev 7731)
@@ -41,6 +41,15 @@
-->
<listitem>
+ <para>January 20th, 2009</para>
+ <itemizedlist>
+ <listitem>
+ <para>[ken] - Updated to gtk-doc-1.11.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
<para>January 17th, 2009</para>
<itemizedlist>
<listitem>
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
