Changeset fa3edfef for pst/typesetting


Ignore:
Timestamp:
03/25/2020 12:06:24 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:
81a73ed8
Parents:
47274444
Message:

Format pst

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

Location:
pst/typesetting
Files:
7 edited

Legend:

Unmodified
Added
Removed

  • pst/typesetting/asymptote.xml

    r47274444 rfa3edfef  
    159159     href="../../xincludes/tex-prefix.xml"/>
    160160
    161     <para><parameter>--libdir=/opt/texlive/&texlive-year;/texmf-dist;</parameter>:
    162     This parameter ensures that the <filename class="directory">asymptote</filename>
    163     directory will similarly overwrite any files installed by install-tl-unx.</para>
    164 
    165     <para><parameter>--enable-gc=system</parameter>: this ensures that the system
    166     version of <filename class="libraryfile">libgc.so</filename> will be used
    167     instead of the version shipped with this package.</para>
    168 
    169     <para><parameter>--with-latex= ... --with-context=</parameter>: These switches
    170     ensure that style files and a tex file will be installed into the
    171     <application>texlive</application> directories instead of creating a
    172     <filename class="directory">texmf-local</filename> directory for them.</para>
     161    <para>
     162      <parameter>--libdir=/opt/texlive/&texlive-year;/texmf-dist;</parameter>:
     163      This parameter ensures that the <filename
     164      class="directory">asymptote</filename> directory will similarly
     165      overwrite any files installed by install-tl-unx.
     166    </para>
     167
     168    <para>
     169      <parameter>--enable-gc=system</parameter>: this ensures that the system
     170      version of <filename class="libraryfile">libgc.so</filename> will be used
     171      instead of the version shipped with this package.
     172    </para>
     173
     174    <para>
     175      <parameter>--with-latex= ... --with-context=</parameter>: These switches
     176      ensure that style files and a tex file will be installed into the
     177      <application>texlive</application> directories instead of creating a
     178      <filename class="directory">texmf-local</filename> directory for them.
     179    </para>
    173180
    174181    <!-- commenting for now: 2.44 installs asymptote.info in both places

  • pst/typesetting/biber.xml

    r47274444 rfa3edfef  
    4747    <title>Introduction to biber</title>
    4848
    49     <para>Biber is a BibTeX replacement for users of biblatex, written in
    50     <application>Perl</application>, with full Unicode support.</para>
     49    <para>
     50      Biber is a BibTeX replacement for users of biblatex, written in
     51      <application>Perl</application>, with full Unicode support.
     52    </para>
    5153
    5254    &lfs91_checked;
    … …  
    7274    <itemizedlist spacing="compact">
    7375      <listitem>
    74         <para>Download (HTTP): <ulink url="&biber-download-http;"/></para>
    75       </listitem>
    76       <listitem>
    77         <para>Download (FTP): <ulink url="&biber-download-ftp;"/></para>
    78       </listitem>
    79       <listitem>
    80         <para>Download MD5 sum: &biber-md5sum;</para>
    81       </listitem>
    82       <listitem>
    83         <para>Download size: &biber-size;</para>
    84       </listitem>
    85       <listitem>
    86         <para>Estimated disk space required: &biber-buildsize;</para>
    87       </listitem>
    88       <listitem>
    89         <para>Estimated build time: &biber-time;</para>
     76        <para>
     77          Download (HTTP): <ulink url="&biber-download-http;"/>
     78        </para>
     79      </listitem>
     80      <listitem>
     81        <para>
     82          Download (FTP): <ulink url="&biber-download-ftp;"/>
     83        </para>
     84      </listitem>
     85      <listitem>
     86        <para>
     87          Download MD5 sum: &biber-md5sum;
     88        </para>
     89      </listitem>
     90      <listitem>
     91        <para>
     92          Download size: &biber-size;
     93        </para>
     94      </listitem>
     95      <listitem>
     96        <para>
     97          Estimated disk space required: &biber-buildsize;
     98        </para>
     99      </listitem>
     100      <listitem>
     101        <para>
     102          Estimated build time: &biber-time;
     103        </para>
    90104      </listitem>
    91105    </itemizedlist>
    … …  
    106120-->
    107121      <para>
    108        If you have updated to a new release of texlive-source, biber and its
    109        perl dependencies are still in present in <filename
    110        class="directory">/usr</filename> and do not need to be rebuilt. However,
    111        biblatex installs in <filename
    112        class="directory">/opt/texlive/&texlive-year;</filename> and does need to
    113        be reinstalled.
     122        If you have updated to a new release of texlive-source, biber and its
     123        perl dependencies are still in present in <filename
     124        class="directory">/usr</filename> and do not need to be rebuilt.
     125        However, biblatex installs in <filename
     126        class="directory">/opt/texlive/&texlive-year;</filename> and does
     127        need to be reinstalled.
    114128      </para>
    115129
    116130      <para>
    117       This version of biber requires <application>perl-5.30</application> or later.
    118       If you are still using the 8.4 version of BLFS you may wish to build the
    119       2.13 version: see the 8.4 book noting that biblatex-3.13 has been replaced by
    120       biblatex-3.13a upstream.
     131        This version of biber requires <application>perl-5.30</application>
     132        or later.  If you are still using the 8.4 version of BLFS you may
     133        wish to build the 2.13 version: see the 8.4 book noting that
     134        biblatex-3.13 has been replaced by biblatex-3.13a upstream.
    121135      </para>
    122136    </note>
    … …  
    126140    <itemizedlist spacing="compact">
    127141      <listitem>
    128       <para>The corresponding version of <application>biblatex</application> is
    129       a separate project - the tds tarball is pre-packaged for untarring into
    130       the <filename class="directory">texmf-dist</filename> directory.
    131       Download (HTTP): <ulink url="&biblatex-download-http;"/></para>
    132       </listitem>
    133       <listitem>
    134         <para>Download MD5 sum: &biblatex-md5sum;</para>
    135       </listitem>
    136       <listitem>
    137         <para>Download size: &biblatex-size;</para>
     142        <para>
     143          The corresponding version of <application>biblatex</application> is
     144          a separate project - the tds tarball is pre-packaged for untarring
     145          into the <filename class="directory">texmf-dist</filename>
     146          directory. Download (HTTP): <ulink url="&biblatex-download-http;"/>
     147        </para>
     148      </listitem>
     149      <listitem>
     150        <para>
     151          Download MD5 sum: &biblatex-md5sum;
     152        </para>
     153      </listitem>
     154      <listitem>
     155        <para>
     156          Download size: &biblatex-size;
     157        </para>
    138158      </listitem>
    139159    </itemizedlist>
    … …  
    195215      <xref linkend="texlive"/>
    196216      (or <xref linkend="tl-installer"/>, but for that you can use
    197        <command>tlmgr update </command>)
     217       <command>tlmgr update</command>)
    198218    </para>
    199219
    … …  
    208228        It is possible to install all missing dependencies automatically. You
    209229        must first install <xref linkend="perl-module-build"/> using <xref
    210         linkend="perl-auto-install"/>. then run <command>perl ./Build.PL</command>
    211         and when it prompts you, become the root user and run
    212         <command>./Build installdeps</command>
     230        linkend="perl-auto-install"/>. Then run <command>perl
     231        ./Build.PL</command> and when it prompts you, become the root user
     232        and run <command>./Build installdeps</command>
    213233      </para>
    214234    </note>
    … …  
    222242    <title>Installation of Biber</title>
    223243
    224     <para>Install <application>Biber</application> by running the following
    225     commands:</para>
     244    <para>
     245      Install <application>Biber</application> by running the following
     246      commands:
     247    </para>
    226248
    227249<screen><userinput>perl ./Build.PL &amp;&amp;
    228250./Build</userinput></screen>
    229251
    230     <para>To test the results, enter: <command>./Build test</command></para>
    231 
    232     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     252    <para>
     253      To test the results, enter: <command>./Build test</command>
     254    </para>
     255
     256    <para>
     257      Now, as the <systemitem class="username">root</systemitem> user:
     258    </para>
    233259
    234260<screen role="root"><userinput>tar -xf ../biblatex-&biblatex-version;.tds.tgz -C /opt/texlive/&texlive-year;/texmf-dist &amp;&amp;
    … …  
    278304        <term><command>biber</command></term>
    279305        <listitem>
    280           <para>is used for producing bibliographies in LaTeX documents.</para>
     306          <para>
     307            is used for producing bibliographies in LaTeX documents.
     308          </para>
    281309          <indexterm zone="biber biber-prog">
    282310            <primary sortas="b-biber">biber</primary>

  • pst/typesetting/tex-path.xml

    r47274444 rfa3edfef  
    1616  <title>Setting the PATH for TeX Live</title>
    1717
    18     <para>Before starting to build TeX Live, set up your PATH so
     18  <para>
     19    Before starting to build TeX Live, set up your PATH so
    1920    that the system can properly find the files.  If you set up your login
    2021    scripts as recommended in <xref linkend='postlfs-config-profile'/>, update
    … …  
    2324    installed in an &lt;ARCH&gt;-linux subdirectory and on 32-bit x86 this is
    2425    always i386-linux. For x86_64 and i?86 we can generate this as $TEXARCH:
    25     </para>
     26  </para>
    2627
    2728<!-- EOF should NOT be in double quotes, we want it to evaluate $TEXARCH -->
    … …  
    4344unset TEXARCH</userinput></screen>
    4445
    45     <!-- commented, they have been removed
    46     <note><para>The standard MANPATH and INFOPATH path are specified above to
    47     ensure they are included.  If they are already set in the boot script
    48     procedure, the pathappend function will ensure duplicates are
    49     removed, so including them here will do no harm.</para></note> -->
    5046
    51     <para>The new paths can be immediately activated by running <command>source
    52     /etc/profile</command>.</para>
     47  <note>
     48    <para>
     49      The standard MANPATH and INFOPATH path are specified above to
     50      ensure they are included.  If they are already set in the boot script
     51      procedure, the pathappend function will ensure duplicates are
     52      removed, so including them here will do no harm.
     53    </para>
     54  </note>
    5355
    54     <para>You should now proceed either to <xref linkend="tl-installer"/> for
     56  <para>
     57    The new paths can be immediately activated by running <command>source
     58    /etc/profile</command>.
     59  </para>
     60
     61  <para>
     62    You should now proceed either to <xref linkend="tl-installer"/> for
    5563    a binary installation of texlive, or to <xref linkend="texlive"/> to begin
    56     installing from source.</para>
     64    installing from source.
     65  </para>
    5766
    5867</sect1>

  • pst/typesetting/texlive.xml

    r47274444 rfa3edfef  
    3838    <title>Introduction to TeX Live from source</title>
    3939
    40     <para>Most of TeX Live can be built from source without a pre-existing
    41     installation, but <application>xindy</application> (for indexing) needs
    42     working versions of <command>latex</command> and <command>pdflatex</command>
    43     when configure is run, and the testsuite and install for
    44     <command>asy</command> (for vector graphics) will fail if TeX has not
    45     already been installed. Additionally, <application>biber</application> is
    46     not provided within the <application>texlive</application> source.</para>
    47 
    48     <para>All of those packages are dealt with on their own pages and can be
    49     built after installing this package. If you have not already done so, you
    50     should start at <xref linkend="tex-path"/> so that the final commands to
    51     initialise the new installation will be found.</para>
     40    <para>
     41      Most of TeX Live can be built from source without a pre-existing
     42      installation, but <application>xindy</application> (for indexing) needs
     43      working versions of <command>latex</command> and
     44      <command>pdflatex</command> when configure is run, and the testsuite
     45      and install for <command>asy</command> (for vector graphics) will fail
     46      if TeX has not already been installed. Additionally,
     47      <application>biber</application> is not provided within the
     48      <application>texlive</application> source.
     49    </para>
     50
     51    <para>
     52      All of those packages are dealt with on their own pages and can be
     53      built after installing this package. If you have not already done so, you
     54      should start at <xref linkend="tex-path"/> so that the final commands to
     55      initialise the new installation will be found.
     56    </para>
    5257
    5358    &lfs91_checked;
    … …  
    5661    <itemizedlist spacing="compact">
    5762      <listitem>
    58         <para>Download (HTTP): <ulink url="&texlive-download-http;"/></para>
    59       </listitem>
    60       <listitem>
    61         <para>Download (FTP): <ulink url="&texlive-download-ftp;"/></para>
    62       </listitem>
    63       <listitem>
    64         <para>Download MD5 sum: &texlive-md5sum;</para>
    65       </listitem>
    66       <listitem>
    67         <para>Download size: &texlive-size;</para>
    68       </listitem>
    69       <listitem>
    70         <para>Estimated disk space required: &texlive-buildsize;</para>
    71       </listitem>
    72       <listitem>
    73         <para>Estimated build time: &texlive-time;</para>
     63        <para>
     64          Download (HTTP): <ulink url="&texlive-download-http;"/>
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Download (FTP): <ulink url="&texlive-download-ftp;"/>
     70        </para>
     71      </listitem>
     72      <listitem>
     73        <para>
     74          Download MD5 sum: &texlive-md5sum;
     75        </para>
     76      </listitem>
     77      <listitem>
     78        <para>
     79          Download size: &texlive-size;
     80        </para>
     81      </listitem>
     82      <listitem>
     83        <para>
     84          Estimated disk space required: &texlive-buildsize;
     85        </para>
     86      </listitem>
     87      <listitem>
     88        <para>
     89          Estimated build time: &texlive-time;
     90        </para>
    7491      </listitem>
    7592    </itemizedlist>
    … …  
    7794    <bridgehead renderas="sect3">Required Additional Downloads</bridgehead>
    7895
    79       <para>Much of the texlive environment (including scripts, documentation,
    80       fonts and various other files) is not part of the source tarball. You must
    81       download it separately. This will give you all of the additional files
    82       which are provided by a full install of the binary version, there is no
    83       realistic way to restrict which parts get installed.</para>
     96      <para>
     97        Much of the texlive environment (including scripts, documentation,
     98        fonts, and various other files) is not part of the source tarball.
     99        You must download it separately. This will give you all of the
     100        additional files which are provided by a full install of the binary
     101        version, there is no realistic way to restrict which parts get
     102        installed.
     103      </para>
    84104
    85105      <para>
    … …  
    91111    <itemizedlist spacing="compact">
    92112      <listitem>
    93         <para>Download (HTTP): <ulink url="&texlive-texmf-download-http;"/></para>
    94       </listitem>
    95       <listitem>
    96         <para>Download (FTP): <ulink url="&texlive-texmf-download-ftp;"/></para>
    97       </listitem>
    98       <listitem>
    99         <para>Download MD5 sum: &texlive-texmf-md5sum;</para>
    100       </listitem>
    101       <listitem>
    102         <para>Download size: &texlive-texmf-size;</para>
    103       </listitem>
    104       <listitem>
    105         <para>Required patch: <ulink
    106         url="&patch-root;/texlive-&texlive-version;-source-upstream_fixes-1.patch"/></para>
     113        <para>
     114          Download (HTTP): <ulink url="&texlive-texmf-download-http;"/>
     115        </para>
     116      </listitem>
     117      <listitem>
     118        <para>
     119          Download (FTP): <ulink url="&texlive-texmf-download-ftp;"/>
     120        </para>
     121      </listitem>
     122      <listitem>
     123        <para>
     124          Download MD5 sum: &texlive-texmf-md5sum;
     125        </para>
     126      </listitem>
     127      <listitem>
     128        <para>
     129          Download size: &texlive-texmf-size;
     130        </para>
     131      </listitem>
     132      <listitem>
     133        <para>
     134          Required patch: <ulink url=
     135          "&patch-root;/texlive-&texlive-version;-source-upstream_fixes-1.patch"/>
     136        </para>
    107137      </listitem>
    108138    </itemizedlist>
    … …  
    114144      <xref linkend="gs"/> <emphasis>including
    115145      <filename>libgs.so</filename></emphasis>, <!--(for dvisvgm, which is used by e.g.
    116       <xref role="nodep" linkend="asymptote"/>), : still referenced for dynamic loading,
     146      <xref role="nodep" linkend="asymptote"/>); still referenced for dynamic loading,
    117147      even without dvisvgm - e.fg. by dvipsk -->
    118148      <xref linkend="x-window-system"/>
    … …  
    152182    </para>
    153183
    154     <para>The shared libraries will be installed into a texlive directory.
    155     As the <systemitem class="username">root</systemitem> user, add it to
    156     your <filename>/etc/ld.so.conf</filename>:</para>
     184    <para>
     185      The shared libraries will be installed into a texlive directory.
     186      As the <systemitem class="username">root</systemitem> user, add it to
     187      your <filename>/etc/ld.so.conf</filename>:
     188    </para>
    157189
    158190<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; EOF
    … …  
    171203      </para>
    172204
    173 <!--
    174       <para>
    175         If you came here to update an old system (because of the recent
    176         vulnerability) where the poppler version is before 0.62.0, such as
    177         BLFS-8.1, do NOT use the commands in the <literal>MYPOPPLER</literal>
    178         block of instructions, nor the <literal>\-\-with-system-poppler</literal>
    179         or <literal>\-\-with-system-xpdf</literal> options when configuring.
    180       </para>-->
    181 
    182205      <para>
    183206        In the 2019 release, <application>dvisvgm</application> cannot be built
    184         if shared system libraries are used. This means that <xref linkend="asymptote"/>
    185         will not be able to create svg files.
     207        if shared system libraries are used. This means that
     208        <xref linkend="asymptote"/> will not be able to create svg files.
    186209      </para>
    187210    </note>
    … …  
    193216
    194217patch -Np1 -i ../texlive-&texlive-version;-source-upstream_fixes-1.patch &amp;&amp;
    195 <!--
    196 let MYPOPPLER=$(pkg-config \-\-modversion poppler | cut -d '.' -f2)
    197 mv -v texk/web2c/pdftexdir/pdftosrc{-newpoppler,}.cc
    198 if [ $MYPOPPLER -lt 68 ]; then
    199   mv -v texk/web2c/pdftexdir/pdftoepdf{-newpoppler,}.cc
    200 elif [ $MYPOPPLER -lt 69 ]; then
    201   mv -v texk/web2c/pdftexdir/pdftoepdf{-poppler0.68.0,}.cc
    202 else
    203   mv -v texk/web2c/pdftexdir/pdftoepdf{-poppler0.69.0,}.cc
    204 fi &amp;&amp;
    205 unset MYPOPPLER &amp;&amp;-->
     218
    206219mkdir texlive-build &amp;&amp;
    207220cd texlive-build    &amp;&amp;
    … …  
    240253make</userinput></screen>
    241254
    242     <para>To test the results, issue: <command>make check</command>
    243     A few tests may SKIP because kpathsea
    244     has not yet been installed.</para>
    245 
    246     <para>Now, as the <systemitem class="username">root</systemitem>
    247     user:</para>
     255    <para>
     256      To test the results, issue: <command>make check</command>
     257      A few tests may SKIP because kpathsea
     258      has not yet been installed.
     259    </para>
     260
     261    <para>
     262      Now, as the <systemitem class="username">root</systemitem> user:
     263    </para>
    248264
    249265<!-- Editors, you can run 'make texlinks' in a DESTDIR by passing
    … …  
    263279    </note>
    264280
    265     <para>Now install the additional files as the
    266     <systemitem class="username">root</systemitem> user:</para>
     281    <para>
     282      Now install the additional files as the
     283      <systemitem class="username">root</systemitem> user:
     284    </para>
    267285
    268286<!-- if texmf does not need to be patched, remove &amp;&amp; from first line,
    … …  
    270288<screen role="root"><userinput>tar -xf ../../texlive-&texmf-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1</userinput></screen>
    271289
    272     <para>Still as the <systemitem class="username">root</systemitem> user,
    273     initialise the new system (the commands <command>fmtutil-sys --all</command>
    274     and <command>mtxrun --generate</command> will produce a
    275     <emphasis>lot</emphasis> of output):</para>
     290    <para>
     291      Still as the <systemitem class="username">root</systemitem> user,
     292      initialise the new system (the commands <command>fmtutil-sys
     293      --all</command> and <command>mtxrun --generate</command> will produce
     294      a <emphasis>lot</emphasis> of output):
     295    </para>
    276296
    277297<!-- Editors, fmtutil-sys and mtxrun \-\-generate can apparently only be run on
    … …  
    283303mtxrun --generate</userinput></screen>
    284304
    285     <para>You can now proceed to <xref linkend="asymptote"/>,
    286     <xref linkend="biber"/> and / or <xref linkend="xindy"/> if you
    287     wish to install them.</para>
     305    <para>
     306      You can now proceed to <xref linkend="asymptote"/>,
     307      <xref linkend="biber"/> and / or <xref linkend="xindy"/> if you
     308      wish to install them.
     309    </para>
    288310
    289311  </sect2>
    … …  
    336358
    337359    <para>
    338       <command>/sbin/ldconfig</command>: this has to be run here so that <command>make
    339       texlinks</command> can use kpsewhich.
     360      <command>/sbin/ldconfig</command>: this has to be run here so that
     361      <command>make texlinks</command> can use kpsewhich.
    340362    </para>
    341363

  • pst/typesetting/tl-installer.xml

    r47274444 rfa3edfef  
    3333    <title>Introduction to TeX Live and its installer</title>
    3434
    35     <para>The <application>TeX Live</application> package is a comprehensive
    36     TeX document production system.  It includes TeX, LaTeX2e, ConTeXt,
    37     Metafont, MetaPost, BibTeX and many other programs; an extensive collection
    38     of macros, fonts and documentation; and support for typesetting in many
    39     different scripts from around the world.</para>
    40 
    41     <para>This page is for people who wish to use the binary installer to
    42     provide the programs, the scripts, and a lot of supporting files and
    43     documentation.  The installer is updated frequently, so its md5sum will
    44     change if it is newer than what is shown below.  Newer versions of the
    45     installer are expected to work with these instructions, for so long as they
    46     install to a
    47     <filename class="directory">&texlive-year;/</filename> directory.</para>
     35    <para>
     36      The <application>TeX Live</application> package is a comprehensive
     37      TeX document production system.  It includes TeX, LaTeX2e, ConTeXt,
     38      Metafont, MetaPost, BibTeX and many other programs; an extensive
     39      collection of macros, fonts and documentation; and support for
     40      typesetting in many different scripts from around the world.
     41    </para>
     42
     43    <para>
     44      This page is for people who wish to use the binary installer to
     45      provide the programs, the scripts, and a lot of supporting files and
     46      documentation.  The installer is updated frequently, so its md5sum will
     47      change if it is newer than what is shown below.  Newer versions of the
     48      installer are expected to work with these instructions, for so long as
     49      they install to a
     50      <filename class="directory">&texlive-year;/</filename> directory.
     51    </para>
    4852
    4953    <para>
    … …  
    6367    <itemizedlist spacing="compact">
    6468      <listitem>
    65         <para>Download (HTTP): <ulink url="&tl-installer-download-http;"/></para>
    66       </listitem>
    67       <listitem>
    68         <para>Download (FTP): <ulink url="&tl-installer-download-ftp;"/></para>
    69       </listitem>
    70       <listitem>
    71         <para>Download MD5 sum: &tl-installer-md5sum; (for &tl-installer-date;)</para>
    72       </listitem>
    73       <listitem>
    74         <para>Download size: &tl-installer-size;</para>
    75       </listitem>
    76       <listitem>
    77         <para>Estimated disk space required: &tl-installer-buildsize;</para>
    78       </listitem>
    79       <listitem>
    80         <para>Estimated build time: &tl-installer-time;</para>
     69        <para>
     70          Download (HTTP): <ulink url="&tl-installer-download-http;"/>
     71        </para>
     72      </listitem>
     73      <listitem>
     74        <para>
     75          Download (FTP): <ulink url="&tl-installer-download-ftp;"/>
     76        </para>
     77      </listitem>
     78      <listitem>
     79        <para>
     80          Download MD5 sum: &tl-installer-md5sum; (for &tl-installer-date;)
     81        </para>
     82      </listitem>
     83      <listitem>
     84        <para>
     85          Download size: &tl-installer-size;
     86        </para>
     87      </listitem>
     88      <listitem>
     89        <para>
     90          Estimated disk space required: &tl-installer-buildsize;
     91        </para>
     92      </listitem>
     93      <listitem>
     94        <para>
     95          Estimated build time: &tl-installer-time;
     96        </para>
    8197      </listitem>
    8298    </itemizedlist>
    … …  
    119135      <xref linkend="freeglut"/>.
    120136    </para>
    121     <para>
    122       As always with contributed binary software, it is possible that the required
    123       dependencies may change when the installer is updated. In particular, these
    124       dependencies have only been checked on x86_64.
    125     </para>
     137    <note>
     138      <para>
     139        As always with contributed binary software, it is possible that the
     140        required dependencies may change when the installer is updated. In
     141        particular, these dependencies have only been checked on x86_64.
     142      </para>
     143    </note>
    126144    <!-- text for runtime deps, shared with texlive -->
    127145    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    … …  
    136154    <title>Binary Installation of TeX Live</title>
    137155
    138     <para>The <application>TeX Live</application> set of programs with its
    139     supporting documents, fonts, and utilities is very large.  The upstream
    140     maintainers recommend placing all files in a single directory structure.
    141     BLFS recommends <filename class='directory'>/opt/texlive</filename>.</para>
    142 
    143     <para>As with any other package, unpack the installer and change into its
    144     directory, <filename class='directory'>install-tl-&lt;CCYYMMDD&gt;</filename>.
    145     This directory name changes when the installer is updated, so replace
    146     &lt;CCYYMMDD&gt; by the correct directory name.</para>
     156    <para>
     157      The <application>TeX Live</application> set of programs with its
     158      supporting documents, fonts, and utilities is very large.  The upstream
     159      maintainers recommend placing all files in a single directory structure.
     160      BLFS recommends <filename class='directory'>/opt/texlive</filename>.
     161    </para>
     162
     163    <para>
     164      As with any other package, unpack the installer and change into its
     165      directory, <filename class='directory'>
     166        install-tl-&lt;CCYYMMDD&gt;</filename>.
     167      This directory name changes when the installer is updated, so replace
     168      &lt;CCYYMMDD&gt; by the correct directory name.
     169    </para>
    147170
    148171    <note>
    149     <para>
    150     The distribution binaries installed below may use static linking
    151     for general linux system libraries.  Additional libraries or interpreters
    152     as specified in the dependencies section do not need to be present during
    153     the install, but the programs that need them will not run until their
    154     specific dependencies have been installed.
    155     </para>
     172      <para>
     173        The distribution binaries installed below may use static linking
     174        for general linux system libraries.  Additional libraries or
     175        interpreters as specified in the dependencies section do not need to
     176        be present during the install, but the programs that need them will
     177        not run until their specific dependencies have been installed.
     178      </para>
    156179
    157180    <!-- please keep something like this in the future -->
    158     <para>
    159     With all contributed binary software, there may be a mismatch between the
    160     builder's toolchain and your hardware.  In most of TeX this will probably
    161     not matter, but in uncommon corner cases you might hit problems.
    162     e.g. if your x86_64 processor does not support 3dnowext or 3dnow, the
    163     2014-06-28 binary failed in conTeXt when running LuaTeX, although lualatex
    164     worked, as did the i686 binaries on the same machine. In such cases, the
    165     easiest solution is to install texlive from source. Similarly, the x86_64
    166     binary version of <command>asy</command> runs very slowly when creating 3-D
    167     diagrams.
    168     </para>
     181      <para>
     182        With all contributed binary software, there may be a mismatch between
     183        the builder's toolchain and your hardware.  In most of TeX this will
     184        probably not matter, but in uncommon corner cases you might hit
     185        problems.  e.g. if your x86_64 processor does not support 3dnowext or
     186        3dnow, the 2014-06-28 binary failed in conTeXt when running LuaTeX,
     187        although lualatex worked, as did the i686 binaries on the same
     188        machine. In such cases, the easiest solution is to install texlive
     189        from source. Similarly, the x86_64 binary version of
     190        <command>asy</command> runs very slowly when creating 3-D diagrams.
     191      </para>
    169192    </note>
    170193
    171     <para>Now, as the <systemitem class="username">root</systemitem>
    172     user:</para>
     194    <para>
     195      Now, as the <systemitem class="username">root</systemitem> user:
     196    </para>
    173197
    174198<screen role="root"><userinput>TEXLIVE_INSTALL_PREFIX=/opt/texlive ./install-tl</userinput></screen>
    175199
    176     <para>This command is interactive and allows selection or modification of
    177     platform, packages, directories, and other options.  The full installation
    178     scheme will require about 4.9 gigabytes of disk space.  The time to complete
    179     the download will depend on your internet connection speed and the
    180     number of packages selected.</para>
     200    <para>
     201      This command is interactive and allows selection or modification of
     202      platform, packages, directories, and other options. The full installation
     203      scheme will require about 4.9 gigabytes of disk space. The time to
     204      complete the download will depend on your internet connection speed
     205      and the number of packages selected.
     206    </para>
    181207
    182208  </sect2>

  • pst/typesetting/typesetting.xml

    r47274444 rfa3edfef  
    1616  <title>Typesetting</title>
    1717
    18   <para>This chapter includes <application>texlive</application> applications that
    19   create output equivalent to typesetting.</para>
    20 
    21   <para>There are two alternative routes through this chapter:</para>
    22 
    23   <para>Some people may wish to use the binary installer, either because of the
    24   complexity of installing all of <application>texlive</application> from
    25   source, or because they only want a part of the package, or perhaps because
    26   they wish to get updates as soon as those are available (the source is only
    27   updated annually, but the binaries and associated tex and sty files are updated
    28   for approximately 10 months). These people should begin at <xref
    29   linkend="tex-path"/> and then follow the <xref linkend="tl-installer"/>
    30   instructions,. After installing, they can run
    31   <command>tlmgr</command> to update their system.</para>
    32 
    33   <para>Most people reading BLFS will wish to build from source. BLFS used to
    34   start by installing <application>install-tl-unx</application> and then use that
    35   to bootstrap the build.  Nowadays, we build almost the whole of
    36   <application>texlive</application> <emphasis>without</emphasis> a binary install,
    37   by adding the separately-packaged texmf files into this build.  For this, begin
    38   at <xref linkend="tex-path"/> then go to <xref linkend="texlive"/> which will
    39   install most of
    40   <application>texlive</application>, together with <emphasis>all</emphasis> of the
    41   supporting files. This almost-complete install can then be used to build the
    42   remaining parts of <application>texlive</application>: <xref
    43   linkend="asymptote"/>, <xref linkend="biber"/> and <xref linkend="xindy"/>.
     18  <para>
     19    This chapter includes <application>texlive</application> applications that
     20    create output equivalent to typesetting.
    4421  </para>
    4522
    46   <para>Because the texmf files (including documentation, fonts, scripts and
    47   supporting files) are all in one tarball, it is not practical to limit what
    48   gets extracted in a sensible way  (you could exclude one or other of the
    49   typesetting engines, not its many supporting files) when building from source
    50   in this manner.</para>
     23  <para>
     24    There are two alternative routes through this chapter:
     25  </para>
    5126
    52   <para>In either case, BLFS installs into
    53   <filename class="directory">/opt/texlive/&texlive-year;</filename>.</para>
     27  <para>
     28    Some people may wish to use the binary installer, either because of the
     29    complexity of installing all of <application>texlive</application> from
     30    source, or because they only want a part of the package, or perhaps because
     31    they wish to get updates as soon as those are available (the source is only
     32    updated annually, but the binaries and associated tex and sty files are
     33    updated for approximately 10 months). These people should begin at <xref
     34    linkend="tex-path"/> and then follow the <xref linkend="tl-installer"/>
     35    instructions. After installing, they can run <command>tlmgr</command> to
     36    update their system.
     37  </para>
    5438
    55   <para>Also, please note that texlive is released annually, and updating from the
    56   previous year to the current year is no longer supported. If for some reason
    57   you wish to keep versions for multiple years, for most things you can mount the
    58   old or new system at /opt/texlive and fix up your PATH as necessary. However
    59   doing that will not preserve any changes in <filename
    60   class="directory">texmf-local</filename> and if you build from source and try to
    61   run a newer version of <application>biber</application> with an older version of
    62   <application>biblatex</application> it is unlikely to work.</para>
     39  <para>
     40    Most people reading BLFS will wish to build from source. BLFS used to
     41    start by installing <application>install-tl-unx</application> and then
     42    use that to bootstrap the build.  Nowadays, we build almost the whole
     43    of <application>texlive</application> <emphasis>without</emphasis> a
     44    binary install, by adding the separately-packaged texmf files into this
     45    build.  For this, begin at <xref linkend="tex-path"/> then go to <xref
     46    linkend="texlive"/> which will install most of
     47    <application>texlive</application>, together with <emphasis>all</emphasis>
     48    of the supporting files. This almost-complete install can then be used
     49    to build the remaining parts of <application>texlive</application>:
     50    <xref linkend="asymptote"/>, <xref linkend="biber"/> and <xref
     51    linkend="xindy"/>.
     52  </para>
     53
     54  <para>
     55    Because the texmf files (including documentation, fonts, scripts and
     56    supporting files) are all in one tarball, it is not practical to limit what
     57    gets extracted in a sensible way  (you could exclude one or other of the
     58    typesetting engines, not its many supporting files) when building from
     59    source in this manner.
     60  </para>
     61
     62  <para>
     63    In either case, BLFS installs into
     64    <filename class="directory">/opt/texlive/&texlive-year;</filename>.
     65  </para>
     66
     67  <para>
     68    Also, please note that texlive is released annually, and updating from the
     69    previous year to the current year is no longer supported. If for some
     70    reason you wish to keep versions for multiple years, for most things
     71    you can mount the old or new system at /opt/texlive and fix up your
     72    PATH as necessary. However doing that will not preserve any changes in
     73    <filename class="directory">texmf-local</filename> and if you build
     74    from source and try to run a newer version of
     75    <application>biber</application> with an older version of
     76    <application>biblatex</application> it is unlikely to work.
     77  </para>
    6378
    6479  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="tex-path.xml"/>

  • pst/typesetting/xindy.xml

    r47274444 rfa3edfef  
    7878    <itemizedlist spacing="compact">
    7979      <listitem>
    80         <para>Required patch: <ulink
    81         url="&patch-root;/xindy-&xindy-version;-upstream_fixes-1.patch"/></para>
     80        <para>
     81          Required patch: <ulink
     82          url="&patch-root;/xindy-&xindy-version;-upstream_fixes-1.patch"/>
     83        </para>
    8284      </listitem>
    8385    </itemizedlist>
    … …  
    165167     href="../../xincludes/tex-prefix.xml"/>
    166168
    167     <para><parameter>--includedir=/usr/include</parameter>:
    168     This parameter ensures that the <filename>kpathsea</filename>
    169     headers from <xref linkend="texlive"/> will be found.</para>
     169    <para>
     170      <parameter>--includedir=/usr/include</parameter>:
     171      This parameter ensures that the <filename>kpathsea</filename>
     172      headers from <xref linkend="texlive"/> will be found.
     173    </para>
    170174
    171175    <para>
Note: See TracChangeset for help on using the changeset viewer.