diff options
| -rw-r--r-- | appendices/dependencies.xml | 141 | ||||
| -rw-r--r-- | chapter01/changelog.xml | 22 | ||||
| -rw-r--r-- | chapter01/whatsnew.xml | 16 | ||||
| -rw-r--r-- | chapter03/packages.xml | 44 | ||||
| -rw-r--r-- | chapter06/chapter06.xml | 9 | ||||
| -rw-r--r-- | chapter06/libffi.xml | 104 | ||||
| -rw-r--r-- | chapter06/meson.xml | 89 | ||||
| -rw-r--r-- | chapter06/ninja.xml | 108 | ||||
| -rw-r--r-- | chapter06/python.xml | 244 | ||||
| -rw-r--r-- | general.ent | 6 | ||||
| -rw-r--r-- | packages.ent | 46 | ||||
| -rw-r--r-- | prologue/why.xml | 40 |
12 files changed, 857 insertions, 12 deletions
diff --git a/appendices/dependencies.xml b/appendices/dependencies.xml index 9f5929bfb..5c2538346 100644 --- a/appendices/dependencies.xml +++ b/appendices/dependencies.xml @@ -1474,6 +1474,41 @@ </seglistitem> </segmentedlist> +<!-- Begin Libffi dependency info --> + <bridgehead renderas="sect2" id="libffi-dep">Libffi</bridgehead> + + <segmentedlist> + <segtitle>&dependencies;</segtitle> + + <seglistitem> + <seg>Bash, Binutils, Coreutils, GCC, Glibc, Make, and Sed</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&testsuites;</segtitle> + + <seglistitem> + <seg>DejaGnu</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&before;</segtitle> + + <seglistitem> + <seg>Python</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&external;</segtitle> + + <seglistitem> + <seg>None</seg> + </seglistitem> + </segmentedlist> + <!-- Begin Libpipeline dependency info --> <bridgehead renderas="sect2" id="libpipeline-dep">Libpipeline</bridgehead> @@ -1725,6 +1760,41 @@ </seglistitem> </segmentedlist> +<!-- Begin Meson dependency info --> + <bridgehead renderas="sect2" id="meson-dep">Meson</bridgehead> + + <segmentedlist> + <segtitle>&dependencies;</segtitle> + + <seglistitem> + <seg>Ninja and Python</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&testsuites;</segtitle> + + <seglistitem> + <seg>No test suite available</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&before;</segtitle> + + <seglistitem> + <seg>None</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&external;</segtitle> + + <seglistitem> + <seg>None</seg> + </seglistitem> + </segmentedlist> + <!-- Begin MPC dependency info --> <bridgehead renderas="sect2" id="mpc-dep">MPC</bridgehead> @@ -1834,6 +1904,41 @@ </seglistitem> </segmentedlist> +<!-- Begin Ninja dependency info --> + <bridgehead renderas="sect2" id="ninja-dep">Ninja</bridgehead> + + <segmentedlist> + <segtitle>&dependencies;</segtitle> + + <seglistitem> + <seg>Binutils, Coreutils, Gcc, Python</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&testsuites;</segtitle> + + <seglistitem> + <seg>None</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&before;</segtitle> + + <seglistitem> + <seg>Meson</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&external;</segtitle> + + <seglistitem> + <seg>Asciidoc, Doxygen, Emacs, and re2c</seg> + </seglistitem> + </segmentedlist> + <!-- Begin Patch dependency info --> <bridgehead renderas="sect2" id="patch-dep">Patch</bridgehead> @@ -2047,6 +2152,42 @@ </seglistitem> </segmentedlist> +<!-- Begin Python dependency info --> + <bridgehead renderas="sect2" id="python-dep">Python</bridgehead> + + <segmentedlist> + <segtitle>&dependencies;</segtitle> + + <seglistitem> + <seg>Bash, Binutils, Coreutils, GCC, Gettext, Glibc, Grep, + Libffi, Make, Ncurses, and Sed</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&testsuites;</segtitle> + + <seglistitem> + <seg>GDB and Valgrind</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&before;</segtitle> + + <seglistitem> + <seg>Ninja</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&external;</segtitle> + + <seglistitem> + <seg>Berkeley DB, OpenSSL, SQLite, and Tk</seg> + </seglistitem> + </segmentedlist> + <!-- Begin Readline dependency info --> <bridgehead renderas="sect2" id="readline-dep">Readline</bridgehead> diff --git a/chapter01/changelog.xml b/chapter01/changelog.xml index 22a64b069..58fa69fe9 100644 --- a/chapter01/changelog.xml +++ b/chapter01/changelog.xml @@ -43,6 +43,28 @@ appropriate for the entry or if needed the entire day's listitem. --> <listitem> + <para>2017-09-23</para> + <itemizedlist> + <listitem> + <para>[bdubbs] - Add Meson-0.42.1.</para> + </listitem> + <listitem> + <para>[bdubbs] - Add Ninja-1.8.2.</para> + </listitem> + <listitem> + <para>[bdubbs] - Add Python-3.6.2.</para> + </listitem> + <listitem> + <para>[bdubbs] - Add libffi-3.2.1.</para> + </listitem> + <listitem> + <para>[bdubbs] - Update to eudev-3.2.4. Fixes + <ulink url="&lfs-ticket-root;4140">#4140</ulink>.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> <para>2017-09-22</para> <itemizedlist> <listitem> diff --git a/chapter01/whatsnew.xml b/chapter01/whatsnew.xml index b4de26d39..9faf53bad 100644 --- a/chapter01/whatsnew.xml +++ b/chapter01/whatsnew.xml @@ -254,11 +254,21 @@ <title>Added:</title> <listitem><para></para></listitem> <!-- satisfy build --> -<!-- <listitem> - <para>gcc-6.1.0-asan-1.patch</para> + <para>Libff-&libffi-version;</para> + </listitem> + + <listitem> + <para>Python-&python-version;</para> + </listitem> + + <listitem> + <para>Ninja&ninja-version;</para> + </listitem> + + <listitem> + <para>Meson&meson-version;</para> </listitem> ---> </itemizedlist> <itemizedlist> diff --git a/chapter03/packages.xml b/chapter03/packages.xml index 8a5d162b0..d2674a40b 100644 --- a/chapter03/packages.xml +++ b/chapter03/packages.xml @@ -397,6 +397,15 @@ </varlistentry> <varlistentry> + <term>Libffi (&libffi-version;) - <token>&libffi-size;</token>:</term> + <listitem> + <para>Home page: <ulink url="&libffi-home;"/></para> + <para>Download: <ulink url="&libffi-url;"/></para> + <para>MD5 sum: <literal>&libffi-md5;</literal></para> + </listitem> + </varlistentry> + + <varlistentry> <term>Libpipeline (&libpipeline-version;) - <token>&libpipeline-size;</token>:</term> <listitem> <para>Home page: <ulink url="&libpipeline-home;"/></para> @@ -474,6 +483,15 @@ </varlistentry> <varlistentry> + <term>Meson (&meson-version;) - <token>&meson-size;</token>:</term> + <listitem> + <para>Home page: <ulink url="&meson-home;"/></para> + <para>Download: <ulink url="&meson-url;"/></para> + <para>MD5 sum: <literal>&meson-md5;</literal></para> + </listitem> + </varlistentry> + + <varlistentry> <term>MPC (&mpc-version;) - <token>&mpc-size;</token>:</term> <listitem> <para>Home page: <ulink url="&mpc-home;"/></para> @@ -492,6 +510,15 @@ </varlistentry> <varlistentry> + <term>Ninja (&ninja-version;) - <token>&ninja-size;</token>:</term> + <listitem> + <para>Home page: <ulink url="&ninja-home;"/></para> + <para>Download: <ulink url="&ninja-url;"/></para> + <para>MD5 sum: <literal>&ninja-md5;</literal></para> + </listitem> + </varlistentry> + + <varlistentry> <term>Ncurses (&ncurses-version;) - <token>&ncurses-size;</token>:</term> <listitem> <para>Home page: <ulink url="&ncurses-home;"/></para> @@ -546,6 +573,23 @@ </varlistentry> <varlistentry> + <term>Python (&python-version;) - <token>&python-size;</token>:</term> + <listitem> + <para>Home page: <ulink url="&python-home;"/></para> + <para>Download: <ulink url="&python-url;"/></para> + <para>MD5 sum: <literal>&python-md5;</literal></para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Python Documentation (&python-version;) - <token>&python-docs-size;</token>:</term> + <listitem> + <para>Download: <ulink url="&python-docs-url;"/></para> + <para>MD5 sum: <literal>&python-docs-md5;</literal></para> + </listitem> + </varlistentry> + + <varlistentry> <term>Readline (&readline-version;) - <token>&readline-size;</token>:</term> <listitem> <para>Home page: <ulink url="&readline-home;"/></para> diff --git a/chapter06/chapter06.xml b/chapter06/chapter06.xml index 8f4a8f46f..401ce50ee 100644 --- a/chapter06/chapter06.xml +++ b/chapter06/chapter06.xml @@ -38,6 +38,14 @@ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="acl.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libcap.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="sed.xml"/> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="expat.xml"/> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libffi.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="python.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ninja.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="meson.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="shadow.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="psmisc.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="iana-etc.xml"/> @@ -48,7 +56,6 @@ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libtool.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gdbm.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gperf.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="expat.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="inetutils.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="perl.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="xml-parser.xml"/> diff --git a/chapter06/libffi.xml b/chapter06/libffi.xml new file mode 100644 index 000000000..c04a39f69 --- /dev/null +++ b/chapter06/libffi.xml @@ -0,0 +1,104 @@ +<?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="ch-system-libffi" role="wrap"> + <?dbhtml filename="libffi.html"?> + + <sect1info condition="script"> + <productname>libffi</productname> + <productnumber>&libffi-version;</productnumber> + <address>&libffi-url;</address> + </sect1info> + + <title>libffi-&libffi-version;</title> + + <indexterm zone="ch-system-libffi"> + <primary sortas="a-libffi">libffi</primary> + </indexterm> + + <sect2 role="package"> + <title/> + + <para>The libffi library provides a portable, high level programming + interface to various calling conventions. This allows a programmer to call + any function specified by a call interface description at run time.</para> + + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> + + <seglistitem> + <seg>&libffi-ch6-sbu;</seg> + <seg>&libffi-ch6-du;</seg> + </seglistitem> + </segmentedlist> + + </sect2> + + <sect2 role="installation"> + <title>Installation of libffi</title> + + <para>Modify the Makefile to install headers into the standard + <filename class="directory">/usr/include</filename> directory instead of + <filename class="directory">/usr/lib/libffi-3.2.1/include</filename>.</para> + +<screen><userinput remap="pre">sed -e '/^includesdir/ s/$(libdir).*$/$(includedir)/' \ + -i include/Makefile.in + +sed -e '/^includedir/ s/=.*$/=@includedir@/' \ + -e 's/^Cflags: -I${includedir}/Cflags:/' \ + -i libffi.pc.in</userinput></screen> + + <para>Prepare libffi for compilation:</para> + +<screen><userinput remap="configure">./configure --prefix=/usr --disable-static</userinput></screen> + + <para>Compile the package:</para> + +<screen><userinput remap="make">make</userinput></screen> + + <para>To test the results, issue:</para> + +<screen><userinput remap="test">make check</userinput></screen> + + <para>Install the package:</para> + +<screen><userinput remap="install">make install</userinput></screen> + + </sect2> + + <sect2 id="contents-libffi" role="content"> + <title>Contents of libffi</title> + + <segmentedlist> + <segtitle>Installed library</segtitle> + + <seglistitem> + <seg>libffi.so</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="libffi"> + <term><filename class="libraryfile">libffi</filename></term> + <listitem> + <para>contains the libffi API functions.</para> + <indexterm zone="ch-system-libffi"> + <primary sortas="c-libffi">libffi</primary> + </indexterm> + </listitem> + </varlistentry> + </variablelist> + + </sect2> + +</sect1> + diff --git a/chapter06/meson.xml b/chapter06/meson.xml new file mode 100644 index 000000000..5bc2fce6b --- /dev/null +++ b/chapter06/meson.xml @@ -0,0 +1,89 @@ +<?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="ch-system-meson" role="wrap"> + <?dbhtml filename="meson.html"?> + + <sect1info condition="script"> + <productname>meson</productname> + <productnumber>&meson-version;</productnumber> + <address>&meson-url;</address> + </sect1info> + + <title>Meson-&meson-version;</title> + + <indexterm zone="ch-system-meson"> + <primary sortas="a-Meson">Meson</primary> + </indexterm> + + <sect2 role="package"> + <title/> + + <para>Meson is an open source build system meant to be both extremely fast, + and, even more importantly, as user friendly as possible.</para> + + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> + <seglistitem> + <seg>&meson-ch6-sbu;</seg> + <seg>&meson-ch6-du;</seg> + </seglistitem> + </segmentedlist> + + </sect2> + + <sect2 role="installation"> + <title>Installation of Meson</title> + + <para>Compile Meson with the following command:</para> + +<screen><userinput remap="make">python3 setup.py build</userinput></screen> + + <para>This package does not come with a test suite.</para> + + <para>Install the package:</para> + +<screen><userinput remap="install">python3 setup.py install</userinput></screen> + + </sect2> + + + <sect2 id="contents-meson" role="content"> + <title>Contents of Meson</title> + + <segmentedlist> + <segtitle>Installed Libraries</segtitle> + <segtitle>Installed directory</segtitle> + + <seglistitem> + <seg>libmeson.so</seg> + <seg>/usr/share/doc/meson-&meson-version;</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="libmeson"> + <term><filename class="libraryfile">libmeson</filename></term> + <listitem> + <para>Contains multiple-precision math functions</para> + <indexterm zone="ch-system-meson libmeson"> + <primary sortas="c-libmeson">libmeson</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> + diff --git a/chapter06/ninja.xml b/chapter06/ninja.xml new file mode 100644 index 000000000..28db9df21 --- /dev/null +++ b/chapter06/ninja.xml @@ -0,0 +1,108 @@ +<?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="ch-system-ninja" role="wrap"> + <?dbhtml filename="ninja.html"?> + + <sect1info condition="script"> + <productname>ninja</productname> + <productnumber>&ninja-version;</productnumber> + <address>&ninja-url;</address> + </sect1info> + + <title>Ninja-&ninja-version;</title> + + <indexterm zone="ch-system-ninja"> + <primary sortas="a-Ninja">Ninja</primary> + </indexterm> + + <sect2 role="package"> + <title/> + + <para>Ninja is a small build system with a focus on speed.</para> + + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> + + <seglistitem> + <seg>&ninja-ch6-sbu;</seg> + <seg>&ninja-ch6-du;</seg> + </seglistitem> + </segmentedlist> + + </sect2> + + <sect2 role="installation"> + <title>Installation of Ninja</title> + + <para>Prepare Ninja for compilation:</para> + +<screen><userinput remap="configure">python3 configure.py --bootstrap</userinput></screen> + + <variablelist> + <title>The meaning of the configure options:</title> + + <varlistentry> + <term><parameter>--bootstrap</parameter></term> + <listitem> + <para>This parameter forces ninja to rebuild itself for the current + system.</para> + </listitem> + </varlistentry> + + </variablelist> + + <para>To test the results, issue:</para> + +<screen><userinput remap="test">python3 configure.py +./ninja ninja_test +./ninja_test --gtest_filter=-SubprocessTest.SetWithLots</userinput></screen> + + <para>Install the package:</para> + +<screen><userinput remap="install">install -vm755 ninja /usr/bin/ +install -vDm644 misc/ninja.vim \ + /usr/share/vim/vim&vim-majmin;/syntax/ninja.vim +install -vDm644 misc/bash-completion \ + /usr/share/bash-completion/completions/ninja +install -vDm644 misc/zsh-completion \ + /usr/share/zsh/site-functions/_ninja</userinput></screen> + + </sect2> + + <sect2 id="contents-ninja" role="content"> + <title>Contents of Ninja</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + + <seglistitem> + <seg>ninja</seg> + </seglistitem> + </segmentedlist> + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="ninja"> + <term><command>ninja</command></term> + <listitem> + <para>is the Ninja build system.</para> + <indexterm zone="ch-system-ninja ninja"> + <primary sortas="b-ninja">ninja</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> + diff --git a/chapter06/python.xml b/chapter06/python.xml new file mode 100644 index 000000000..d680bc735 --- /dev/null +++ b/chapter06/python.xml @@ -0,0 +1,244 @@ +<?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="ch-system-Python" role="wrap"> + <?dbhtml filename="Python.html"?> + + <sect1info condition="script"> + <productname>Python</productname> + <productnumber>&python-version;</productnumber> + <address>&python-url;</address> + </sect1info> + + <title>Python-&python-version;</title> + + <indexterm zone="ch-system-Python"> + <primary sortas="a-python">python</primary> + </indexterm> + + <sect2 role="package"> + <title/> + + <para>The Python 3 package contains the Python development environment. It + is useful for object-oriented programming, writing scripts, prototyping + large programs or developing entire applications.</para> + + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> + + <seglistitem> + <seg>&python-ch6-sbu;</seg> + <seg>&python-ch6-du;</seg> + </seglistitem> + </segmentedlist> + + </sect2> + + <sect2 role="installation"> + <title>Installation of Python 3</title> + + <para>Prepare Python for compilation:</para> + +<screen><userinput remap="configure">./configure --prefix=/usr \ + --enable-shared \ + --with-system-expat \ + --with-system-ffi \ + --with-ensurepip=yes \ + --enable-unicode=ucs4</userinput></screen> + + <variablelist> + <title>The meaning of the configure options:</title> + + <varlistentry> + <term><parameter>--with-system-expat</parameter></term> + <listitem> + <para>This switch enables linking against system version of + <application>Expat</application>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>--with-system-ffi</parameter></term> + <listitem> + <para>This switch enables linking against system version of + <application>libffi</application>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>--with-ensurepip=yes</parameter></term> + <listitem> + <para>This switch enables building <command>pip</command> and + <command>setuptools</command> packaging programs.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>--enable-unicode=ucs4</parameter></term> + <listitem> + <para>This switch enables 32bit Unicode support in + <application>Python</application>.</para> + </listitem> + </varlistentry> + + </variablelist> + + <para>Compile the package:</para> + +<screen><userinput remap="make">make</userinput></screen> + + <para>The test suite requires TK and and X Windows session and cannot + be run until Python 3 is reinstalled in BLFS.</para> + + <para>Install the package:</para> + +<screen><userinput remap="install">make install +chmod -v 755 /usr/lib/libpython3.6m.so +chmod -v 755 /usr/lib/libpython3.so</userinput></screen> + + <variablelist> + <title>The meaning of the install commands:</title> + + <varlistentry> + <term><command>chmod -v 755 /usr/lib/libpython3.{6m.,}so</command></term> + <listitem> + <para>Fix permissions for libraries to be consistent with other + libraries.</para> + </listitem> + </varlistentry> + + </variablelist> + + <para>If desired, install the preformatted documentation:</para> + +<screen><userinput remap="install">install -v -dm755 /usr/share/doc/python-&python-version;/html + +tar --strip-components=1 \ + --no-same-owner \ + --no-same-permissions \ + -C /usr/share/doc/python-&python-version;/html \ + -xvf ../python-&python-version;-docs-html.tar.bz2</userinput></screen> + + <variablelist> + <title>The meaning of the documentation install commands:</title> + + <varlistentry> + <term><option>--no-same-owner</option> and --no-same-permissions</term> + <listitem> + <para>Ensure the installed files have the correct ownership and + prermissions. Without these options, using <application>tar</application> + will install the package files with the upstream creator's values. + </para> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + + <sect2 id="contents-python" role="content"> + <title>Contents of Python 3</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Library</segtitle> + <segtitle>Installed Directories</segtitle> + + <seglistitem> + <seg> + 2to3, idle3, pydoc3, python3, python3-config, pyvenv + </seg> + <seg> + libpython3.6m.so and libpython3.so + </seg> + <seg> + /usr/include/python3.6m, /usr/lib/python3 and + /usr/share/doc/python-&python-version; + </seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="python-2to3"> + <term><command>2to3</command></term> + <listitem> + <para> + is a <application>Python</application> program that reads + <application>Python 2.x</application> source code and applies a + series of fixes to transform it into valid + <application>Python 3.x</application> code. + </para> + <indexterm zone="ch-system-Python"> + <primary sortas="b-2to3">2to3</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="idle3"> + <term><command>idle3</command></term> + <listitem> + <para> + is a wrapper script that opens a <application>Python</application> + aware GUI editor. For this script to run, you must have installed + <application>Tk</application> before Python so that the Tkinter + Python module is built. + </para> + <indexterm zone="ch-system-Python"> + <primary sortas="b-idle3">idle3</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pydoc3"> + <term><command>pydoc3</command></term> + <listitem> + <para> + is the <application>Python</application> documentation tool. + </para> + <indexterm zone="ch-system-Python"> + <primary sortas="b-pydoc3">pydoc3</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="python3"> + <term><command>python3</command></term> + <listitem> + <para> + is an interpreted, interactive, object-oriented programming + language. + </para> + <indexterm zone="ch-system-Python"> + <primary sortas="b-python3">python3</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pyvenv"> + <term><command>pyvenv</command></term> + <listitem> + <para> + creates virtual <application>Python</application> environments in + one or more target directories. + </para> + <indexterm zone="ch-system-Python"> + <primary sortas="b-pyvenv">pyvenv</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> + diff --git a/general.ent b/general.ent index b97c14a64..b072e20b6 100644 --- a/general.ent +++ b/general.ent @@ -1,13 +1,13 @@ -<!ENTITY version "SVN-20170922"> +<!ENTITY version "SVN-20170923"> <!ENTITY short-version "svn"> <!-- Used below in &blfs-book; Change to x.y for release but not -rc releases --> <!ENTITY generic-version "development"> <!-- Use "development" or "x.y[-pre{x}]" --> -<!ENTITY versiond "20170922-systemd"> +<!ENTITY versiond "20170923-systemd"> <!ENTITY short-versiond "systemd"> <!ENTITY generic-versiond "systemd"> -<!ENTITY releasedate "September 22, 2017"> +<!ENTITY releasedate "September 23, 2017"> <!ENTITY copyrightdate "1999-2017"><!-- jhalfs needs a literal dash, not – --> <!ENTITY milestone "8.2"> diff --git a/packages.ent b/packages.ent index 9ad11672c..e769b38ba 100644 --- a/packages.ent +++ b/packages.ent @@ -145,10 +145,10 @@ <!ENTITY e2fsprogs-ch6-du "58 MB"> <!ENTITY e2fsprogs-ch6-sbu "3.3 SBU"> -<!ENTITY eudev-version "3.2.3"> +<!ENTITY eudev-version "3.2.4"> <!ENTITY eudev-size "1,813 KB"> <!ENTITY eudev-url "http://dev.gentoo.org/~blueness/eudev/eudev-&eudev-version;.tar.gz"> -<!ENTITY eudev-md5 "1e91710d6c42f03f803108091be5878f"> +<!ENTITY eudev-md5 "66acef4c6094aab4aced7ae83b74b0d2"> <!ENTITY eudev-ch6-du "78 MB"> <!ENTITY eudev-ch6-sbu "0.2 SBU"> @@ -382,6 +382,14 @@ <!ENTITY libcap-ch6-du "1.3 MB"> <!ENTITY libcap-ch6-sbu "less than 0.1 SBU"> +<!ENTITY libffi-version "3.2.1"> +<!ENTITY libffi-size "920 KB"> +<!ENTITY libffi-url "ftp://sourceware.org/pub/libffi/libffi-&libffi-version;.tar.gz"> +<!ENTITY libffi-md5 "83b89587607e3eb65c70d361f13bab43"> +<!ENTITY libffi-home "https://sourceware.org/libffi/"> +<!ENTITY libffi-ch6-du "6.1 MB"> +<!ENTITY libffi-ch6-sbu "0.1 SBU"> + <!ENTITY libpipeline-version "1.4.2"> <!ENTITY libpipeline-size "808 KB"> <!ENTITY libpipeline-url "&savannah;/releases/libpipeline/libpipeline-&libpipeline-version;.tar.gz"> @@ -454,6 +462,14 @@ <!ENTITY man-pages-ch6-du "27 MB"> <!ENTITY man-pages-ch6-sbu "less than 0.1 SBU"> +<!ENTITY meson-version "0.42.1"> +<!ENTITY meson-size "1,021 KB"> +<!ENTITY meson-url "https://github.com/mesonbuild/meson/releases/download/&meson-version;/meson-&meson-version;.tar.gz"> +<!ENTITY meson-md5 "a8ff06ab5e138dec64cbfa249ff4f8bb"> +<!ENTITY meson-home "http://mesonbuild.com"> +<!ENTITY meson-ch6-du "30 MB"> +<!ENTITY meson-ch6-sbu "0.4 SBU"> + <!ENTITY mpc-version "1.0.3"> <!ENTITY mpc-size "655 KB"> <!ENTITY mpc-url "http://www.multiprecision.org/mpc/download/mpc-&mpc-version;.tar.gz"> @@ -462,10 +478,10 @@ <!ENTITY mpc-ch6-du "17 MB"> <!ENTITY mpc-ch6-sbu "0.3 SBU"> -<!ENTITY mpfr-version "3.1.5"> -<!ENTITY mpfr-size "1,101 KB"> +<!ENTITY mpfr-version "3.1.6"> +<!ENTITY mpfr-size "1,108 KB"> <!ENTITY mpfr-url "http://www.mpfr.org/mpfr-&mpfr-version;/mpfr-&mpfr-version;.tar.xz"> -<!ENTITY mpfr-md5 "c4ac246cf9795a4491e7766002cd528f"> +<!ENTITY mpfr-md5 "51bfdbf81553966c8d43808122cc81b3"> <!ENTITY mpfr-home "http://www.mpfr.org/"> <!ENTITY mpfr-ch6-du "45 MB"> <!ENTITY mpfr-ch6-sbu "0.8 SBU"> @@ -480,6 +496,14 @@ <!ENTITY ncurses-ch6-du "39 MB"> <!ENTITY ncurses-ch6-sbu "0.3 SBU"> +<!ENTITY ninja-version "1.8.2"> +<!ENTITY ninja-size "181 KB"> +<!ENTITY ninja-url "https://github.com/ninja-build/ninja/archive/v&ninja-version;/ninja-&ninja-version;.tar.gz"> +<!ENTITY ninja-md5 "5fdb04461cc7f5d02536b3bfc0300166"> +<!ENTITY ninja-home "https://ninja-build.org/"> +<!ENTITY ninja-ch6-du "58.0 MB"> +<!ENTITY ninja-ch6-sbu "0.2 SBU"> + <!ENTITY patch-version "2.7.5"> <!ENTITY patch-size "711 KB"> <!ENTITY patch-url "&gnu;patch/patch-&patch-version;.tar.xz"> @@ -524,6 +548,17 @@ <!ENTITY psmisc-ch6-du "4.2 MB"> <!ENTITY psmisc-ch6-sbu "less than 0.1 SBU"> +<!ENTITY python-version "3.6.2"> +<!ENTITY python-size "16,511 KB"> +<!ENTITY python-url "https://www.python.org/ftp/python/&python-version;/Python-&python-version;.tar.xz"> +<!ENTITY python-md5 "2c68846471994897278364fc18730dd9"> +<!ENTITY python-home "https://www.python.org/"> +<!ENTITY python-ch6-du "355 MB"> +<!ENTITY python-ch6-sbu "1.3 SBU"> +<!ENTITY python-docs-url "https://docs.python.org/3.6/archives/python-3.6.2-docs-html.tar.bz2"> +<!ENTITY python-docs-md5 "7f14038af43b80251dbbb37e30e35f78"> +<!ENTITY python-docs-size "5,976 MB"> + <!ENTITY readline-version "7.0"> <!ENTITY readline-size "2,842 KB"> <!ENTITY readline-url "&gnu;readline/readline-&readline-version;.tar.gz"> @@ -626,6 +661,7 @@ <!ENTITY util-linux-ch6-sbu "1.0 SBU"> <!ENTITY vim-version "8.0.586"> +<!ENTITY vim-majmin "80"> <!ENTITY vim-docdir "vim/vim80"> <!ENTITY vim-size "10,613 KB"> <!ENTITY vim-url "ftp://ftp.vim.org/pub/vim/unix/vim-&vim-version;.tar.bz2"> diff --git a/prologue/why.xml b/prologue/why.xml index 761cf138d..b85281842 100644 --- a/prologue/why.xml +++ b/prologue/why.xml @@ -327,6 +327,19 @@ </listitem> <listitem> + <para>Libffi</para> + + <para>This package implements a portable, high level programming + interface to various calling conventions. Some programs may not know + at the time of compilation what arguments are to be passed to a + function. For instance, an interpreter may be told at run-time about + the number and types of arguments used to call a given function. Libffi + can be used in such programs to provide a bridge from the interpreter + program to compiled code.</para> + + </listitem> + + <listitem> <para>Libpipeline</para> <para>The Libpipeline package contains a library for manipulating @@ -381,6 +394,16 @@ </listitem> <listitem> + <para>Meson</para> + + <para>This package provides a software tool for automating the building + of software. The main goal for Meson is to minimize the amount of time + that software developers need to spend configuring their build + system.</para> + + </listitem> + + <listitem> <para>MPC</para> <para>This package contains functions for the arithmetic of complex @@ -395,6 +418,15 @@ </listitem> <listitem> + <para>Ninja</para> + + <para>This package contains a small build system with a focus on speed. + It is designed to have its input files generated by a higher-level build + system, and to run builds as fast as possible.</para> + + </listitem> + + <listitem> <para>Ncurses</para> <para>This package contains libraries for terminal-independent @@ -444,6 +476,14 @@ </listitem> <listitem> + <para>Python 3</para> + + <para>This package provides an interpreted language that has a design + philosophy that emphasizes code readability.</para> + + </listitem> + + <listitem> <para>Readline</para> <para>This package is a set of libraries that offers command-line |