Changeset a42c273


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

Files:
20 edited

Legend:

Unmodified
Added
Removed

  • general.ent

    r1dbb694f ra42c273  
    11<!-- $LastChangedBy$ $Date$ -->
    22
    3 <!ENTITY day          "20">                   <!-- Always 2 digits -->
     3<!ENTITY day          "21">                   <!-- Always 2 digits -->
    44<!ENTITY month        "05">                   <!-- Always 2 digits -->
    55<!ENTITY year         "2019">
    … …  
    77<!ENTITY copyholder   "The BLFS Development Team">
    88<!ENTITY version      "&year;-&month;-&day;">
    9 <!ENTITY releasedate  "May 20th, &year;">
     9<!ENTITY releasedate  "May 21st, &year;">
    1010<!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
    1111<!ENTITY blfs-version "svn">                  <!-- svn|[release #] -->

  • 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

  • general/graphlib/graphite2.xml

    r1dbb694f ra42c273  
    151151    </para>
    152152
    153 <screen><userinput>make docs</userinput></screen>
     153<screen remap="doc"><userinput>make docs</userinput></screen>
    154154
    155155    <para>
    … …  
    168168    </para>
    169169
    170 <screen role="root"><userinput>install -v -d -m755 /usr/share/doc/graphite2-&graphite2-version; &amp;&amp;
     170<screen role="root"
     171        remap="doc"><userinput>install -v -d -m755 /usr/share/doc/graphite2-&graphite2-version; &amp;&amp;
    171172<!-- doc/doxygen seems to have gone, so I removed the api dir, but now both html
    172173and pdf for the GTF and the manual

  • general/prog/doxygen.xml

    r1dbb694f ra42c273  
    150150    </para>
    151151
    152 <screen><userinput>cmake -DDOC_INSTALL_DIR=share/doc/doxygen-&doxygen-version; -Dbuild_doc=ON .. &amp;&amp;
     152<screen remap="doc"><userinput>cmake -DDOC_INSTALL_DIR=share/doc/doxygen-&doxygen-version; -Dbuild_doc=ON .. &amp;&amp;
    153153
    154154make docs</userinput></screen>

  • general/prog/gdb.xml

    r1dbb694f ra42c273  
    120120    </para>
    121121
    122 <screen><userinput>make -C gdb/doc doxy</userinput></screen>
     122<screen remap="doc"><userinput>make -C gdb/doc doxy</userinput></screen>
    123123
    124124    <para>
    … …  
    126126    </para>
    127127
    128 <screen><userinput>pushd gdb/testsuite &amp;&amp;
     128<screen remap="test"><userinput>pushd gdb/testsuite &amp;&amp;
    129129make  site.exp      &amp;&amp;
    130130echo  "set gdb_test_timeout 120" &gt;&gt; site.exp &amp;&amp;
    … …  
    205205    </para>
    206206
    207 <screen role="root"><userinput>install -d /usr/share/doc/gdb-&gdb-version; &amp;&amp;
     207<screen role="root"
     208        remap="doc"><userinput>install -d /usr/share/doc/gdb-&gdb-version; &amp;&amp;
    208209rm -rf gdb/doc/doxy/xml &amp;&amp;
    209210cp -Rv gdb/doc/doxy /usr/share/doc/gdb-&gdb-version;</userinput></screen>

  • general/prog/git.xml

    r1dbb694f ra42c273  
    165165    </para>
    166166
    167 <screen><userinput>make html</userinput></screen>
     167<screen remap="doc"><userinput>make html</userinput></screen>
    168168
    169169    <para>
    … …  
    172172    </para>
    173173
    174 <screen><userinput>make man</userinput></screen>
     174<screen remap="doc"><userinput>make man</userinput></screen>
    175175
    176176    <para>
    … …  
    195195    </para>
    196196
    197 <screen role="root"><userinput>make install-man</userinput></screen>
     197<screen role="root" remap="doc"><userinput>make install-man</userinput></screen>
    198198
    199199    <para>
    … …  
    202202    </para>
    203203
    204 <screen role="root"><userinput>make htmldir=/usr/share/doc/git-&git-version; install-html</userinput></screen>
     204<screen role="root" remap="doc"><userinput>make htmldir=/usr/share/doc/git-&git-version; install-html</userinput></screen>
    205205
    206206<!-- ==== Method 2 for docs ====== -->

  • general/prog/llvm.xml

    r1dbb694f ra42c273  
    211211
    212212    <para>
     213      If you have installed <application>Sphinx</application> and
     214      <application>recommonmark</application> and wish
     215      to generate the html documentation and manual pages, issue the following
     216      commands:
     217    </para>
     218
     219<screen remap="doc"><userinput>cmake -DLLVM_ENABLE_SPHINX=ON         \
     220      -DSPHINX_WARNINGS_AS_ERRORS=OFF \
     221      -Wno-dev -G Ninja ..            &amp;&amp;
     222ninja docs-llvm-html  docs-llvm-man</userinput></screen>
     223
     224    <para>
     225      If you have downloaded the optional packages, the clang documentation
     226      can be built too:
     227    </para>
     228
     229<screen remap="doc"><userinput>ninja docs-clang-html docs-clang-man</userinput></screen>
     230
     231    <para>
    213232      <!-- EDITORS - if you have more than 4 cores, take some offline to measure
    214233      the elapsed time for the tests.  Also, libstdc++.a and perhaps libstdc++fs.a
    … …  
    234253
    235254    <para>
    236       If you have installed <application>Sphinx</application> and
    237       <application>recommonmark</application> and wish
    238       to generate the html documentation and manual pages, issue the following
    239       commands:
    240     </para>
    241 <screen><userinput>cmake -DLLVM_ENABLE_SPHINX=ON         \
    242       -DSPHINX_WARNINGS_AS_ERRORS=OFF \
    243       -Wno-dev -G Ninja ..            &amp;&amp;
    244 ninja docs-llvm-html  docs-llvm-man</userinput></screen>
    245     <para>
    246       If you have downloaded the optional packages, the clang documentation
    247       can be built too:
    248     </para>
    249 <screen><userinput>ninja docs-clang-html docs-clang-man</userinput></screen>
    250 
    251     <para>
    252       Install the llvm documentation by running the following command as the
    253       <systemitem class="username">root</systemitem> user:
    254     </para>
    255 
    256 <screen role="root"><userinput>install -v -m644 docs/man/* /usr/share/man/man1             &amp;&amp;
     255      If you have built the the llvm documentation, install it by running the
     256      following commands as the <systemitem class="username">root</systemitem>
     257      user:
     258    </para>
     259
     260<screen role="root"
     261        remap="doc"><userinput>install -v -m644 docs/man/* /usr/share/man/man1             &amp;&amp;
    257262install -v -d -m755 /usr/share/doc/llvm-&llvm-version;/llvm-html     &amp;&amp;
    258263cp -Rv docs/html/* /usr/share/doc/llvm-&llvm-version;/llvm-html</userinput></screen>
    259264
    260265    <para>
    261       The clang documentation can be installed in the same way (again as the
     266      If you have built the clang documentation, it can be installed in the
     267      same way (again as the
    262268      <systemitem class="username">root</systemitem> user):
    263269    </para>
    264270
    265 <screen role="root"><userinput>install -v -m644 tools/clang/docs/man/* /usr/share/man/man1 &amp;&amp;
     271<screen role="root"
     272        remap="doc"><userinput>install -v -m644 tools/clang/docs/man/* /usr/share/man/man1 &amp;&amp;
    266273install -v -d -m755 /usr/share/doc/llvm-&llvm-version;/clang-html    &amp;&amp;
    267274cp -Rv tools/clang/docs/html/* /usr/share/doc/llvm-&llvm-version;/clang-html</userinput></screen>

  • general/prog/mercurial.xml

    r1dbb694f ra42c273  
    100100    issue:</para>
    101101
    102 <screen><userinput>sed -i '/runrst/s/N)/N)3/' doc/Makefile &amp;&amp;
     102<screen remap="doc"><userinput>sed -i '/runrst/s/N)/N)3/' doc/Makefile &amp;&amp;
    1031032to3-3.7 -w doc/hgmanpage.py            &amp;&amp;
    104104make doc</userinput></screen>
    … …  
    111111    issue:</para>
    112112
    113 <screen><userinput>cat &gt; tests/blacklists/failed-tests &lt;&lt; "EOF"
     113<screen remap="test"><userinput>cat &gt; tests/blacklists/failed-tests &lt;&lt; "EOF"
    114114<literal># Test Failures
    115115  test-gpg.t</literal>
    … …  
    119119      To run the test suite, issue:
    120120    </para>
    121 <screen><userinput>rm -rf tests/tmp &amp;&amp;
     121<screen remap="test"><userinput>rm -rf tests/tmp &amp;&amp;
    122122TESTFLAGS="-j<replaceable>&lt;N&gt;</replaceable> --tmpdir tmp --blacklist blacklists/failed-tests" make check</userinput></screen>
    123123
    … …  
    130130    the tests that failed before:</para>
    131131
    132 <screen><userinput>pushd tests  &amp;&amp;
     132<screen remap="test"><userinput>pushd tests  &amp;&amp;
    133133  rm -rf tmp &amp;&amp;
    134134  ./run-tests.py --tmpdir tmp test-gpg.t
    … …  
    142142    or not. One test, test-https.t, is known to fail.</para>
    143143
    144     <para>An interesting switch is "- -time", which will generate at the end of
     144    <para>An interesting switch is "--time", which will generate at the end of
    145145    the test suite execution, a table with all executed tests and respective
    146146    start, end, user, system and real times. Notice that the switches may be
    … …  
    156156    command (as <systemitem class="username">root</systemitem>):</para>
    157157
    158 <screen role="root"><userinput>make PREFIX=/usr install-doc</userinput></screen>
     158<screen role="root"
     159        remap="doc"><userinput>make PREFIX=/usr install-doc</userinput></screen>
    159160
    160161    <para>After installed, two very quick and simple tests should run correctly.

  • general/sysutils/cpio.xml

    r1dbb694f ra42c273  
    8888    both of the following commands:</para>
    8989
    90 <screen><userinput>make -C doc pdf &amp;&amp;
     90<screen remap="doc"><userinput>make -C doc pdf &amp;&amp;
    9191make -C doc ps</userinput></screen>
    9292
    … …  
    106106    <systemitem class="username">root</systemitem> user:</para>
    107107
    108 <screen role="root"><userinput>install -v -m644 doc/cpio.{pdf,ps,dvi} \
     108<screen role="root"
     109        remap="doc"><userinput>install -v -m644 doc/cpio.{pdf,ps,dvi} \
    109110                 /usr/share/doc/cpio-&cpio-version;</userinput></screen>
    110111

  • multimedia/videoutils/ffmpeg.xml

    r1dbb694f ra42c273  
    194194<!-- sed -i '$s/$/\n\n@bye/' doc/{git-howto,nut,fate}.texi             &amp;&amp;
    195195sed -i '/machine:i386/ s/\\/@backslashchar{}/g' doc/platform.texi &amp;&amp; -->
    196 <screen><userinput>pushd doc &amp;&amp;
     196<screen remap="doc"><userinput>pushd doc &amp;&amp;
    197197for DOCNAME in `basename -s .html *.html`
    198198do
    … …  
    209209      If you have <xref linkend="doxygen"/> installed
    210210      and you wish to build (if --disable-doc was
    211       used) or rebuild the html documentation, issue the command
    212       <command>doxygen doc/Doxyfile</command>.
    213     </para>
     211      used) or rebuild the html documentation, issue:
     212    </para>
     213
     214<screen remap="doc"><userinput>doxygen doc/Doxyfile</userinput></screen>
    214215
    215216    <para>
    … …  
    235236    </para>
    236237
    237 <screen role="root"><userinput>install -v -m644 doc/*.pdf /usr/share/doc/ffmpeg-&ffmpeg-version; &amp;&amp;
     238<screen role="root"
     239        remap="doc"><userinput>install -v -m644 doc/*.pdf /usr/share/doc/ffmpeg-&ffmpeg-version; &amp;&amp;
    238240install -v -m644 doc/*.ps  /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
    239241
    … …  
    244246    </para>
    245247
    246 <screen role="root"><userinput>install -v -m755 -d /usr/share/doc/ffmpeg-&ffmpeg-version;/api                     &amp;&amp;
     248<screen role="root"
     249        remap="doc"><userinput>install -v -m755 -d /usr/share/doc/ffmpeg-&ffmpeg-version;/api                     &amp;&amp;
    247250cp -vr doc/doxy/html/* /usr/share/doc/ffmpeg-&ffmpeg-version;/api                  &amp;&amp;
    248251find /usr/share/doc/ffmpeg-&ffmpeg-version;/api -type f -exec chmod -c 0644 \{} \; &amp;&amp;
    … …  
    257260    </para>
    258261
    259 <screen><userinput>make fate-rsync SAMPLES=fate-suite/</userinput></screen>
     262<screen remap="test"><userinput>make fate-rsync SAMPLES=fate-suite/</userinput></screen>
    260263
    261264    <para>
    … …  
    274277    </para>
    275278
    276 <screen><userinput><command>rsync -vrltLW  --delete --timeout=60 --contimeout=60 \
     279<screen role="nodump"><userinput><command>rsync -vrltLW  --delete --timeout=60 --contimeout=60 \
    277280      rsync://fate-suite.ffmpeg.org/fate-suite/ fate-suite/</command></userinput></screen>
    278281
    … …  
    282285    </para>
    283286
    284 <screen><userinput>make fate THREADS=<replaceable>N</replaceable> SAMPLES=fate-suite/ | tee ../fate.log &amp;&amp;
     287<screen remap="test"><userinput>make fate THREADS=<replaceable>N</replaceable> SAMPLES=fate-suite/ | tee ../fate.log &amp;&amp;
    285288grep ^TEST ../fate.log | wc -l</userinput></screen>
    286289

  • networking/netlibs/libevent.xml

    r1dbb694f ra42c273  
    107107    <para>
    108108      If you have <xref linkend="doxygen"/> installed and wish to build API
    109       documentation, issue <command>doxygen Doxyfile</command>.
    110     </para>
     109      documentation, issue :
     110    </para>
     111
     112<screen remap="doc"><userinput>doxygen Doxyfile</userinput></screen>
    111113
    112114    <para>
    … …  
    125127    </para>
    126128
    127 <screen role="root"><userinput>install -v -m755 -d /usr/share/doc/libevent-&libevent-version;/api &amp;&amp;
     129<screen role="root"
     130        remap="doc"><userinput>install -v -m755 -d /usr/share/doc/libevent-&libevent-version;/api &amp;&amp;
    128131cp      -v -R       doxygen/html/* \
    129132                    /usr/share/doc/libevent-&libevent-version;/api</userinput></screen>

  • networking/netprogs/rsync.xml

    r1dbb694f ra42c273  
    9191
    9292    <para>If you have <xref linkend="doxygen"/> installed and wish to
    93     build HTML API documentation, issue <command>doxygen</command>.</para>
     93    build HTML API documentation, issue:</para>
     94
     95<screen remap="doc"><userinput>doxygen</userinput></screen>
    9496
    9597    <para>To test the results, issue: <command>make check</command>.</para>
    … …  
    102104    commands as the <systemitem class="username">root</systemitem> user:</para>
    103105
    104 <screen role='root'><userinput>install -v -m755 -d          /usr/share/doc/rsync-&rsync-version;/api &amp;&amp;
     106<screen role='root'
     107        remap="doc"><userinput>install -v -m755 -d          /usr/share/doc/rsync-&rsync-version;/api &amp;&amp;
    105108install -v -m644 dox/html/*  /usr/share/doc/rsync-&rsync-version;/api</userinput></screen>
    106109
    … …  
    202205        <systemitem class="username">root</systemitem> user:</para>
    203206
    204 <screen role="root"><userinput>systemctl stop rsyncd &amp;&amp;
     207<screen role="nodump"><userinput>systemctl stop rsyncd &amp;&amp;
    205208systemctl disable rsyncd &amp;&amp;
    206209systemctl enable rsyncd.socket &amp;&amp;

  • postlfs/security/gnupg2.xml

    r1dbb694f ra42c273  
    132132
    133133makeinfo --html --no-split -o doc/gnupg_nochunks.html doc/gnupg.texi &amp;&amp;
    134 makeinfo --plaintext       -o doc/gnupg.txt           doc/gnupg.texi</userinput></screen>
     134makeinfo --plaintext       -o doc/gnupg.txt           doc/gnupg.texi &amp;&amp;
     135make -C doc html</userinput></screen>
    135136
    136137    <para>If you have <xref linkend="texlive"/>
    … …  
    140141    the ps format):</para>
    141142
    142 <screen><userinput>make -C doc pdf ps html</userinput></screen>
     143<screen remap="doc"><userinput>make -C doc pdf ps</userinput></screen>
    143144
    144145    <para>To test the results, issue: <command>make check</command>.</para>
    … …  
    155156                    /usr/share/doc/gnupg-&gnupg2-version;/html/gnupg.html &amp;&amp;
    156157install -v -m644    doc/*.texi doc/gnupg.txt \
    157                     /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen>
     158                    /usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
     159install -v -m644    doc/gnupg.html/* \
     160                    /usr/share/doc/gnupg-&gnupg2-version;/html</userinput></screen>
    158161<!-- Now intalls as gpg, not gpg2.  This should be no longer needed.
    159162    <para>The BLFS editors recommend the creation of symlinks for compatibility
    … …  
    168171unset f</userinput></screen>
    169172-->
    170     <para>If you created alternate formats of the documentation, install it
     173    <para>If you created alternate formats of the documentation, install them
    171174    using the following command as the
    172175    <systemitem class="username">root</systemitem> user:</para>
    173176
    174 <screen role="root"><userinput>install -v -m644 doc/gnupg.html/* \
    175                  /usr/share/doc/gnupg-&gnupg2-version;/html &amp;&amp;
    176 install -v -m644 doc/gnupg.{pdf,dvi,ps} \
     177<screen role="root"
     178        remap="doc"><userinput>install -v -m644 doc/gnupg.{pdf,dvi,ps} \
    177179                 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen>
    178180

  • postlfs/security/liboauth.xml

    r1dbb694f ra42c273  
    119119
    120120    <para>
    121       If you have installed <xref linkend="doxygen"/>, issue
    122       <command>make dox</command> to build the documentation.
    123     </para>
     121      If you wish to build the documentation (needs <xref linkend="doxygen"/>),
     122      issue:
     123    </para>
     124
     125<screen remap="doc"><userinput>make dox</userinput></screen>
    124126
    125127    <para>
    … …  
    139141    </para>
    140142
    141 <screen role="root"><userinput>install -v -dm755 /usr/share/doc/liboauth-&liboauth-version; &amp;&amp;
     143<screen role="root"
     144        remap="doc"><userinput>install -v -dm755 /usr/share/doc/liboauth-&liboauth-version; &amp;&amp;
    142145cp -rv doc/html/* /usr/share/doc/liboauth-&liboauth-version;</userinput></screen>
    143146

  • x/installing/libinput.xml

    r1dbb694f ra42c273  
    129129      during the testsuite from interfering with your desktop.  Copy the
    130130      file <filename>test/50-litest.conf</filename> into
    131       <filename class="directory"> ${XORG_PREFIX}/share/X11/xorg.conf.d</filename>
     131      <filename class="directory">${XORG_PREFIX}/share/X11/xorg.conf.d</filename>
    132132      and restart X. For further information see
    133133      <ulink url="https://wayland.freedesktop.org/libinput/doc/&libinput-version;/test-suite.html">libinput test suite</ulink>.
    … …  
    187187    </para>
    188188
    189 <screen role="root"><userinput>install -v -dm755      /usr/share/doc/libinput-&libinput-version;/{html,api} &amp;&amp;
     189<screen role="root"
     190        remap="doc"><userinput>install -v -dm755      /usr/share/doc/libinput-&libinput-version;/{html,api} &amp;&amp;
    190191cp -rv Documentation/* /usr/share/doc/libinput-&libinput-version;/html &amp;&amp;
    191192cp -rv api/*           /usr/share/doc/libinput-&libinput-version;/api</userinput></screen>
Note: See TracChangeset for help on using the changeset viewer.