Browse Source

Add Meson-0.42.1.
Add Ninja-1.8.2.
Add Python-3.6.2.
Add libffi-3.2.1.
Update to eudev-3.2.4.



git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11303 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

Bruce Dubbs 7 years ago
parent
commit
b0aabe01ad

+ 141 - 0
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>
 

+ 22 - 0
chapter01/changelog.xml

@@ -42,6 +42,28 @@
     <listitem revision="sysv"> or <listitem revision="systemd"> as
     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>

+ 13 - 3
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>

+ 44 - 0
chapter03/packages.xml

@@ -396,6 +396,15 @@
       </listitem>
     </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>
@@ -473,6 +482,15 @@
       </listitem>
     </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>
@@ -491,6 +509,15 @@
       </listitem>
     </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>
@@ -545,6 +572,23 @@
       </listitem>
     </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>

+ 8 - 1
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"/>

+ 104 - 0
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>
+

+ 89 - 0
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>
+

+ 108 - 0
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>
+

+ 244 - 0
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>
+

+ 3 - 3
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 &ndash; -->
 <!ENTITY milestone       "8.2">

+ 41 - 5
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">

+ 40 - 0
prologue/why.xml

@@ -326,6 +326,19 @@
         </para>
       </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>
 
@@ -380,6 +393,16 @@
         Linux man pages.</para>
       </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>
 
@@ -394,6 +417,15 @@
         arithmetic.  It is required by Gcc.</para>
       </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>
 
@@ -443,6 +475,14 @@
         administration.</para>
       </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>