Author: ken
Date: Mon Aug 28 12:55:17 2017
New Revision: 19118
Log:
Rustc-1.19.0, archive llvm-3 and also the separate cargo which is now installed
by rust.
Added:
trunk/BOOK/archive/cargo.xml
- copied unchanged from r19117, trunk/BOOK/general/prog/cargo.xml
trunk/BOOK/archive/llvm3.xml
- copied unchanged from r19117, trunk/BOOK/general/prog/llvm3.xml
Deleted:
trunk/BOOK/general/prog/cargo.xml
trunk/BOOK/general/prog/llvm3.xml
Modified:
trunk/BOOK/general.ent
trunk/BOOK/general/prog/prog.xml
trunk/BOOK/general/prog/rust.xml
trunk/BOOK/introduction/welcome/changelog.xml
trunk/BOOK/packages.ent
trunk/BOOK/xsoft/graphweb/firefox.xml
Copied: trunk/BOOK/archive/cargo.xml (from r19117,
trunk/BOOK/general/prog/cargo.xml)
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ trunk/BOOK/archive/cargo.xml Mon Aug 28 12:55:17 2017
(r19118, copy of r19117, trunk/BOOK/general/prog/cargo.xml)
@@ -0,0 +1,263 @@
+<?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 cargo-download-http
"https://github.com/rust-lang/cargo/archive/&cargo-version;/cargo-&cargo-version;.tar.gz";>
+ <!ENTITY cargo-download-ftp " ">
+ <!ENTITY cargo-md5sum "c0bdbfdeead6a7cdfd7fbfe2183bfc61">
+ <!ENTITY cargo-size "624 KB">
+ <!ENTITY cargo-buildsize "129 MB plus extra 115 MB in ~/.cargo and 2.2GB
for the testsuite">
+ <!ENTITY cargo-time "1.8 SBU plus 2.4 SBU for the testsuite on a
machine with 4 cores">
+
+ <!-- RUSTIDATE is deined in packages.ent -->
+ <!-- temporarily at higgs so people can download it -->
+ <!ENTITY rusti-download-http
"&sources-anduin-http;/rust/rust-installer-&RUSTIDATE;.tar.xz">
+ <!ENTITY rusti-md5sum "8fb6c87f12d735b0a8bc1304d7640c69">
+ <!ENTITY rusti-size "18 KB">
+
+ <!-- similarly, CARGOPREV is defined in packages.ent -->
+ <!ENTITY cargoprev64-download-http
"https://static.rust-lang.org/dist/cargo-&CARGOPREV;-x86_64-unknown-linux-gnu.tar.gz";>
+ <!ENTITY cargoprev64-md5sum "ad2b513d591f35271f1041e2e04f484c">
+ <!ENTITY cargoprev64-size "4.4 MB">
+ <!ENTITY cargoprev32-download-http
"https://static.rust-lang.org/dist/cargo-&CARGOPREV;-i686-unknown-linux-gnu.tar.gz";>
+ <!ENTITY cargoprev32-md5sum "24d4eda62991bfbaecb3a6d1e09df143">
+ <!ENTITY cargoprev32-size "4.3 MB">
+]>
+
+<sect1 id="cargo" xreflabel="cargo-&cargo-version;">
+ <?dbhtml filename="cargo.html"?>
+
+ <sect1info>
+ <othername>$LastChangedBy$</othername>
+ <date>$Date$</date>
+ </sect1info>
+
+ <title>Cargo-&cargo-version;</title>
+
+ <indexterm zone="cargo">
+ <primary sortas="a-cargo">Cargo</primary>
+ </indexterm>
+
+ <sect2 role="package">
+ <title>Introduction to cargo</title>
+
+ <para>
+ <application>Cargo</application> is the Package Manager for
+ <application>Rust</application>. Like that, during the build it uses
+ <command>curl</command> to download <filename>cargo</filename> files
+ which are actually <filename>.tar.gz</filename> source archives.
+ </para>
+
+ <para>
+ This package requires internet access to build and at runtime (when
+ <command>rust</command> is compiling another package). It will use all
+ available cores. It also needs the current or previous version to compile
+ itself, so here a binary of the previous version is used to bootstrap.
+ </para>
+
+ &lfs80_checked;
+
+ <bridgehead renderas="sect3">Package Information</bridgehead>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Download (HTTP): <ulink url="&cargo-download-http;"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Download (FTP): <ulink url="&cargo-download-ftp;"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Download MD5 sum: &cargo-md5sum;
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Download size: &cargo-size;
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Estimated disk space required: &cargo-buildsize;
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Estimated build time: &cargo-time;
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>Rust Installer:
+ <ulink url="&rusti-download-http;"/></para>
+ </listitem>
+ <listitem>
+ <para>Installer MD5 sum: &rusti-md5sum;</para>
+ </listitem>
+ <listitem>
+ <para>Installer size: &rusti-size;</para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>Binary download (x86_64):
+ <ulink url="&cargoprev64-download-http;"/></para>
+ </listitem>
+ <listitem>
+ <para>Binary x86_64 MD5 sum: &cargoprev64-md5sum;</para>
+ </listitem>
+ <listitem>
+ <para>Binary x86_64 download size: &cargoprev64-size;</para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>Binary download (i686):
+ <ulink url="&cargoprev32-download-http;"/></para>
+ </listitem>
+ <listitem>
+ <para>Binary i686 MD5 sum: &cargoprev32-md5sum;</para>
+ </listitem>
+ <listitem>
+ <para>Binary i686 download size: &cargoprev32-size;</para>
+ </listitem>
+ </itemizedlist>
+
+ <bridgehead renderas="sect3">Cargo Dependencies</bridgehead>
+
+ <bridgehead renderas="sect4">Required</bridgehead>
+ <para role="required">
+ <xref linkend="cmake"/>,
+ <xref linkend="rust"/>
+ </para>
+
+ <bridgehead renderas="sect4">Optional</bridgehead>
+ <para role="optional">
+ <xref linkend="git"/>,
+ <xref linkend="openssl"/>
+ </para>
+
+ <para condition="html" role="usernotes">
+ User Notes: <ulink url="&blfs-wiki;/cargo"/>
+ </para>
+ </sect2>
+
+ <sect2 role="installation">
+ <title>Installation of cargo</title>
+
+ <para>
+ Install <application>cargo</application> by running the following
+ commands:
+ </para>
+
+<screen><userinput>tar -xf ../rust-installer-&RUSTIDATE;.tar.xz \
+ --strip-components=1 --directory src/rust-installer &&
+
+case $(uname -m) in
+ x86_64) tar -xf ../cargo-&CARGOPREV;-x86_64-unknown-linux-gnu.tar.gz
+ ;;
+ i686) tar -xf ../cargo-&CARGOPREV;-i686-unknown-linux-gnu.tar.gz
+ ;;
+esac &&
+
+./configure --prefix=/usr \
+ --sysconfdir=/etc \
+ --docdir=/usr/share/doc/cargo-&cargo-version; \
+ --cargo=./cargo-nightly*/cargo/bin/cargo &&
+make</userinput></screen>
+
+ <para>
+ To test the results, issue: <command>CFG_DISABLE_CROSS_TESTS=1
+ ./target/*-unknown-linux-gnu/release/cargo test</command>.
+ </para>
+
+ <para>
+ Now, as the <systemitem class="username">root</systemitem> user:
+ </para>
+
+<screen role="root"><userinput>make install &&
+mv -v /usr/etc/bash_completion.d/cargo
/etc/bash_completion.d</userinput></screen>
+ </sect2>
+
+ <sect2 role="commands">
+ <title>Command Explanations</title>
+
+ <para>
+ <command>tar -xf ../rust-installer-&RUSTIDATE;.tar.xz ...</command>:
+ The rust-installer is needed, but not shipped with
+ <application>cargo</application>, so BLFS provides a repackaged git
+ snapshot.
+ </para>
+
+ <para>
+ <parameter>--cargo=</parameter>: This points to the binary of the
previous
+ version, so that the package can be bootstrapped. When upgrading, or if
+ rebuilding, it is possible to use the current installed version without
+ this switch, but that takes longer and uses more space.
+ </para>
+
+ <para>
+ <command>CFG_DISABLE_CROSS_TESTS=1 ...</command>: By default the tests
+ will try to cover cross-builds for other architectures, but BLFS only
+ installs <command>rust</command> for the host architecture. This switch
+ also points to where cargo has been created, using a wildcard to match
the
+ one target-triple directory which has been created.
+ </para>
+
+ <para>
+ <command>mv -v /usr/etc/bash_completion.d/cargo ...</command>: Cargo
+ accepts the sysconfdir switch but does not respect it. This fixes up the
+ misplaced file.
+ </para>
+ </sect2>
+
+ <sect2 role="content">
+ <title>Contents</title>
+
+ <segmentedlist>
+ <segtitle>Installed Program(s)</segtitle>
+ <segtitle>Installed Librar(y,ies)</segtitle>
+ <segtitle>Installed Director(y,ies)</segtitle>
+
+ <seglistitem>
+ <seg>
+ cargo
+ </seg>
+ <seg>
+ None
+ </seg>
+ <seg>
+ /usr/share/doc/cargo-&cargo-version; and
+ /usr/share/zsh/site-functions.
+ </seg>
+ </seglistitem>
+ </segmentedlist>
+
+ <variablelist>
+ <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+ <?dbfo list-presentation="list"?>
+ <?dbhtml list-presentation="table"?>
+
+ <varlistentry id="cargo-prog">
+ <term><command>cargo</command></term>
+ <listitem>
+ <para>
+ is the Package Manager for Rust.
+ </para>
+ <indexterm zone="cargo cargo-prog">
+ <primary sortas="b-cargo">cargo</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </sect2>
+</sect1>
Copied: trunk/BOOK/archive/llvm3.xml (from r19117,
trunk/BOOK/general/prog/llvm3.xml)
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ trunk/BOOK/archive/llvm3.xml Mon Aug 28 12:55:17 2017
(r19118, copy of r19117, trunk/BOOK/general/prog/llvm3.xml)
@@ -0,0 +1,253 @@
+<?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;
+
+ <!-- for the moment, this is internally llvm-old but visibly llvm3
+ so that when rust eventually understands a less-old version the
+ visible fields, and the page itself, can be moved to that newer
+ number -->
+ <!ENTITY llvm-old-download-http
"http://llvm.org/releases/&llvm-old-version;/llvm-&llvm-old-version;.src.tar.xz";>
+ <!ENTITY llvm-old-download-ftp " ">
+ <!ENTITY llvm-old-md5sum "3259018a7437e157f3642df80f1983ea">
+ <!ENTITY llvm-old-size "18 MB">
+ <!ENTITY llvm-old-buildsize "663 MB (112 MB installed) plus 101 MB for
the testsuite">
+ <!ENTITY llvm-old-time "6.9 SBU (plus 1.8 SBU for the testsuite,
both with parallelism=4)">
+]>
+
+<sect1 id="llvm-old" xreflabel="LLVM-&llvm-old-version;">
+ <?dbhtml filename="llvm-old.html"?>
+
+ <sect1info>
+ <othername>$LastChangedBy$</othername>
+ <date>$Date$</date>
+ </sect1info>
+
+ <title>LLVM-&llvm-old-version;</title>
+
+ <indexterm zone="llvm-old">
+ <primary sortas="a-llvm3">LLVM3</primary>
+ </indexterm>
+
+ <sect2 role="package">
+ <title>Introduction to llvm3</title>
+
+ <para>
+ This is an old version of <application>llvm</application>, installed
+ in /opt so that <xref linkend="rust"/> can use it. For normal use you
+ should install <xref linkend="llvm"/>.
+ </para>
+
+ <para>
+ This version of the <application>LLVM</application> package contains old
+ versions of the libraries, using the API which
+ <application>Rust</application> expects. Although <xref linkend="rust"/>
+ ships with a version of LLVM-3.9 and will build and link to it
statically,
+ its <application>rustbuild</application> build-system will always compile
+ a large number of cross-compilers for different architectures. Using a
+ separate LLVM avoids that.
+ </para>
+
+ <para>
+ By using a separate <application>LLVM-3.9.1</application> it will be
+ possible to save time when upgrading <application>Rust</application> (the
+ overall time for the first build will be similar both with and without
+ separate <application>LLVM-3.9.1</application>).
+ </para>
+
+ &lfs80_checked;
+
+ <bridgehead renderas="sect3">Package Information</bridgehead>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Download (HTTP): <ulink url="&llvm-old-download-http;"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Download (FTP): <ulink url="&llvm-old-download-ftp;"/>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Download MD5 sum: &llvm-old-md5sum;
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Download size: &llvm-old-size;
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Estimated disk space required: &llvm-old-buildsize;
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Estimated build time: &llvm-old-time;
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <bridgehead renderas="sect3">llvm3 Dependencies</bridgehead>
+
+ <bridgehead renderas="sect4">Required</bridgehead>
+ <para role="required">
+ <xref linkend="cmake"/>
+ </para>
+
+ <bridgehead renderas="sect4">Recommended</bridgehead>
+ <para role="recommended">
+ <xref linkend="python2"/>
+ </para>
+
+ <bridgehead renderas="sect4">Optional</bridgehead>
+ <para role="optional">
+ <xref linkend="doxygen"/>,
+ <xref linkend="graphviz"/>,
+ <xref linkend="libffi"/> (if you force this to be
+ used, the build of <xref linkend="rust"/> will need to be altered)
+ <xref linkend="libxml2"/>,
+ <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>),
+ <xref linkend="valgrind"/>,
+ <xref linkend="zip"/>,
+ <ulink url="http://www.ocaml.org/";>OCaml</ulink>, and
+ <ulink url="https://pypi.python.org/pypi/Sphinx";>Sphinx</ulink>
+ </para>
+
+ <para condition="html" role="usernotes">
+ User Notes: <ulink url="&blfs-wiki;/llvm3"/>
+ </para>
+ </sect2>
+
+ <sect2 role="installation">
+ <title>Installation of llvm3</title>
+
+ <para>
+ Install <application>llvm3</application> by running the following
+ commands:
+ </para>
+
+<screen><userinput>mkdir -v build &&
+cd build &&
+
+CC=gcc CXX=g++ \
+cmake -DCMAKE_INSTALL_PREFIX=/opt/llvm3 \
+ -DCMAKE_BUILD_TYPE=Release \
+ -DLLVM_BUILD_LLVM_DYLIB=ON \
+ -DLLVM_LINK_LLVM_DYLIB=ON \
+ -DLLVM_TARGETS_TO_BUILD="host" \
+ -DLLVM_INSTALL_UTILS=ON \
+ -Wno-dev .. &&
+make</userinput></screen>
+
+ <para>
+ To test the results, issue: <command>make check-all</command>. The tests
+ are run using the maximum number of processors/threads available, but the
+ main part of the added time is spent compiling the test programs. This
+ works fine with parallel make.
+ </para>
+
+ <para>
+ Now, as the <systemitem class="username">root</systemitem> user:
+ </para>
+
+<screen role="root"><userinput>echo "/opt/llvm3/lib" >> /etc/ld.so.conf
&&
+make install &&
+/sbin/ldconfig &&
+ln -sfv /opt/llvm3/bin/FileCheck /usr/bin</userinput></screen>
+
+ <para>
+ Building the documentation for <emphasis>current</emphasis> LLVM is
+ covered in <xref linkend="llvm"/>, building docs for this old version
+ would be similar, but almost everyone who needs this old version will
+ also need the current version for <xref linkend="mesa"/> so it is
+ redundant to install the docs here.
+ </para>
+
+ </sect2>
+
+ <sect2 role="commands">
+ <title>Command Explanations</title>
+
+ <para>
+ <parameter>-DLLVM_INSTALL_UTILS_=ON</parameter>: This switch enables
+ the installation of old utility programs. Of those,
+ <application>rust</application> looks for <command>FileCheck</command>
+ when its configure checks for a system LLVM, the others are not used.
+ </para>
+
+ <para>
+ <parameter>/sbin/ldconfig</parameter>: This ensures the libraries can be
+ found.
+ </para>
+
+ <para>
+ <parameter>ln -sfv /opt/llvm3/bin/FileCheck /usr/bin</parameter>: This
+ ensures that FileCheck can be found by <application>rust</application>
+ even though <filename class="directory">/opt/llvm3/bin</filename> is not
+ on the PATH (having two versions of <application>LLVM</application>
+ generally available has been known to cause pain).
+ </para>
+
+ </sect2>
+
+ <sect2 role="content">
+ <title>Contents</title>
+
+ <segmentedlist>
+ <segtitle>Installed Program(s)</segtitle>
+ <segtitle>Installed Librar(y,ies)</segtitle>
+ <segtitle>Installed Director(y,ies)</segtitle>
+
+ <seglistitem>
+ <seg>
+ bugpoint, count, FileCheck,
+ llc, lli, llvm-ar, llvm-as, llvm-bcanalyzer, llvm-config, llvm-cov,
+ llvm-c-test, llvm-cxxdump, llvm-diff, llvm-dis, llvm-dsymutil,
+ llvm-dwarfdump, llvm-dwp, llvm-extract, llvm-lib (symlink to
+ llvm-ar), llvm-link, llvm-lto, llvm-mc, llvm-mcmarkup, llvm-nm,
+ llvm-objdump, llvm-pdbdump, llvm-profdata, llvm-ranlib (symlink to
+ llvm-ar), llvm-readobj, llvm-rtdyld, llvm-size, llvm-split,
+ llvm-stress, llvm-symbolizer, llvm-tblgen, not, obj2yaml, opt,
sancov,
+ sanstats, verify-uselistorder, yaml-bench and yaml2obj
+ </seg>
+ <seg>
+ BugpointPasses.so, LLVMHello.so, libLLVM.so, libLLVM*.a (50
+ libraries), libLTO.so
+ </seg>
+ <seg>
+ /opt/llvm3
+ </seg>
+ </seglistitem>
+ </segmentedlist>
+
+ <variablelist>
+ <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+ <?dbfo list-presentation="list"?>
+ <?dbhtml list-presentation="table"?>
+
+ <varlistentry id="FileCheck">
+ <term><command>FileCheck</command></term>
+ <listitem>
+ <para>
+ reads two files (one from standard input,the other specified on the
+ command line) and uses one to verify the other.
+ </para>
+ <indexterm zone="llvm-old FileCheck">
+ <primary sortas="b-FileCheck">FileCheck</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ For details of the other items in this package, see <xref
linkend="llvm"/>.
+ </para>
+
+ </sect2>
+</sect1>
Modified: trunk/BOOK/general.ent
==============================================================================
--- trunk/BOOK/general.ent Sun Aug 27 21:25:25 2017 (r19117)
+++ trunk/BOOK/general.ent Mon Aug 28 12:55:17 2017 (r19118)
@@ -1,12 +1,12 @@
<!-- $LastChangedBy$ $Date$ -->
-<!ENTITY day "27"> <!-- Always 2 digits -->
+<!ENTITY day "28"> <!-- Always 2 digits -->
<!ENTITY month "08"> <!-- Always 2 digits -->
<!ENTITY year "2017">
<!ENTITY copyrightdate "2001-&year;">
<!ENTITY copyholder "The BLFS Development Team">
<!ENTITY version "&year;-&month;-&day;">
-<!ENTITY releasedate "August 27th, &year;">
+<!ENTITY releasedate "August 28th, &year;">
<!ENTITY pubdate "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
<!ENTITY blfs-version "svn"> <!-- svn|[release #] -->
<!ENTITY lfs-version "development"> <!-- x.y|development -->
Modified: trunk/BOOK/general/prog/prog.xml
==============================================================================
--- trunk/BOOK/general/prog/prog.xml Sun Aug 27 21:25:25 2017 (r19117)
+++ trunk/BOOK/general/prog/prog.xml Mon Aug 28 12:55:17 2017 (r19118)
@@ -24,7 +24,6 @@
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
href="autoconf213.xml"/>
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
href="bazaar.xml"/> -->
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="cargo.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="check.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="clisp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="cmake.xml"/>
@@ -42,7 +41,6 @@
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="git.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="guile.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="librep.xml"/>
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="llvm3.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="llvm.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="lua.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="mercurial.xml"/>
Modified: trunk/BOOK/general/prog/rust.xml
==============================================================================
--- trunk/BOOK/general/prog/rust.xml Sun Aug 27 21:25:25 2017 (r19117)
+++ trunk/BOOK/general/prog/rust.xml Mon Aug 28 12:55:17 2017 (r19118)
@@ -6,10 +6,10 @@
<!ENTITY rust-download-http
"https://static.rust-lang.org/dist/rustc-&rust-version;-src.tar.gz";>
<!ENTITY rust-download-ftp "">
- <!ENTITY rust-md5sum "c11d94d9e62f71838b20058f0797357a">
- <!ENTITY rust-size "28 MB">
- <!ENTITY rust-buildsize "1.5 GB (208 MB installed) plus 118MB for cargo
files">
- <!ENTITY rust-time "14 SBU (with 4 processors)">
+ <!ENTITY rust-md5sum "75e779670ac79edf023497a9c37eb35d">
+ <!ENTITY rust-size "48 MB">
+ <!ENTITY rust-buildsize "4.2 GB (362 MB installed), (add 0.6GB for
tests) plus 273MB for ~/.cargo files">
+ <!ENTITY rust-time "33 SBU (add 14 SBU for tests, both with 4
processors)">
]>
<sect1 id="rust" xreflabel="rustc-&rust-version;">
@@ -50,12 +50,10 @@
<para>
At the moment <application>Rust</application> does not provide any
- guarantees of a stable ABI, and it is likely that the next few versions
- of <application>firefox</application> will each require the latest
version
- of <application>Rust</application>.
+ guarantees of a stable ABI.
</para>
- &lfs80_checked;
+ &lfs81_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
@@ -96,21 +94,13 @@
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="curl"/>,
- <xref linkend="cmake"/> (if not using the recommended <xref
linkend="llvm-old"/>),
+ <xref linkend="cmake"/>,
<xref linkend="python2"/>
</para>
- <bridgehead renderas="sect4">Recommended</bridgehead>
- <para role="recommended">
- <!-- acceptable versions of llvm are listed in the tests
- of LLVM_VERSION in configure, currently 3.{7-9}* -->
- <xref linkend="llvm-old"/>
- </para>
-
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
- <xref linkend="gdb"/> (often required for the testsuite, but some of the
- gdb tests may still fail),
+ <xref linkend="gdb"/> (used by debuginfo-gdb in the testsuite),
<xref linkend="ninja"/>
</para>
@@ -122,81 +112,108 @@
<sect2 role="installation">
<title>Installation of Rust</title>
+ <note>
+ <para>
+ This package is updated on a six-weekly release cycle. Because it is
+ such a large and slow package to build, and is at the moment only used
+ by one package in this book, the BLFS editors take the view that it
+ should only be updated when that is necessary.
+ </para>
+ </note>
+
<para>
- Install <application>Rust</application> by running the following
+ First create a suitable <filename>config.toml</filename> file
+ which will configure the build :
+ </para>
+
+<screen><userinput>cat <<EOF > config.toml
+# see src/bootstrap/config.toml.example for more possible options
+[llvm]
+targets = "X86"
+
+[build]
+# install cargo as well as rust
+extended = true
+
+[install]
+prefix = "/usr"
+docdir = "share/doc/rustc-1.19.0"
+channel = "stable"
+EOF</userinput></screen>
+
+ <para>
+ Now install <application>Rust</application> by running the following
commands:
</para>
-<screen><userinput>./configure --prefix=/usr \
- --llvm-root=/opt/llvm3 \
- --enable-llvm-link-shared \
- --docdir=/usr/share/doc/rustc-&rust-version; &&
-./x.py build</userinput></screen>
-
- <para>
- The testsuite in this package selects random subsets of the
- possible tests. There is no correlation between how long a
- particular run of the testsuite takes, and how many tests
- were run. On occasion, the chosen tests will run in much
- less than 1.0 SBU, on other occasions they may take more
- than 20 SBU. Although it is normal to run the testsuite for
- a compiler, in this case that is very hard to recommend.
+<screen><userinput>./x.py build</userinput></screen>
+
+ <para>
+ To run the tests issue
+ <command>./x.py test --verbose --no-fail-fast
>../rustc-testlog</command>:
+ as with the build, that will use all available CPUs. This runs maniy
suites
+ of tests (in an apparently random order), three may fail:
+ compile-fail/issue-37131.rs and run-make/target-without-atomics both try
to
+ compile for the thumbv6m-none-eabi target, but the BLFS build does not
cater for
+ that, and all 105 tests in debuginfo-gdb will fail if
+ <application>gdb</application> has not been installed.
</para>
<para>
- Nevertheless, if you insist on running the tests issue
- <command>./x.py test</command>: as with the build, that will
- use all available CPUs.
+ If you wish to look at the numbers for the results, you can find the
total
+ number of tests which were considered by running:
</para>
+<screen><command>grep 'running .* tests' ../rustc-testlog | awk '{ sum += $2 }
END { print sum }'</command></screen>
+
<para>
- Now, as the <systemitem class="username">root</systemitem> user:
+ That should report 14029 tests. Similarly, the total tests which failed
can
+ be found by running:
</para>
-<screen role="root"><userinput>test -f /usr/lib/libLLVM-3.9.so ||
- ln -sv /opt/llvm3/lib/libLLVM-3.9.so /usr/lib &&
+<screen><command>grep '^test result:' ../rustc-testlog | awk '{ sum += $6 }
END { print sum }'</command></screen>
-./x.py dist --install</userinput></screen>
+ <para>
+ And similarly for the tests which passed use $4, for those which were
ignored
+ (i.e. skipped) use $8 (and $10 for 'measured', $12 for 'filtered out'
but both
+ are probably zero). The breakdown does not match the overall total.
+ </para>
+
+ <para>
+ Now, as the <systemitem class="username">root</systemitem> user:
+ </para>
+
+<screen role="root"><userinput>./x.py dist --install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
- <command>--llvm-root=/opt/llvm3 --enable-llvm-link-shared</command>:
- This tells rust to use the system version of llvm3 installed in
- <filename class="directory">/opt/llvm3</filename>, linking to the
- shared libraries.
+ <command>targets = "X86"</command>: this avoids building all the
available
+ linux cross-compilers (Aarch64, MIPS, PowerPC, SystemZ, etc).
+ </para>
+
+ <para>
+ <command>extended = true</command>: this installs Cargo alongside Rust.
</para>
<para>
- <option>--enable-dist-host-only</option>: If you did not install a
- system version of <xref linkend="llvm-old"/>, use this alternative
command
- to build the shipped static version of llvm. It will
- <emphasis>compile</emphasis> for all the available linux cross-compilers
- (Aarch64, MIPS, PowerPC, SystemZ, etc) but with this switch it will only
- <emphasis>install</emphasis> for the host architecture.
+ <command>channel = "stable"</command>: this ensures only stable features
+ can be used, the default in <filename>config.toml</filename> is to use
+ development features, which is not appropriate for a released version.
</para>
<para>
- <option>RUSTFLAGS="$RUSTFLAGS -C link-args=-lffi"</option>: use this if
- you need to link against a version of LLVM-3 which was compiled against
- <xref linkend="libffi"/>.
+ <command>--verbose</command>: this switch can sometimes provide more
+ information about a test which fails.
</para>
<para>
- <command>ln -sv /opt/llvm3/lib/libLLVM-3.9.so /usr/lib</command>:
- Although the <emphasis>build</emphasis> of
<application>Rust</application>
- finds the shared library in
- <filename class="directory">/opt/llvm3/lib</filename>, several of the
steps
- run by the <application>rustbuild</application>
- <emphasis>installer</emphasis> do not find
- <filename>libLLVM-3.9.so</filename>. This conditional symlink fixes that,
- and works even if <filename>libLLVM-3.9.{0,1}</filename> has already been
- installed in <filename class="directory">/usr</filename>.
- <emphasis>Omit this command if you did not install a system version of
- <xref linkend="llvm-old"/></emphasis>.
+ <command>--no-fail-fast</command>: this switch ensures that the testsuite
+ will not stop at the first error.
</para>
+
</sect2>
<sect2 role="content">
@@ -209,18 +226,16 @@
<seglistitem>
<seg>
- rust-gdb, rust-lldb, rustc, rustdoc.
+ cargo, rust-gdb, rust-lldb, rustc, rustdoc.
</seg>
<seg>
- Many libraries (libarena, libflate, libfmt_macros, libgetopts,
- libgraphviz, liblog, libproc_macro, librustc*, libserialize,
- libstd, libsyntax, libterm, libtest), all containing a hash in
- their names.
+ Many lib*<16-byte-hash>.so libraries.
</seg>
<seg>
~/.cargo,
- /usr/lib/rustlib, and
- /usr/share/doc/rustc-&rust-version;.
+ /usr/lib/rustlib,
+ /usr/share/doc/rustc-&rust-version;, and
+ /usr/share/zsh/site-functions/
</seg>
</seglistitem>
</segmentedlist>
@@ -230,6 +245,18 @@
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
+ <varlistentry id="cargo">
+ <term><command>cargo</command></term>
+ <listitem>
+ <para>
+ is the Package Manager for Rust.
+ </para>
+ <indexterm zone="rust cargo">
+ <primary sortas="b-cargo">cargo</primary>
+ </indexterm>
+ </listitem>
+ </varlistentry>
+
<varlistentry id="rust-gdb">
<term><command>rust-gdb</command></term>
<listitem>
Modified: trunk/BOOK/introduction/welcome/changelog.xml
==============================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml Sun Aug 27 21:25:25
2017 (r19117)
+++ trunk/BOOK/introduction/welcome/changelog.xml Mon Aug 28 12:55:17
2017 (r19118)
@@ -43,6 +43,17 @@
-->
<listitem>
+ <para>August 28th, 2017</para>
+ <itemizedlist>
+ <listitem>
+ <para>[ken] - Update to rustc-1.19.0 and drop separate
+ LLVM-3 and Cargo. Fixes
+ <ulink url="&blfs-ticket-root;9652">#9652</ulink>.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
<para>August 27th, 2017</para>
<itemizedlist>
<listitem>
Modified: trunk/BOOK/packages.ent
==============================================================================
--- trunk/BOOK/packages.ent Sun Aug 27 21:25:25 2017 (r19117)
+++ trunk/BOOK/packages.ent Mon Aug 28 12:55:17 2017 (r19118)
@@ -289,10 +289,6 @@
<!-- Chapter 13 -->
<!ENTITY autoconf213-version "2.13">
<!ENTITY bazaar-version "2.5.1">
-<!ENTITY cargo-version "0.17.0">
-<!-- extras for cargo install, previous version for binaries, rust installer
date -->
-<!ENTITY CARGOPREV "0.16.0">
-<!ENTITY RUSTIDATE "20161004">
<!ENTITY check-version "0.11.0">
<!ENTITY clisp-version "2.49">
<!ENTITY cmake-major-version "3.9">
@@ -324,7 +320,7 @@
<!ENTITY ruby-minor-version "2.4">
<!ENTITY ruby-patch-version "1">
<!ENTITY ruby-version
"&ruby-minor-version;.&ruby-patch-version;">
-<!ENTITY rust-version "1.16.0">
+<!ENTITY rust-version "1.19.0">
<!ENTITY scons-version "2.5.1">
<!ENTITY slang-version "2.3.1">
<!ENTITY subversion-version "1.9.7">
Modified: trunk/BOOK/xsoft/graphweb/firefox.xml
==============================================================================
--- trunk/BOOK/xsoft/graphweb/firefox.xml Sun Aug 27 21:25:25 2017
(r19117)
+++ trunk/BOOK/xsoft/graphweb/firefox.xml Mon Aug 28 12:55:17 2017
(r19118)
@@ -110,7 +110,6 @@
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="autoconf213"/>,
- <xref linkend="cargo"/>,
both <xref linkend="gtk3"/> and
<xref linkend="gtk2"/>,
<xref linkend="nss"/>,
@@ -118,6 +117,7 @@
(or
<xref linkend="alsa-lib"/> if you edit the mozconfig;
now deprecated by mozilla),
+ <xref linkend="rust"/>,
<xref linkend="unzip"/>,
<xref linkend="yasm"/>, and
<xref linkend="zip"/>
--
http://lists.linuxfromscratch.org/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
