autogen 5.16

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10218 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Krejzi 2012-05-19 17:38:41 +00:00
parent ae00b76480
commit b643cd8b68
3 changed files with 105 additions and 74 deletions

View File

@ -283,7 +283,7 @@ $Date$
<!-- Chapter 11 -->
<!ENTITY apr-util-version "1.4.1">
<!ENTITY autogen-version "5.12">
<!ENTITY autogen-version "5.16">
<!ENTITY bc-version "1.06.95">
<!ENTITY compface-version "1.5.2">
<!ENTITY desktop-file-utils-version "0.20">

View File

@ -4,15 +4,17 @@
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY autogen-download-http "http://ftp.gnu.org/gnu/autogen/rel5.12/autogen-&autogen-version;.tar.bz2">
<!ENTITY autogen-download-ftp " ">
<!ENTITY autogen-md5sum "126e56be629cda747390e8ba9be71e4b">
<!ENTITY autogen-size "1.1 MB">
<!ENTITY autogen-buildsize "39 MB">
<!ENTITY autogen-time "0.5 SBU">
<!ENTITY autogen-download-http
"http://ftp.gnu.org/gnu/autogen/rel&autogen-version;/autogen-&autogen-version;.tar.xz">
<!ENTITY autogen-download-ftp
"ftp://ftp.gnu.org/gnu/autogen/rel&autogen-version;/autogen-&autogen-version;.tar.xz">
<!ENTITY autogen-md5sum "1033108d6a0f180c2743fc380937021d">
<!ENTITY autogen-size "920 KB">
<!ENTITY autogen-buildsize "15 MB">
<!ENTITY autogen-time "0.8 SBU">
]>
<sect1 id="autogen" xreflabel="autogen-&autogen-version;">
<sect1 id="autogen" xreflabel="AutoGen-&autogen-version;">
<?dbhtml filename="autogen.html"?>
<sect1info>
@ -20,87 +22,89 @@
<date>$Date$</date>
</sect1info>
<title>autogen-&autogen-version;</title>
<title>AutoGen-&autogen-version;</title>
<indexterm zone="autogen">
<primary sortas="a-autogen">autogen</primary>
<primary sortas="a-AutoGen">AutoGen</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to autogen</title>
<title>Introduction to AutoGen</title>
<para><application>Autogen</application> is a tool designed to simplify the
creation and maintenance of programs that contain large amounts of repetitious
text. It is especially valuable in programs that have several blocks of text
that must be kept synchronized.</para>
<para>
<application>AutoGen</application> is a tool designed to simplify the
creation and maintenance of programs that contain large amounts of
repetitious text. It is especially valuable in programs that have
several blocks of text that must be kept synchronized.
</para>
&lfs70_built;
&lfs70_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&autogen-download-http;"/></para>
<para>
Download (HTTP): <ulink url="&autogen-download-http;"/>
</para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&autogen-download-ftp;"/></para>
<para>
Download (FTP): <ulink url="&autogen-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>Download MD5 sum: &autogen-md5sum;</para>
<para>
Download MD5 sum: &autogen-md5sum;
</para>
</listitem>
<listitem>
<para>Download size: &autogen-size;</para>
<para>
Download size: &autogen-size;
</para>
</listitem>
<listitem>
<para>Estimated disk space required: &autogen-buildsize;</para>
<para>
Estimated disk space required: &autogen-buildsize;
</para>
</listitem>
<listitem>
<para>Estimated build time: &autogen-time;</para>
<para>
Estimated build time: &autogen-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing='compact'>
<listitem>
<para>Optional Patch: <ulink
url="&patch-root;/autogen-&autogen-version;-build_shared-1.patch"/></para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">autogen Dependencies</bridgehead>
<bridgehead renderas="sect3">AutoGen Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="guile"/></para>
<para role="required">
<xref linkend="guile"/> and
<xref linkend="libxml2"/>
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/autogen"/></para>
<ulink url="&blfs-wiki;/autogen"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of autogen</title>
<title>Installation of AutoGen</title>
<!-- yes, I do mean if and only if (ken) : this package is an aggravation -->
<para>IFF you do not wish to install the static library, and will
add '--enable-static=no' to the configure, apply the patch.
This is not recommended, but included as an example of how a common
option may have an unexpected implementation. The preferred
approach for this package is to discard the static library after
the package has been installed.</para>
<para>
Install <application>AutoGen</application> by running the following
commands:
</para>
<screen><userinput>patch -Np1 -i ../autogen-&autogen-version;-build_shared-1.patch
</userinput></screen>
<para>Install <application>autogen</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.
You can expect some failures. If you applied the patch, the
testsuite will fail because it is looking for the static library.</para>
<para>
To test the results, issue: <command>make check</command>.
</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
@ -109,15 +113,8 @@ make</userinput></screen>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>patch -Np1 -i ...</command>: The patch modifies the
<filename>mk-agen-texi-in</filename> file so that it can use the shared
<filename>libopts.so</filename> when rebuilding the supplied documentation.
No doubt similar changes can be made to enable the testsuite to run in the
absence of the static library.</para>
<para><option>--enable-static=no</option>: This switch prevents the static
library being installed. Unusually, in this package it prevents it being
created and used by the package itself.</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/static-libraries.xml"/>
</sect2>
@ -130,9 +127,16 @@ make</userinput></screen>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>autogen, autoopts-config, columns, getdefs, and xml2ag</seg>
<seg>libopts.{so,a}</seg>
<seg>/usr/{include/autoopts,share/autogen}</seg>
<seg>
autogen, autoopts-config, columns, getdefs and xml2ag
</seg>
<seg>
libopts.so
</seg>
<seg>
/usr/include/autoopts and
/usr/share/autogen
</seg>
</seglistitem>
</segmentedlist>
@ -144,9 +148,12 @@ make</userinput></screen>
<varlistentry id="autogen-prog">
<term><command>autogen</command></term>
<listitem>
<para>is an automated text file generator.</para>
<para>
is designed for generating program files that contain
repetitive text with varied substitutions.
</para>
<indexterm zone="autogen autogen-prog">
<primary sortas="b-autogen-prog">autogen-prog</primary>
<primary sortas="b-autogen">autogen</primary>
</indexterm>
</listitem>
</varlistentry>
@ -154,7 +161,11 @@ make</userinput></screen>
<varlistentry id="autoopts-config">
<term><command>autoopts-config</command></term>
<listitem>
<para>does this .....</para>
<para>
is a tool that is used by configure to determine the compiler and
linker flags that should be used to compile and link programs that
use <application>AutoOpts</application>.
</para>
<indexterm zone="autogen autoopts-config">
<primary sortas="b-autoopts-config">autoopts-config</primary>
</indexterm>
@ -164,7 +175,9 @@ make</userinput></screen>
<varlistentry id="columns">
<term><command>columns</command></term>
<listitem>
<para>does this .....</para>
<para>
is used to columnize input text.
</para>
<indexterm zone="autogen columns">
<primary sortas="b-columns">columns</primary>
</indexterm>
@ -174,7 +187,10 @@ make</userinput></screen>
<varlistentry id="getdefs">
<term><command>getdefs</command></term>
<listitem>
<para>does this .....</para>
<para>
is used to extract <application>AutoGen</application> definitions
from a list of source files.
</para>
<indexterm zone="autogen getdefs">
<primary sortas="b-getdefs">getdefs</primary>
</indexterm>
@ -184,7 +200,10 @@ make</userinput></screen>
<varlistentry id="xml2ag">
<term><command>xml2ag</command></term>
<listitem>
<para>does this .....</para>
<para>
is used to convert any arbitrary XML file into equivalent
<application>AutoGen</application> definitions.
</para>
<indexterm zone="autogen xml2ag">
<primary sortas="b-xml2ag">xml2ag</primary>
</indexterm>
@ -192,11 +211,14 @@ make</userinput></screen>
</varlistentry>
<varlistentry id="libopts">
<term><filename class='libraryfile'>libopts.{so,a}</filename></term>
<term><filename class='libraryfile'>libopts.so</filename></term>
<listitem>
<para>contains functions that .....</para>
<para>
is an automated option processing library based on
<application>AutoGen</application>.
</para>
<indexterm zone="autogen libopts">
<primary sortas="c-libopts">libopts.{so,a}</primary>
<primary sortas="c-libopts">libopts.so</primary>
</indexterm>
</listitem>
</varlistentry>

View File

@ -41,6 +41,15 @@
</listitem>
-->
<listitem>
<para>May 19th, 2012</para>
<itemizedlist>
<listitem>
<para>[krejzi] - AutoGen 5.16.</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>May 16th, 2012</para>
<itemizedlist>