On Fri, Oct 17, 2014 at 11:17:46PM +0100, Ken Moffat wrote: > On Thu, Oct 16, 2014 at 03:30:25PM -0500, Bruce Dubbs wrote: > > Ken Moffat wrote: > > > > If this is right, we need to make it really clear to the user what the paths > > are: > > > > 1, 1+5, 2+3+4, 2+3+4+5. Are there other combinations? If 2+3+4 are > > combined this then turns into 1 or 3 or 1+5 or 3+5. Correct? > > > (a) binary + paths. > (b) binary + paths + texlive-source + (optionally) biber. > (c) pass 1 including texmf + paths + (optionally > the texlive-source for xindy, asy) + (optionally) biber. > > (b) + only asy (which is covered in texlive source) is also valid, > but I figure people can work that out if they do not want xindy > (although I suspect many people will not use asy). > > > > > IMO, the best place to put this type of discussion is in the Typesetting > > intro. > > > New version at http://www.linuxfromscratch.org/~ken/tmp/blfs-book-two-pass-tex/ with tarball and diff at ../
Diff also attached. As before, all changes are in chapter 48. In particular: Texmf is now an additional download for pass 1 texlive source. I had noticed I swapped the nodump/root roles in the main texlive install, but I also swapped the install commands. Now fixed. Pass 1 now uses $TEXARCH, and its xref has acquired "pass 1". I also added Xorg as a recommended dependency, for those people who do not proceed to the complete build. Changed the text on the (Chapter 48) Typesetting page. In passing, (I checked to see how we were linking to texlive - all the links are to texlive-source, I consider that is adequate, after all BLFS is for people who wish to build from source) I will note that almost everything which had a link is now in the archive/ directory. If tex is only in the book as a build dependency, we could get rid of it if we ever get rid of bind, evince, mutt. [ That was a joke ]. ĸ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-3/pst/typesetting/texlive-pass1.xml --- base-book/pst/typesetting/texlive-pass1.xml 1970-01-01 01:00:00.000000000 +0100 +++ working-book-3/pst/typesetting/texlive-pass1.xml 2014-10-21 00:02:23.724539691 +0100 @@ -0,0 +1,328 @@ +<?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"> + + <!-- when measured, 900MB for pass 1 itself, 3.6 GB for texmf --> + <!ENTITY texlive-pass1-buildsize "3.6 GB including the additional download"> + <!ENTITY texlive-pass1-time "8.2 SBU including the additional download"> + + <!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"> + +]> + + +<sect1 id="texpass1" xreflabel="texlive-&texlive-version;-source pass 1"> + <?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">Required Additional Download</bridgehead> + + <para>Much of the texlive environment (including scripts, documentation, + fonts and various other files) is not part of the source tarball. You must + download it separately. This will give you all of the additional files + which are provided by a full install of the binary version, there is no + realistic way to restrict which parts get installed.</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> + + <itemizedlist spacing="compact"> + <title>Standard Fonts</title> + <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> + </itemizedlist> + + <bridgehead renderas="sect3">TeX Live from source pass 1 Dependencies</bridgehead> + + <bridgehead renderas="sect4">Recommended</bridgehead> + <para role="recommended"> + <xref linkend="x-window-system"/> + </para> + <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&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 role="root"><userinput>export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') && +mkdir texlive-build && +cd texlive-build && + +../configure \ + --prefix=/opt/texlive/&texlive-year; \ + --bindir=/opt/texlive/&texlive-year;/bin/$TEXARCH \ + --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" && +unset TEXARCH && + +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 && +make texlinks</userinput></screen> + + <para>And now, install the additional files as the + <systemitem class="username">root</systemitem> user:</para> + +<screen><userinput role="root">mkdir -pv /opt/texlive/&texlive-year; && +tar -xf texlive-&texlive-version;-texmf.tar.xz \ + -C /opt/texlive/&texlive-year; \ + --strip-components=1</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> + <para> + <parameter>tar -xf texlive-&texlive-version;-texmf.tar.xz -C /opt/texlive/&texlive-year; --strip-components=1</parameter>: + the tarball contains the files for the texmf-dist directory, and because + of its size we do not want to waste time and space untarring it and then + copying the files. + </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/&texlive-year;/bin, /opt/texlive/&texlive-year;/texmf-dist, + /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 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-3/pst/typesetting/texlive.xml --- base-book/pst/typesetting/texlive.xml 2014-09-21 01:41:55.226824813 +0100 +++ working-book-3/pst/typesetting/texlive.xml 2014-10-20 23:58:34.048325593 +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 installing a partial TeX build (or alternatively 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> @@ -120,35 +117,16 @@ <sect2 role="installation"> <title>Installation of TeX Live</title> - <para>These instructions will overwrite the corresponding files from the - 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> + <para>If you started with the binary installer, these instructions will + overwrite the programs it installed.</para> -<screen><userinput>mkdir texlive-build && +<screen role="root"><userinput>export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') && +mkdir texlive-build && cd texlive-build && ../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 +165,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 && + --cache-file=config.cache && && popd && +unset TEXARCH && make && make -C ../utils/asymptote</userinput></screen> @@ -201,10 +180,19 @@ <para>To test the results, issue: <command>make -k check && 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="root">make install && +<screen><userinput role="nodump">make install && +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 -C utils/xindy install && make -C ../utils/asymptote install</userinput></screen> <para>One part of the package remains to be rebuilt: diff -Naur base-book/pst/typesetting/tex-path.xml working-book-3/pst/typesetting/tex-path.xml --- base-book/pst/typesetting/tex-path.xml 1970-01-01 01:00:00.000000000 +0100 +++ working-book-3/pst/typesetting/tex-path.xml 2014-10-21 00:14:45.186137704 +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 <ARCH>-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/') && +cat >> /etc/profile.d/extrapaths.sh << EOF +pathappend /opt/texlive/&texlive-year;/texmf-dist/doc/man MANPATH +pathappend /opt/texlive/&texlive-year;/texmf-dist/doc/info INFOPATH +pathappend /opt/texlive/&texlive-year;/bin/$TEXARCH +EOF +unset TEXARCH</userinput></screen> + + <!-- commented, they have been removed + <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> + + <para>Alternatively, if you do not wish to install the programs for asy, + xindy, and biber (on a from-source build) you can stop here.</para> + +</sect1> diff -Naur base-book/pst/typesetting/tl-installer.xml working-book-3/pst/typesetting/tl-installer.xml --- base-book/pst/typesetting/tl-installer.xml 2014-10-12 03:35:15.380871692 +0100 +++ working-book-3/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 <ARCH>-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/') && -cat >> /etc/profile.d/extrapaths.sh << 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-3/pst/typesetting/typesetting.xml --- base-book/pst/typesetting/typesetting.xml 2014-08-30 05:50:42.499575984 +0100 +++ working-book-3/pst/typesetting/typesetting.xml 2014-10-20 23:51:28.204509311 +0100 @@ -15,10 +15,40 @@ <title>Typesetting</title> - <para>This chapter includes applications that create output equivalent to - typesetting.</para> + <para>This chapter includes <application>texlive</application> applications that + create output equivalent to typesetting.</para> + + <para>There are two alternative routes through this chapter:</para> + + <para>Some people may wish to use the binary installer, either because of the + complexity of installing all of <application>texlive</application> from + source, or because they only want a part of the package, or perhaps because + they wish to get updates as soon as those are available (the source is only + updated annually). These people should follow the <xref + linkend="tl-installer"/> instructions,. After installing, they can run + <command>tlmgr</command> to update their system.</para> + + <para>Most people reading BLFS will wish to build from source. You can either + do as BLFS used to do, by starting with <application>install-tl-unx</application>, + or you can avoid the binary files completely and begin at + <xref linkend="texpass1"/> which will install most of + <application>texlive</application>, together with <emphasis>all</emphasis> of the + supporting files. This almost-complete install is then used to build two + remaining parts of <application>texlive</application>, xindy and asy (that + involves recompiling all of the package, but not reinstalling all of it).</para> + + <para>Because the texmf files (including documentation, fonts, scripts and + supporting files) are all in one tarball, it is not practical to limit what + gets extracted in a sensible way (e.g. to exclude one or other of the typesetting + engines).</para> + + <para>After that, people building from source will wish to install <xref + linkend="biber"/>, which is supplied separately, to complete the full + installation.</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="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
