On Mon, Oct 13, 2014 at 09:49:26PM +0100, Ken Moffat wrote:
> On Mon, Oct 13, 2014 at 12:11:12AM -0500, Bruce Dubbs wrote:
> > 
> > There is no problem with setting it up one way, evaluating, and making
> > changes.  It helps to have an initial version to do constructive critiques.
> > 
>  I've copied the book as at r14599, and made a first working copy.
> I'll have a look at producing at least one suggestion, and put that
> up temporarily in my LFS space.  ISTR that it is simplest to upload
> the whole rendered book, so that everything gets picked up
> correctly, rather than just try to upload a single page or chapter.
> 
 A version with tex live pass 1 moved to a separate page is now at
http://www.linuxfromscratch.org/~ken/tmp/blfs-book-two-pass-tex/
and I'll attach a diff (none of this has been committed to my
sandbox).

 Summary of what I have attempted to do (all changes are only in
chapter 48) -

  1. typesetting

 A lot more introductory text.  I have also indicated why people
might want to use the binary.

  2. install-tl-unx

 Move the instructions about setting the PATH to their own page and
point to that.

  3. texlive... -texmf

 The required scripts and docs.  With a big Note and using
tar ... -C from the current directory.

  4. texlive ... -source pass 1

 New page, for building from source - copied from -source.

<rude words> : I _thought I had set TEXARCH in texlive for 7.6, but
apparently I only did it to the binary installer.  This version has
x86_64 hardcoded and I did not notice (and then fixed that up in
texlive itself).

 A large slice of dependencies and command explanations ought to be
in a copy member for htis approach (shared by texlive), I have not
wasted time trying to do that.

 Remeasured for 7.6.

  5. Setting the PATH for TeX Live

 Moved from install-tl-unx to its own page, new final paragraph
telling people where to go after this.

  6. texlive ... -source

 This is now set out to prefer a build from pass 1.

 The (full) install for building for binary probably needs to be
'nodump'.

 Changed title to include -source (two links both called
texlive-20140525-source were driving me mad when I added texmf).

 Changed the introductory text, make it depend on pass 1 or the
binary installer.

 Tweak the text about python and ruby without going into the
brief detail in the tl-installer about why ruby is useful.

 Scripts are not reinstalled by this package if building only from
source, the possibility of newer things from a newer installer being
overwritten by old from-source versions is alluded to, perhaps
obliquely, in the text on the typesetting page.

 Use TEXARCH instead of hard-coding x86_64-linux.

<more rude words> I put the nodump on the xindy install.  That is
supposed to be the default.

 Remeasured for 7.6 : I have a space measurement for building from
install-tl-unx but I have ignored it as non-preferred (and the SBU
was essentially the same).

ĸen
-- 
Nanny Ogg usually went to bed early. After all, she was an old lady.
Sometimes she went to bed as early as 6 a.m.
diff -Naur base-book/pst/typesetting/texlive-pass1.xml 
working-book-2/pst/typesetting/texlive-pass1.xml
--- base-book/pst/typesetting/texlive-pass1.xml 1970-01-01 01:00:00.000000000 
+0100
+++ working-book-2/pst/typesetting/texlive-pass1.xml    2014-10-16 
00:53:42.517504503 +0100
@@ -0,0 +1,278 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY texlive-pass1-download-http " ">
+  <!ENTITY texlive-pass1-download-ftp  
"ftp://tug.org/texlive/historic/&texlive-year;/texlive-&texlive-version;-source.tar.xz";>
+  <!ENTITY texlive-pass1-md5sum        "09ee265ff51637827559affc7304078c">
+  <!ENTITY texlive-pass1-size          "40 MB">
+
+  <!ENTITY texlive-pass1-buildsize      "900 MB">
+  <!ENTITY texlive-pass1-time           "6.9 SBU">
+]>
+
+<sect1 id="texpass1" xreflabel="texlive-&texlive-version;">
+  <?dbhtml filename="texlive-pass1.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy: pierre $</othername>
+    <date>$Date: 2014-09-19 22:19:42 +0100 (Fri, 19 Sep 2014) $</date>
+  </sect1info>
+
+  <title>texlive-&texlive-version;-source pass 1</title>
+
+  <indexterm zone="texpass1">
+    <primary sortas="a-texpass1">texlive-pass-1</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to TeX Live from source, pass 1</title>
+
+    <para>Most of TeX Live can be built from source without difficulty.
+    However, <application>xindy</application> (for indexing) needs working
+    versions of <command>latex</command> and <command>pdflatex</command>
+    when configure is run, and the testsuite for <command>asy</command>
+    (for vector graphics) will fail if TeX has not already been installed.
+    </para>
+
+    <para>In addition, it is necessary to create various symlinks at the end of
+    this install.</para>
+
+    <para>We can later rebuild texlive in <xref linkend="texlive"/> to include
+    xindy. There we will install xindy and also build and install asy.</para>
+
+    &lfs76_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink 
url="&texlive-pass1-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink 
url="&texlive-pass1-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &texlive-pass1-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &texlive-pass1-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &texlive-pass1-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &texlive-pass1-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">TeX Live from source pass 1 
Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required">
+      <xref linkend="texmf"/>
+    </para>
+
+    <bridgehead renderas="sect4">Recommended</bridgehead>
+    <para role="recommended">
+      The source ships with its own versions of <emphasis>many</emphasis>
+      libraries, and will use them unless it is forced to use the system
+      versions.  The following are recommended so that the system version
+      will be used:
+      <xref linkend="fontconfig"/>,
+      <xref linkend="freetype2"/>,
+      <xref linkend="gc"/>,
+      <xref linkend="graphite2"/>,
+      <xref linkend="harfbuzz"/> (linked to graphite2),
+      <xref linkend="icu"/>,
+      <xref linkend="libpaper"/>,
+      <xref linkend="libpng"/>,
+      <xref linkend="poppler"/>
+    </para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      The source ships with its own versions of several libraries which are 
either
+      not under active development, or only used for limited functionality.  If
+      you install these, as with some other optional dependencies in this book 
you
+      will need to tell <command>configure</command> to use the system 
versions.
+      <ulink url="http://libgd.bitbucket.org";>GD</ulink>,
+      <ulink 
url="http://fossies.org/linux/misc/t1lib-5.1.2.tar.gz/";>t1lib</ulink>,
+      <ulink url="http://sourceforge.net/projects/zziplib/";>ZZIPlib</ulink>,
+      <ulink 
url="http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&amp;id=TECkitDownloads";>TECkit</ulink>
+    </para>
+
+    <bridgehead renderas="sect4">Runtime dependencies</bridgehead>
+    <para role="recommended">
+      Some scripts will use
+      <xref linkend="python2"/> or <xref linkend="ruby"/>.
+    </para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/texlive-pass1"/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of TeX Live, pass 1</title>
+
+    <para>
+      Install TeX Live pass 1 by running the following commands:
+    </para>
+
+<screen><userinput>mkdir texlive-build &amp;&amp;
+cd texlive-build    &amp;&amp;
+
+../configure                                        \
+    --prefix=/opt/texlive/&texlive-year;                      \
+    --bindir=/opt/texlive/&texlive-year;/bin/x86_64-linux     \
+    --datarootdir=/opt/texlive/&texlive-year;                 \
+    --includedir=/usr/include                       \
+    --infodir=/opt/texlive/&texlive-year;/texmf-dist/doc/info \
+    --libdir=/usr/lib                               \
+    --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man   \
+    --disable-native-texlive-build                  \
+    --disable-static --enable-shared                \
+    --with-system-cairo                             \
+    --with-system-fontconfig                        \
+    --with-system-freetype2                         \
+    --with-system-graphite2                         \
+    --with-system-harfbuzz                          \
+    --with-system-icu                               \
+    --with-system-libgs                             \
+    --with-system-libpng                            \
+    --with-system-pixman                            \
+    --with-system-poppler                           \
+    --with-system-xpdf                              \
+    --with-system-zlib                              \
+    --with-banner-add=" - BLFS" &amp;&amp;
+
+make</userinput></screen>
+
+    <para>To test the results, issue: <command>make -k check</command>
+    One test in each of web2c, dvipng and ttf2pk2 will SKIP because kpathsea
+    has not yet been installed.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem>
+    user:</para>
+
+<screen><userinput role="root">make install &amp;&amp;
+make texlinks</userinput></screen>
+
+    <para>Now proceed to <xref linkend="tex-path"/>.</para>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para>
+      <parameter>--prefix=, --bindir=, --datarootdir=, --infodir=, --mandir= 
...
+      </parameter>: these switches ensure that the files installed from source
+      will overwrite the corresponding files previously installed by
+      <application>install-tl</application>.
+    </para>
+
+    <para>
+      <parameter>--includedir=, --libdir= ...</parameter> : these switches 
ensure
+      that the libraries will be found at runtime, and that programs can be
+      compiled against them.
+    </para>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+      href="../../xincludes/static-libraries.xml"/>
+
+    <para>
+      <parameter>--enable-shared</parameter>: Create shared versions of
+      <filename class="libraryfile">libkpathsea</filename> and
+      <filename class="libraryfile">libptexenc</filename>.
+    </para>
+
+    <para>
+      <parameter>--with-system-...</parameter>: Unless this parameter is used,
+      the included versions of these libraries  will be statically compiled
+      into the programs which need them.  If you decided not to install a
+      recommended library, omit the corresponding switches.
+    </para>
+
+    <para>
+      <parameter>--with-system-xpdf</parameter>: Uniquely, this parameter has
+      a non-standard meaning, it tells <command>configure</command> to use the
+      system-installed <application>poppler</application> headers and library.
+      Again, omit this if you have not installed
+      <application>poppler</application>.
+    </para>
+
+    <para>
+      <option>--without-x</option>: use this if you do not have Xorg installed.
+    </para>
+
+    <para>
+      <parameter>make texlinks</parameter> : this runs the texlinks.sh script
+      to create (or recreate) symbolic links from formats to engines.  In
+      practice, several of the targets such as <command>xetex</command> are now
+      separate binaries and for these it will report "file already exists".
+    </para>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>Over 300 binaries and symlinks to scripts</seg>
+        <seg>libkpathsea.so, libptexenc.so</seg>
+        <seg>/opt/texlive/2014/bin, /usr/include/kpathsea, 
/usr/include/ptexenc</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="texpass1-programs">
+        <term><command>TeX&nbsp;programs</command></term>
+        <listitem>
+          <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+          href="../../xincludes/texprogs.xml"/>
+          <indexterm zone="texpass1 texpass1-programs">
+            <primary sortas="b-texpass1-programs">TeX Live programs</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="libkpathsea-texpass1">
+        <term><filename class="libraryfile">libkpathsea.so</filename></term>
+        <listitem>
+          <para>
+            (kpathsearch) exists to look up a file in a list of directories.
+          </para>
+          <indexterm zone="texpass1 libkpathsea">
+            <primary sortas="c-libkpathsea">libkpathsea.so</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="libptexenc-texpass1">
+        <term><filename class="libraryfile">libptexenc.so</filename></term>
+        <listitem>
+          <para>
+            is a library for Japanese pTeX (publishing TeX).
+          </para>
+          <indexterm zone="texpass1 libptexenc">
+            <primary sortas="c-libptexenc">libptexenc.so</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+  </sect2>
+
+</sect1>
diff -Naur base-book/pst/typesetting/texlive.xml 
working-book-2/pst/typesetting/texlive.xml
--- base-book/pst/typesetting/texlive.xml       2014-09-21 01:41:55.226824813 
+0100
+++ working-book-2/pst/typesetting/texlive.xml  2014-10-16 00:55:31.391417912 
+0100
@@ -9,10 +9,8 @@
   <!ENTITY texlive-source-md5sum        "09ee265ff51637827559affc7304078c">
   <!ENTITY texlive-source-size          "40 MB">
 
-  <!-- buildsize is the source dir, plus the kpathsea files installed to /usr.
-   The progs in bin/$TEXARCH/ seem slightly smaller (shared libs) -->
-  <!ENTITY texlive-buildsize            "555 MB">
-  <!ENTITY texlive-time                 "8.4 SBU">
+  <!ENTITY texlive-buildsize            "923 MB (if starting from pass 1)">
+  <!ENTITY texlive-time                 "9.0 SBU">
 ]>
 
 <sect1 id="texlive" xreflabel="texlive-&texlive-version;">
@@ -23,7 +21,7 @@
     <date>$Date: 2014-09-19 22:19:42 +0100 (Fri, 19 Sep 2014) $</date>
   </sect1info>
 
-  <title>texlive-&texlive-version;</title>
+  <title>texlive-&texlive-version;-source</title>
 
   <indexterm zone="texlive">
     <primary sortas="a-texlive">texlive</primary>
@@ -32,9 +30,10 @@
   <sect2 role="package">
     <title>Introduction to TeX Live from source</title>
 
-    <para>A binary version of the <application>TeX Live</application> package
-    is installed at <xref linkend="tl-installer"/>. Here, we use that to 
rebuild
-    the compiled programs from source.</para>
+    <para>After either installing a partial TeX build (or installing the
+    binary version), here we will build all of TeX Live from source (except
+    <application>biber</application> which is not supplied in the source
+    tarball and will be dealt with separately).</para>
 
     &lfs76_checked;
 
@@ -64,10 +63,8 @@
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-      <xref linkend="tl-installer"/> or a previous version of TeX Live
-      (untested, you would need to alter the configure switches which refer
-      to &texlive-year; so that it overwrites your existing installation, or
-      else copy everything to the location for the current year), and
+      Either <xref linkend="texpass1"/> or <xref linkend="tl-installer"/>
+      , and
       <xref linkend="clisp"/> (to build <command>xindy</command> which is an
       index processor for multi-lingual index creation)
     </para>
@@ -108,7 +105,7 @@
 
     <bridgehead renderas="sect4">Runtime dependencies</bridgehead>
     <para role="recommended">
-      Some (re-installed) scripts will use
+      Some scripts will use
       <xref linkend="python2"/> or <xref linkend="ruby"/>.
     </para>
 
@@ -124,31 +121,15 @@
     binary installer.  As with the installer, change x86_64-linux to whatever
     matches your architecture.</para>
 
-    <para>Please note that installing from source will recompile the binary
-    programs and recreate the <literal>man</literal> and 
<literal>info</literal>
-    files.  It will also overwrite the scripts - some of these may be older
-    versions than those from the newer installer.  It will 
<emphasis>not</emphasis>
-    recreate any of the following: the more than 200 symlinks in the
-    x86_64-linux directory (some are alternate names, many are pointers to
-    the scripts), html files, PDF files, licenses, README files, two config
-    files (<filename>texmf.cnf</filename> and 
<filename>texmfcnf.lua</filename>),
-    nor the many package and font files in
-    <filename class="directory">texmf-dist</filename> and
-    <filename class="directory">texmf-var</filename>, nor the files recording
-    the actions of the installer, and the <filename>ls-R</filename> files 
listing
-    what was originally installed.</para>
-
-    <para>Asy and the rest of asymptote is by default not rebuilt, so we have 
to
-    separately run <command>configure</command> and <command>make</command> in 
its
-    directory.
-    </para>
-
-<screen><userinput>mkdir texlive-build &amp;&amp;
+<!-- EOF should NOT be in double quotes, we want it to evaluate $TEXARCH -->
+<!-- this is also in tex-path.xml -->
+<screen role="root"><userinput>export TEXARCH=$(uname -m | sed -e 
's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
+mkdir texlive-build &amp;&amp;
 cd texlive-build    &amp;&amp;
 
 ../configure                                        \
     --prefix=/opt/texlive/&texlive-year;                      \
-    --bindir=/opt/texlive/&texlive-year;/bin/x86_64-linux     \
+    --bindir=/opt/texlive/&texlive-year;/bin/$TEXARCH     \
     --datarootdir=/opt/texlive/&texlive-year;                 \
     --includedir=/usr/include                       \
     --infodir=/opt/texlive/&texlive-year;/texmf-dist/doc/info \
@@ -187,13 +168,14 @@
 
 ./configure LIBS="-ltirpc "                         \
     --prefix=/opt/texlive/&texlive-year;/                     \
-    --bindir=/opt/texlive/&texlive-year;/bin/x86_64-linux     \
+    --bindir=/opt/texlive/&texlive-year;/bin/$TEXARCH     \
     --enable-texlive-build                          \
     --datarootdir=/opt/texlive/&texlive-year;/texmf-dist      \
     --infodir=/opt/texlive/&texlive-year;/texmf-dist/doc/info \
     --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man   \
-    --cache-file=config.cache &amp;&amp;
+    --cache-file=config.cache &amp;&amp; &amp;&amp;
 popd &amp;&amp;
+unset TEXARCH &amp;&amp;
 
 make &amp;&amp;
 make -C ../utils/asymptote</userinput></screen>
@@ -201,9 +183,18 @@
     <para>To test the results, issue: <command>make -k check &amp;&amp;
     make -C utils/asymptote check</command>.</para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem>
+    <para>If you have used the binary installer, you will want to
+    do a full install. As the <systemitem class="username">root</systemitem>
     user:</para>
 
+<screen><userinput role="nodump">make -C utils/xindy install &amp;&amp;
+make -C ../utils/asymptote install</userinput></screen>
+
+    <para>For people who have followed the LFS way and built from source,
+    it is only necessary to install <application>xindy</application> and
+    <application>asy</application>, so, as the
+    <systemitem class="username">root</systemitem> user:</para>
+
 <screen><userinput role="root">make install &amp;&amp;
 make -C ../utils/asymptote install</userinput></screen>
 
diff -Naur base-book/pst/typesetting/texmf.xml 
working-book-2/pst/typesetting/texmf.xml
--- base-book/pst/typesetting/texmf.xml 1970-01-01 01:00:00.000000000 +0100
+++ working-book-2/pst/typesetting/texmf.xml    2014-10-15 01:39:50.118176996 
+0100
@@ -0,0 +1,109 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY texlive-texmf-download-http " ">
+  <!ENTITY texlive-texmf-download-ftp  
"ftp://tug.org/texlive/historic/&texlive-year;/texlive-&texlive-version;-texmf.tar.xz";>
+  <!ENTITY texlive-texmf-md5sum        "645a6f1d3a0ef4a9c279dae02588eab7">
+  <!ENTITY texlive-texmf-size          "1.7 GB">
+
+  <!-- buildsize is the source dir, plus the kpathsea files installed to /usr.
+   The progs in bin/$TEXARCH/ seem slightly smaller (shared libs) -->
+  <!ENTITY texlive-texmf-buildsize      "3.6 GB">
+  <!ENTITY texlive-texmf-time           "1.3 SBU">
+]>
+
+<sect1 id="texmf" xreflabel="texlive-&texlive-version;-texmf">
+  <?dbhtml filename="texmf.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy: pierre $</othername>
+    <date>$Date: 2014-09-19 22:19:42 +0100 (Fri, 19 Sep 2014) $</date>
+  </sect1info>
+
+  <title>texlive-&texlive-version;-texmf</title>
+
+  <indexterm zone="texmf">
+    <primary sortas="a-texmf">texmf</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to texmf.</title>
+
+    <para>The texmf tarball contains files for use by TeX as well as
+    documentation.</para>
+
+    <note>
+      <para>
+        Exceptionally, you should NOT extract this package before running the
+        commands below.  Doing so would waste your time and disk space.
+      </para>
+      <para>
+        Because of the size of this package, it is unlikely to be mirrored by
+        BLFS mirrors.  In case of difficulty, go to 
http://www.ctan.org/mirrors/
+        to find a more-accessible mirror.
+      </para>
+    </note>
+
+    &lfs76_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink 
url="&texlive-texmf-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink 
url="&texlive-texmf-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &texlive-texmf-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &texlive-texmf-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &texlive-texmf-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &texlive-texmf-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/texmf"/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of texmf</title>
+
+    <para>As the <systemitem class="username">root</systemitem>
+    user:</para>
+
+<screen><userinput role="root">mkdir -pv /opt/texlive/&texlive-year; &amp;&amp;
+tar -xf texlive-&texlive-version;-texmf.tar.xz \
+ -C /opt/texlive/&texlive-year; \
+ --strip-components=1</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>none</seg>
+        <seg>none</seg>
+        <seg>texmf-dist</seg>
+      </seglistitem>
+    </segmentedlist>
+
+  </sect2>
+
+</sect1>
diff -Naur base-book/pst/typesetting/tex-path.xml 
working-book-2/pst/typesetting/tex-path.xml
--- base-book/pst/typesetting/tex-path.xml      1970-01-01 01:00:00.000000000 
+0100
+++ working-book-2/pst/typesetting/tex-path.xml 2014-10-15 20:51:50.123556031 
+0100
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+]>
+
+<sect1 id="tex-path" xreflabel="Setting the PATH for TeX Live">
+  <?dbhtml filename="tex-path.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy: ken $</othername>
+    <date>$Date: 2013-08-26 16:43:33 +0100 (Mon, 26 Aug 2013) $</date>
+  </sect1info>
+
+  <title>Setting the PATH for TeX Live</title>
+
+    <para>After the package download is complete, the next step is to make sure
+    that the system can properly find the files.  If you set up your login
+    scripts as recommended in <xref linkend='postlfs-config-profile'/>, update
+    the needed paths by appending to the
+    <filename>extrapaths.sh</filename> script. The programs are always
+    installed in an &lt;ARCH&gt;-linux subdirectory and on 32-bit x86 this is
+    always i386-linux. For x86_64 and i?86 we can generate this as $TEXARCH:
+    </para>
+
+<!-- EOF should NOT be in double quotes, we want it to evaluate $TEXARCH -->
+<!-- this is also in texlive.xml -->
+<screen role="root"><userinput>export TEXARCH=$(uname -m | sed -e 
's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
+cat &gt;&gt; /etc/profile.d/extrapaths.sh &lt;&lt; EOF
+pathappend /usr/share/man                        MANPATH
+pathappend /opt/texlive/&texlive-year;/texmf-dist/doc/man  MANPATH
+pathappend /usr/share/info                       INFOPATH
+pathappend /opt/texlive/&texlive-year;/texmf-dist/doc/info INFOPATH
+pathappend /opt/texlive/&texlive-year;/bin/$TEXARCH
+EOF
+unset TEXARCH</userinput></screen>
+
+    <note><para>The standard MANPATH and INFOPATH path are specified above to
+    ensure they are included.  If they are already set in the boot script
+    procedure, the pathappend function will ensure duplicates are
+    removed, so including them here will do no harm.</para></note>
+
+    <para>The new paths can be immediately activated by running <command>source
+    /etc/profile</command>.</para>
+
+    <para>If you arrived here after installing the TeX Live binary and do not
+    wish to build from source, your installation is now complete. To continue
+    building from source, please procede to <xref linkend="texlive"/>.</para>
+
+
+
+</sect1>
diff -Naur base-book/pst/typesetting/tl-installer.xml 
working-book-2/pst/typesetting/tl-installer.xml
--- base-book/pst/typesetting/tl-installer.xml  2014-10-12 03:35:15.380871692 
+0100
+++ working-book-2/pst/typesetting/tl-installer.xml     2014-10-15 
21:08:21.469455383 +0100
@@ -164,35 +164,7 @@
     the download will depend on your internet connection speed and the
     number of packages selected.</para>
 
-    <para>After the package download is complete, the next step is to make sure
-    that the system can properly find the files.  If you set up your login
-    scripts as recommended in <xref linkend='postlfs-config-profile'/>, update
-    the needed paths by appending to the
-    <filename>extrapaths.sh</filename> script. The programs are always
-    installed in an &lt;ARCH&gt;-linux subdirectory and on 32-bit x86 this is
-    always i386-linux. For x86_64 and i?86 we can generate this as $TEXARCH:
-    </para>
-
-<!-- EOF should NOT be in double quotes, we want it to evaluate $TEXARCH -->
-<screen role="root"><userinput>export TEXARCH=$(uname -m | sed -e 
's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
-cat &gt;&gt; /etc/profile.d/extrapaths.sh &lt;&lt; EOF
-pathappend /usr/share/man                        MANPATH
-pathappend /opt/texlive/&texlive-year;/texmf-dist/doc/man  MANPATH
-pathappend /usr/share/info                       INFOPATH
-pathappend /opt/texlive/&texlive-year;/texmf-dist/doc/info INFOPATH
-pathappend /opt/texlive/&texlive-year;/bin/$TEXARCH
-EOF
-unset TEXARCH</userinput></screen>
-
-    <note><para>The standard MANPATH and INFOPATH path are specified above to
-    ensure they are included.  If they are already set in the boot script
-    procedure, the pathappend function will ensure duplicates are
-    removed, so including them here will do no harm.</para></note>
-
-    <para>The new paths can be immediately activated by running <command>source
-    /etc/profile</command>.</para>
-
-    <para>At this point the binary installation is complete.</para>
+    <para>Now proceed to <xref linkend="tex-path"/>.</para>
 
   </sect2>
 
diff -Naur base-book/pst/typesetting/typesetting.xml 
working-book-2/pst/typesetting/typesetting.xml
--- base-book/pst/typesetting/typesetting.xml   2014-08-30 05:50:42.499575984 
+0100
+++ working-book-2/pst/typesetting/typesetting.xml      2014-10-16 
01:06:06.266596940 +0100
@@ -18,7 +18,23 @@
   <para>This chapter includes applications that create output equivalent to
   typesetting.</para>
 
+  <para>Because of the complexity of the <application>texlive</application>
+  install process some people may wish to use the binary version, so we provide
+  both methods.  To use the binaries, follow the install-tl-unx instructions.
+  Anyone who relies on up-to-date texlive might wish to consider using the
+  binaries and running tlmgr to handle updates (the source version is only 
updated
+  anually, the binary is updated during the year).</para>
+
+  <para>If you wish to build from source, you can begin by installing texmf, 
and
+  then build a basic version of tex and use that to build the full final 
version,
+  or you can begin by following the install-tl-unx instructions and then use 
the
+  binary to build from source. For people who use LFS, source is normally the
+  preferred method.</para>
+
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; 
href="tl-installer.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="texmf.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; 
href="texlive-pass1.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="tex-path.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="texlive.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="biber.xml"/>
 
-- 
http://lists.linuxfromscratch.org/listinfo/blfs-dev
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to