Ignore:
Timestamp:
03/24/2020 07:19:44 PM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.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:
fa3edfef
Parents:
914049f6
Message:

Format postlfs/security and misc/forgotten

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • pst/sgml/docbook-dsssl.xml

    r914049f6 r47274444  
    44  <!ENTITY % general-entities SYSTEM "../../general.ent">
    55  %general-entities;
    6 
    7     <!-- Inserted as a reminder to do this. The mention of a test suite
    8          is usually right before the root user installation commands. Please
    9          delete these 12 (including one blank) lines after you are done.-->
    10 
    11     <!-- Use one of the two mentions below about a test suite,
    12          delete the line that is not applicable. Of course, if the
    13          test suite uses syntax other than "make check", revise the
    14          line to reflect the actual syntax to run the test suite -->
    15 
    16     <!-- <para>This package does not come with a test suite.</para> -->
    17     <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
    186
    197  <!ENTITY docbook-dsssl-download-http "&sourceforge-dl;/docbook/docbook-dsssl-&docbook-dsssl-version;.tar.bz2">
    … …  
    4836    <title>Introduction to DocBook DSSSL Stylesheets</title>
    4937
    50     <para>The <application>DocBook DSSSL Stylesheets</application> package
    51     contains DSSSL stylesheets. These are used by
    52     <application>OpenJade</application> or other tools to transform SGML
    53     and XML DocBook files.</para>
     38    <para>
     39      The <application>DocBook DSSSL Stylesheets</application> package
     40      contains DSSSL stylesheets. These are used by
     41      <application>OpenJade</application> or other tools to transform SGML
     42      and XML DocBook files.
     43    </para>
    5444
    5545    &lfs91_checked;
    … …  
    5848    <itemizedlist spacing="compact">
    5949      <listitem>
    60         <para>Download (HTTP): <ulink url="&docbook-dsssl-download-http;"/></para>
    61       </listitem>
    62       <listitem>
    63         <para>Download (FTP): <ulink url="&docbook-dsssl-download-ftp;"/></para>
    64       </listitem>
    65       <listitem>
    66         <para>Download MD5 sum: &docbook-dsssl-md5sum;</para>
    67       </listitem>
    68       <listitem>
    69         <para>Download size: &docbook-dsssl-size;</para>
    70       </listitem>
    71       <listitem>
    72         <para>Estimated disk space required: &docbook-dsssl-buildsize;</para>
    73       </listitem>
    74       <listitem>
    75         <para>Estimated build time: &docbook-dsssl-time;</para>
     50        <para>
     51          Download (HTTP): <ulink url="&docbook-dsssl-download-http;"/>
     52        </para>
     53      </listitem>
     54      <listitem>
     55        <para>
     56          Download (FTP): <ulink url="&docbook-dsssl-download-ftp;"/>
     57        </para>
     58      </listitem>
     59      <listitem>
     60        <para>
     61          Download MD5 sum: &docbook-dsssl-md5sum;
     62        </para>
     63      </listitem>
     64      <listitem>
     65        <para>
     66          Download size: &docbook-dsssl-size;
     67        </para>
     68      </listitem>
     69      <listitem>
     70        <para>
     71          Estimated disk space required: &docbook-dsssl-buildsize;
     72        </para>
     73      </listitem>
     74      <listitem>
     75        <para>
     76          Estimated build time: &docbook-dsssl-time;
     77        </para>
    7678      </listitem>
    7779    </itemizedlist>
    … …  
    8284
    8385      <listitem>
    84         <para>Download (HTTP):
    85         <ulink url="&docbook-dsssl-doc-download-http;"/></para></listitem>
    86       <listitem>
    87         <para>Download MD5 sum: &docbook-dsssl-doc-md5sum;</para>
    88       </listitem>
    89       <listitem>
    90         <para>Download size: &docbook-dsssl-doc-size;</para>
     86        <para>
     87          Download (HTTP):
     88          <ulink url="&docbook-dsssl-doc-download-http;"/>
     89        </para>
     90      </listitem>
     91      <listitem>
     92        <para>
     93          Download MD5 sum: &docbook-dsssl-doc-md5sum;
     94        </para>
     95      </listitem>
     96      <listitem>
     97        <para>
     98          Download size: &docbook-dsssl-doc-size;
     99        </para>
    91100      </listitem>
    92101    </itemizedlist>
    … …  
    96105
    97106    <bridgehead renderas="sect4">Required</bridgehead>
    98     <para role="required"><xref linkend="sgml-common"/></para>
     107    <para role="required">
     108      <xref linkend="sgml-common"/>
     109    </para>
    99110
    100111    <bridgehead renderas="sect4">Required (to Test the DocBook SGML
    101     Toolchain)</bridgehead>
    102     <para role="required"><xref linkend="sgml-dtd-3"/>,
    103     <xref linkend="sgml-dtd"/>,
    104     <xref linkend="opensp"/> and
    105     <xref linkend="openjade"/></para>
     112      Toolchain)</bridgehead>
     113    <para role="required">
     114      <xref linkend="sgml-dtd-3"/>,
     115      <xref linkend="sgml-dtd"/>,
     116      <xref linkend="opensp"/>, and
     117      <xref linkend="openjade"/>
     118    </para>
    106119
    107120    <para condition="html" role="usernotes">User Notes:
    … …  
    113126    <title>Installation of DocBook DSSSL Stylesheets</title>
    114127
    115     <para>If you downloaded the documentation, run:</para>
     128    <para>
     129      If you downloaded the documentation, run:
     130    </para>
    116131
    117132<screen><userinput>tar -xf ../docbook-dsssl-doc-1.79.tar.bz2 --strip-components=1</userinput></screen>
    118133
    119     <para>Install <application>DocBook DSSSL Stylesheets</application> by running
    120     the following commands as the <systemitem class="username">root</systemitem>
    121     user:</para>
     134    <para>
     135      Install <application>DocBook DSSSL Stylesheets</application> by running
     136      the following commands as the <systemitem
     137      class="username">root</systemitem> user:
     138    </para>
    122139
    123140<screen role="root"><userinput>install -v -m755 bin/collateindex.pl /usr/bin                      &amp;&amp;
    … …  
    140157    <title>Command Explanations</title>
    141158
    142     <para>The above commands create an installation script for this
    143     package.</para>
     159    <para>
     160      The above commands create an installation script for this package.
     161    </para>
    144162
    145163  </sect2>
    … …  
    148166    <title>Testing the DocBook SGML Toolchain (Optional)</title>
    149167
    150     <para>The following commands will perform the necessary tests to confirm
    151     that your installed DocBook SGML toolchain will produce desired results.
    152     You must have the <xref linkend="sgml-dtd-3"/>, <xref linkend="sgml-dtd"/>,
    153     <xref linkend="opensp"/> and <xref linkend="openjade"/> packages installed
    154     and perform the tests as the
    155     <systemitem class="username">root</systemitem> user.</para>
    156 
    157     <para>All tests will be performed from the <filename class='directory'>
    158     /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/doc/testdata</filename>
    159     directory as the <systemitem class="username">root</systemitem> user:</para>
     168    <para>
     169      The following commands will perform the necessary tests to confirm
     170      that your installed DocBook SGML toolchain will produce desired results.
     171      You must have the <xref linkend="sgml-dtd-3"/>,
     172      <xref linkend="sgml-dtd"/>, <xref linkend="opensp"/>,
     173      and <xref linkend="openjade"/> packages installed,
     174      and perform the tests as the
     175      <systemitem class="username">root</systemitem> user.
     176    </para>
     177
     178    <para>
     179      All tests will be performed from the <filename class='directory'>
     180      /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/doc/testdata
     181      </filename>
     182      directory as the <systemitem class="username">root</systemitem> user:
     183    </para>
    160184
    161185<screen role="root"><userinput>cd /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/doc/testdata</userinput></screen>
    162186
    163     <para>The first test should produce no output to stdout (your screen) and
    164     create a file named <filename>jtest.rtf</filename> in the current
    165     directory:</para>
     187    <para>
     188      The first test should produce no output to stdout (your screen) and
     189      create a file named <filename>jtest.rtf</filename> in the current
     190      directory:
     191    </para>
    166192
    167193<screen role="root"><userinput>openjade -t rtf -d jtest.dsl jtest.sgm</userinput></screen>
    168194
    169     <para>The next test should return only the following line to stdout:
    170     <computeroutput>onsgmls:I: "OpenSP" version "&opensp-version;"</computeroutput></para>
     195    <para>
     196      The next test should return only the following line to stdout:
     197      <computeroutput>onsgmls:I: "OpenSP" version "&opensp-version;"</computeroutput>
     198    </para>
    171199
    172200<screen role="root"><userinput>onsgmls -sv test.sgm</userinput></screen>
    173201
    174     <para>The next test should produce no output to stdout and create a file
    175     named <filename>test.rtf</filename> in the current directory:</para>
     202    <para>
     203      The next test should produce no output to stdout and create a file
     204      named <filename>test.rtf</filename> in the current directory:
     205    </para>
    176206
    177207<screen role="root"><userinput>openjade -t rtf \
    … …  
    179209    test.sgm</userinput></screen>
    180210
    181     <para>The last test should produce no output to stdout and create a file
    182     named <filename>c1.htm</filename> in the current directory:</para>
     211    <para>
     212      The last test should produce no output to stdout and create a file
     213      named <filename>c1.htm</filename> in the current directory:
     214    </para>
    183215
    184216<screen role="root"><userinput>openjade -t sgml \
    … …  
    186218    test.sgm</userinput></screen>
    187219
    188     <para>Finally, clean up:</para>
     220    <para>
     221      Finally, clean up:
     222    </para>
    189223
    190224<screen role="root"><userinput>rm jtest.rtf test.rtf c1.htm</userinput></screen>
    … …  
    217251        <term><command>collateindex.pl</command></term>
    218252        <listitem>
    219           <para>is a <application>Perl</application> script that creates a
    220           DocBook index from raw index data.</para>
     253          <para>
     254            is a <application>Perl</application> script that creates a
     255            DocBook index from raw index data.
     256          </para>
    221257          <indexterm zone="docbook-dsssl collateindex.pl">
    222258            <primary sortas="b-collateindex.pl">collateindex.pl</primary>
Note: See TracChangeset for help on using the changeset viewer.