Changeset a42c273 for general/genlib


Ignore:
Timestamp:
05/21/2019 12:39:37 PM (5 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 9.0, 9.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
77deb22e
Parents:
1dbb694f
Message:

First round of remap attributes; the "doc" ones + a few "test". Rewrote some
parts so that doc that can be installed with recommended deps is in main
instructions. Also, move doc instructions in <command> tags to <screen>.

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

Location:
general/genlib
Files:
6 edited

Legend:

Unmodified
Added
Removed

  • general/genlib/gsl.xml

    r1dbb694f ra42c273  
    9999    installed, buid the documentation with:</para>
    100100
    101 <screen><userinput>make html</userinput></screen>
     101<screen remap="doc"><userinput>make html</userinput></screen>
    102102
    103103    <para>
    … …  
    113113    <para>If you built the documentation, install it (as root) with:</para>
    114114
    115 <screen role="root"><userinput>mkdir                   /usr/share/doc/gsl-&gsl-version; &amp;&amp;
     115<screen role="root"
     116        remap="doc"><userinput>mkdir                   /usr/share/doc/gsl-&gsl-version; &amp;&amp;
    116117cp -R doc/_build/html/* /usr/share/doc/gsl-&gsl-version;</userinput></screen>
    117118

  • general/genlib/libassuan.xml

    r1dbb694f ra42c273  
    115115
    116116<screen><userinput>./configure --prefix=/usr &amp;&amp;
    117 make</userinput></screen>
    118 
    119     <para>
    120       If you wish to build documentation, you must have
    121       <xref linkend="texlive"/> installed and issue the following commands:
     117make                      &amp;&amp;
     118
     119make -C doc html                                                       &amp;&amp;
     120makeinfo --html --no-split -o doc/assuan_nochunks.html doc/assuan.texi &amp;&amp;
     121makeinfo --plaintext       -o doc/assuan.txt           doc/assuan.texi
     122</userinput></screen>
     123
     124    <para>
     125      The above commands build the documentation in html and plaintext formats.
     126      If you wish to build alternate formats of the documentation, you must
     127      have <xref linkend="texlive"/> installed and issue the following commands:
    122128    </para>
    123129
    124130<!--<screen><userinput>patch -Np1 -i ../libassuan-&libassuan-version;-fix_doc_build-1.patch &amp;&amp;-->
    125 <screen><userinput>make -C doc pdf ps</userinput></screen>
     131<screen remap="doc"><userinput>make -C doc pdf ps</userinput></screen>
    126132
    127133    <para>
    … …  
    133139    </para>
    134140
    135 <screen role="root"><userinput>make install</userinput></screen>
    136 
    137     <para>
    138       If you built the documentation, install it by running the
    139       following commands as the
     141<screen role="root"><userinput>make install &amp;&amp;
     142
     143install -v -dm755   /usr/share/doc/libassuan-1.8.4/html &amp;&amp;
     144install -v -m644 doc/assuan.html/* \
     145                    /usr/share/doc/libassuan-1.8.4/html &amp;&amp;
     146install -v -m644 doc/assuan_nochunks.html \
     147                    /usr/share/doc/libassuan-1.8.4      &amp;&amp;
     148install -v -m644 doc/assuan.{txt,texi} \
     149                    /usr/share/doc/libassuan-1.8.4</userinput></screen>
     150
     151    <para>
     152      If you built alternate formats of the documentation, install them by
     153      running the following commands as the
    140154      <systemitem class="username">root</systemitem> user:
    141155    </para>
    142156
    143 <screen role="root"><userinput>install -v -dm755 /usr/share/doc/libassuan-&libassuan-version; &amp;&amp;
    144 install -v -m644  doc/assuan.{pdf,ps,dvi} \
     157<screen role="root"
     158        remap="doc"><userinput>install -v -m644  doc/assuan.{pdf,ps,dvi} \
    145159                  /usr/share/doc/libassuan-&libassuan-version;</userinput></screen>
    146160  </sect2>

  • general/genlib/libgcrypt.xml

    r1dbb694f ra42c273  
    103103
    104104<screen><userinput>./configure --prefix=/usr &amp;&amp;
    105 make</userinput></screen>
    106 
    107     <para>
    108       Only <command>info</command> documentation is shipped in the package
    109       tarball. If you wish to build alternate formats of the documentation,
    110       (you must have <xref linkend="texlive"/> installed to build the PDF
    111       and PostScript documentation), then issue the following commands:
    112     </para>
    113 
    114 <screen><userinput>make -C doc pdf ps html &amp;&amp;
     105make                      &amp;&amp;
     106
     107make -C doc html                                                       &amp;&amp;
    115108makeinfo --html --no-split -o doc/gcrypt_nochunks.html doc/gcrypt.texi &amp;&amp;
    116109makeinfo --plaintext       -o doc/gcrypt.txt           doc/gcrypt.texi</userinput></screen>
     110
     111    <para>
     112      The above commands build the documentation in html and plaintext
     113      formats. If you wish to build alternate formats of the documentation, you
     114      need <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>). Issue
     115      the following command:
     116    </para>
     117
     118<screen remap="doc"><userinput>make -C doc pdf ps</userinput></screen>
    117119
    118120    <para>
    … …  
    127129install -v -dm755   /usr/share/doc/libgcrypt-&libgcrypt-version; &amp;&amp;
    128130install -v -m644    README doc/{README.apichanges,fips*,libgcrypt*} \
    129                     /usr/share/doc/libgcrypt-&libgcrypt-version;</userinput></screen>
    130 
    131     <para>
    132       If you built the additional documentation, install it by issuing the
    133       following commands as the <systemitem class="username">root</systemitem>
    134       user:
    135     </para>
    136 
    137 <screen role="root"><userinput>install -v -dm755   /usr/share/doc/libgcrypt-&libgcrypt-version;/html &amp;&amp;
     131                    /usr/share/doc/libgcrypt-&libgcrypt-version; &amp;&amp;
     132
     133install -v -dm755   /usr/share/doc/libgcrypt-&libgcrypt-version;/html &amp;&amp;
    138134install -v -m644 doc/gcrypt.html/* \
    139135                    /usr/share/doc/libgcrypt-&libgcrypt-version;/html &amp;&amp;
    140136install -v -m644 doc/gcrypt_nochunks.html \
    141                     /usr/share/doc/libgcrypt-&libgcrypt-version; &amp;&amp;
    142 install -v -m644 doc/gcrypt.{pdf,ps,dvi,txt,texi} \
     137                    /usr/share/doc/libgcrypt-&libgcrypt-version;      &amp;&amp;
     138install -v -m644 doc/gcrypt.{txt,texi} \
     139                    /usr/share/doc/libgcrypt-&libgcrypt-version;</userinput></screen>
     140
     141    <para>
     142      If you built alternate formats of the documentation, install them by
     143      issuing the following command as the
     144      <systemitem class="username">root</systemitem> user:
     145    </para>
     146
     147<screen role="root"
     148        remap="doc"><userinput>install -v -m644 doc/gcrypt.{pdf,ps,dvi} \
    143149                    /usr/share/doc/libgcrypt-&libgcrypt-version;</userinput></screen>
    144150

  • general/genlib/libical.xml

    r1dbb694f ra42c273  
    117117    </para>
    118118
    119 <screen><userinput>make docs</userinput></screen>
     119<screen remap="doc"><userinput>make docs</userinput></screen>
    120120-->
    121121    <para>
    … …  
    137137    </para>
    138138
    139 <screen role="root"><userinput>install -vdm755 /usr/share/doc/libical-&libical-version;/html &amp;&amp;
     139<screen role="root"
     140        remap="doc"><userinput>install -vdm755 /usr/share/doc/libical-&libical-version;/html &amp;&amp;
    140141cp -vr apidocs/html/* /usr/share/doc/libical-&libical-version;/html</userinput></screen>
    141142-->

  • general/genlib/libusb.xml

    r1dbb694f ra42c273  
    107107    </para>
    108108
    109 <screen><userinput>make -C doc docs</userinput></screen>
     109<screen remap="doc"><userinput>make -C doc docs</userinput></screen>
    110110
    111111    <para>
    … …  
    124124    </para>
    125125
    126 <screen role="root"><userinput>install -v -d -m755 /usr/share/doc/libusb-&libusb-version;/apidocs &amp;&amp;
     126<screen role="root"
     127        remap="doc"><userinput>install -v -d -m755 /usr/share/doc/libusb-&libusb-version;/apidocs &amp;&amp;
    127128install -v -m644    doc/html/* \
    128129                    /usr/share/doc/libusb-&libusb-version;/apidocs</userinput></screen>

  • general/genlib/popt.xml

    r1dbb694f ra42c273  
    7373
    7474    <para>If you have <xref linkend="doxygen"/> installed and wish to build
    75     the API documentation, issue <command>doxygen</command>.</para>
     75    the API documentation, issue:</para>
     76
     77<screen remap="doc"><userinput>doxygen</userinput></screen>
    7678
    7779    <para>To test the results, issue: <command>make check</command>.</para>
    … …  
    8587    user:</para>
    8688
    87 <screen role="root"><userinput>install -v -m755 -d /usr/share/doc/popt-&popt-version; &amp;&amp;
     89<screen role="root"
     90        remap="doc"><userinput>install -v -m755 -d /usr/share/doc/popt-&popt-version; &amp;&amp;
    8891install -v -m644 doxygen/html/* /usr/share/doc/popt-&popt-version;</userinput></screen>
    8992
Note: See TracChangeset for help on using the changeset viewer.