Ignore:
Timestamp:
05/19/2012 05:38:41 PM (12 years ago)
Author:
Krejzi <krejzi@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
37aba7f
Parents:
ae00b764
Message:

autogen 5.16

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10218 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/genutils/autogen.xml

    rae00b764 rb643cd8b  
    55  %general-entities;
    66
    7   <!ENTITY autogen-download-http "http://ftp.gnu.org/gnu/autogen/rel5.12/autogen-&autogen-version;.tar.bz2">
    8   <!ENTITY autogen-download-ftp  " ">
    9   <!ENTITY autogen-md5sum        "126e56be629cda747390e8ba9be71e4b">
    10   <!ENTITY autogen-size          "1.1 MB">
    11   <!ENTITY autogen-buildsize     "39 MB">
    12   <!ENTITY autogen-time          "0.5 SBU">
     7  <!ENTITY autogen-download-http
     8           "http://ftp.gnu.org/gnu/autogen/rel&autogen-version;/autogen-&autogen-version;.tar.xz">
     9  <!ENTITY autogen-download-ftp
     10           "ftp://ftp.gnu.org/gnu/autogen/rel&autogen-version;/autogen-&autogen-version;.tar.xz">
     11  <!ENTITY autogen-md5sum        "1033108d6a0f180c2743fc380937021d">
     12  <!ENTITY autogen-size          "920 KB">
     13  <!ENTITY autogen-buildsize     "15 MB">
     14  <!ENTITY autogen-time          "0.8 SBU">
    1315]>
    1416
    15 <sect1 id="autogen" xreflabel="autogen-&autogen-version;">
     17<sect1 id="autogen" xreflabel="AutoGen-&autogen-version;">
    1618  <?dbhtml filename="autogen.html"?>
    1719
    … …  
    2123  </sect1info>
    2224
    23   <title>autogen-&autogen-version;</title>
     25  <title>AutoGen-&autogen-version;</title>
    2426
    2527  <indexterm zone="autogen">
    26     <primary sortas="a-autogen">autogen</primary>
     28    <primary sortas="a-AutoGen">AutoGen</primary>
    2729  </indexterm>
    2830
    2931  <sect2 role="package">
    30     <title>Introduction to autogen</title>
    31 
    32     <para><application>Autogen</application> is a tool designed to simplify the
    33     creation and maintenance of programs that contain large amounts of repetitious
    34     text. It is especially valuable in programs that have several blocks of text
    35     that must be kept synchronized.</para>
    36 
    37     &lfs70_built;
     32    <title>Introduction to AutoGen</title>
     33
     34    <para>
     35      <application>AutoGen</application> is a tool designed to simplify the
     36      creation and maintenance of programs that contain large amounts of
     37      repetitious text. It is especially valuable in programs that have
     38      several blocks of text that must be kept synchronized.
     39    </para>
     40
     41    &lfs70_checked;
    3842
    3943    <bridgehead renderas="sect3">Package Information</bridgehead>
    4044    <itemizedlist spacing="compact">
    4145      <listitem>
    42         <para>Download (HTTP): <ulink url="&autogen-download-http;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download (FTP): <ulink url="&autogen-download-ftp;"/></para>
    46       </listitem>
    47       <listitem>
    48         <para>Download MD5 sum: &autogen-md5sum;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Download size: &autogen-size;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated disk space required: &autogen-buildsize;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Estimated build time: &autogen-time;</para>
     46        <para>
     47          Download (HTTP): <ulink url="&autogen-download-http;"/>
     48        </para>
     49      </listitem>
     50      <listitem>
     51        <para>
     52          Download (FTP): <ulink url="&autogen-download-ftp;"/>
     53        </para>
     54      </listitem>
     55      <listitem>
     56        <para>
     57          Download MD5 sum: &autogen-md5sum;
     58        </para>
     59      </listitem>
     60      <listitem>
     61        <para>
     62          Download size: &autogen-size;
     63        </para>
     64      </listitem>
     65      <listitem>
     66        <para>
     67          Estimated disk space required: &autogen-buildsize;
     68        </para>
     69      </listitem>
     70      <listitem>
     71        <para>
     72          Estimated build time: &autogen-time;
     73        </para>
    5874      </listitem>
    5975    </itemizedlist>
    6076
    61     <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    62     <itemizedlist spacing='compact'>
    63       <listitem>
    64         <para>Optional Patch: <ulink
    65         url="&patch-root;/autogen-&autogen-version;-build_shared-1.patch"/></para>
    66       </listitem>
    67     </itemizedlist>
    68 
    69     <bridgehead renderas="sect3">autogen Dependencies</bridgehead>
     77    <bridgehead renderas="sect3">AutoGen Dependencies</bridgehead>
    7078
    7179    <bridgehead renderas="sect4">Required</bridgehead>
    72     <para role="required"><xref linkend="guile"/></para>
     80    <para role="required">
     81      <xref linkend="guile"/> and
     82      <xref linkend="libxml2"/>
     83    </para>
    7384
    7485    <para condition="html" role="usernotes">User Notes:
    75     <ulink url="&blfs-wiki;/autogen"/></para>
    76 
     86      <ulink url="&blfs-wiki;/autogen"/>
     87    </para>
    7788  </sect2>
    7889
    7990  <sect2 role="installation">
    80     <title>Installation of autogen</title>
    81 
    82     <!-- yes, I do mean if and only if (ken) : this package is an aggravation -->
    83     <para>IFF you do not wish to install the static library, and will
    84     add '--enable-static=no' to the configure, apply the patch.
    85     This is not recommended, but included as an example of how a common
    86     option may have an unexpected implementation. The preferred
    87     approach for this package is to discard the static library after
    88     the package has been installed.</para>
    89 
    90 <screen><userinput>patch -Np1 -i ../autogen-&autogen-version;-build_shared-1.patch
    91 </userinput></screen>
    92 
    93     <para>Install <application>autogen</application> by running the following
    94     commands:</para>
    95 
    96 <screen><userinput>./configure --prefix=/usr &amp;&amp;
     91    <title>Installation of AutoGen</title>
     92
     93    <para>
     94      Install <application>AutoGen</application> by running the following
     95      commands:
     96    </para>
     97
     98<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
    9799make</userinput></screen>
    98100
    99     <para>To test the results, issue: <command>make check</command>.
    100     You can expect some failures.  If you applied the patch, the
    101     testsuite will fail because it is looking for the static library.</para>
    102 
    103     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     101    <para>
     102      To test the results, issue: <command>make check</command>.
     103    </para>
     104
     105    <para>
     106      Now, as the <systemitem class="username">root</systemitem> user:
     107    </para>
    104108
    105109<screen role="root"><userinput>make install</userinput></screen>
    … …  
    110114    <title>Command Explanations</title>
    111115
    112     <para><command>patch -Np1 -i ...</command>: The patch modifies the
    113     <filename>mk-agen-texi-in</filename> file so that it can use the shared
    114     <filename>libopts.so</filename> when rebuilding the supplied documentation.
    115     No doubt similar changes can be made to enable the testsuite to run in the
    116     absence of the static library.</para>
    117 
    118     <para><option>--enable-static=no</option>: This switch prevents the static
    119     library being installed.  Unusually, in this package it prevents it being
    120     created and used by the package itself.</para>
     116    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     117      href="../../xincludes/static-libraries.xml"/>
    121118
    122119  </sect2>
    … …  
    131128
    132129      <seglistitem>
    133         <seg>autogen, autoopts-config, columns, getdefs, and xml2ag</seg>
    134         <seg>libopts.{so,a}</seg>
    135         <seg>/usr/{include/autoopts,share/autogen}</seg>
     130        <seg>
     131          autogen, autoopts-config, columns, getdefs and xml2ag
     132        </seg>
     133        <seg>
     134          libopts.so
     135        </seg>
     136        <seg>
     137          /usr/include/autoopts and
     138          /usr/share/autogen
     139        </seg>
    136140      </seglistitem>
    137141    </segmentedlist>
    … …  
    145149        <term><command>autogen</command></term>
    146150        <listitem>
    147           <para>is an automated text file generator.</para>
     151          <para>
     152            is designed for generating program files that contain
     153            repetitive text with varied substitutions.
     154          </para>
    148155          <indexterm zone="autogen autogen-prog">
    149             <primary sortas="b-autogen-prog">autogen-prog</primary>
     156            <primary sortas="b-autogen">autogen</primary>
    150157          </indexterm>
    151158        </listitem>
    … …  
    155162        <term><command>autoopts-config</command></term>
    156163        <listitem>
    157           <para>does this .....</para>
     164          <para>
     165            is a tool that is used by configure to determine the compiler and
     166            linker flags that should be used to compile and link programs that
     167            use <application>AutoOpts</application>.
     168          </para>
    158169          <indexterm zone="autogen autoopts-config">
    159170            <primary sortas="b-autoopts-config">autoopts-config</primary>
    … …  
    165176        <term><command>columns</command></term>
    166177        <listitem>
    167           <para>does this .....</para>
     178          <para>
     179            is used to columnize input text.
     180          </para>
    168181          <indexterm zone="autogen columns">
    169182            <primary sortas="b-columns">columns</primary>
    … …  
    175188        <term><command>getdefs</command></term>
    176189        <listitem>
    177           <para>does this .....</para>
     190          <para>
     191            is used to extract <application>AutoGen</application> definitions
     192            from a list of source files.
     193          </para>
    178194          <indexterm zone="autogen getdefs">
    179195            <primary sortas="b-getdefs">getdefs</primary>
    … …  
    185201        <term><command>xml2ag</command></term>
    186202        <listitem>
    187           <para>does this .....</para>
     203          <para>
     204            is used to convert any arbitrary XML file into equivalent
     205            <application>AutoGen</application> definitions.
     206          </para>
    188207          <indexterm zone="autogen xml2ag">
    189208            <primary sortas="b-xml2ag">xml2ag</primary>
    … …  
    193212
    194213      <varlistentry id="libopts">
    195         <term><filename class='libraryfile'>libopts.{so,a}</filename></term>
    196         <listitem>
    197           <para>contains functions that .....</para>
     214        <term><filename class='libraryfile'>libopts.so</filename></term>
     215        <listitem>
     216          <para>
     217            is an automated option processing library based on
     218            <application>AutoGen</application>.
     219          </para>
    198220          <indexterm zone="autogen libopts">
    199             <primary sortas="c-libopts">libopts.{so,a}</primary>
     221            <primary sortas="c-libopts">libopts.so</primary>
    200222          </indexterm>
    201223        </listitem>
Note: See TracChangeset for help on using the changeset viewer.