[Clfs-commits] [CLFS Embedded]Cross-LFS Embedded Book branch, master, updated. d1e82c57f264351199d6624b93c4c2c901fd85f5

git git at cross-lfs.org
Wed Jul 3 14:23:43 PDT 2013


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Cross-LFS Embedded Book".

The branch, master has been updated
       via  d1e82c57f264351199d6624b93c4c2c901fd85f5 (commit)
       via  7efa4961fdc6551fd60cd0c80d861df492d5d2fa (commit)
       via  29214ff6c6d670ba9cb7a6f83da9199b29856d71 (commit)
       via  b355162bb93c717e71cdd29f6b04250aed77c5ba (commit)
       via  096729a0ffc6a6fa58e432333e1a5e8aacb3a2ea (commit)
       via  e9d5b1a1be6e0246e9b419878cf56a4b54a28bc8 (commit)
       via  7d96901a48eb17779307a80f5df19804ed70621b (commit)
       via  0a9c489208a57812be65951b279f9258966a9181 (commit)
       via  8df0e622306b491f509bf2c2986a513549040476 (commit)
       via  b38c4f7cf34a1a8b290b2afdf1a47a4058e9fc23 (commit)
       via  dc26d747061e2e1d6d6ba8c123f80dc1aec61c01 (commit)
       via  79d595420a8eaffc23b5c596291e90f5f667b094 (commit)
       via  9592071e5816a05d160c31fa52cf36bb2f3d0876 (commit)
       via  a0aa1afb530b13183030c0a5038db241c08846ef (commit)
       via  d92e1b87b0762531fd24b78a3ea4484f8468f6d2 (commit)
       via  bacf8740e96fafd640adcb86cd9fd230f87a260a (commit)
       via  fcd9e80c6a200922565bff892c451776023ae290 (commit)
      from  97afd0143096354cac4a8f17360f83f6c6244fae (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit d1e82c57f264351199d6624b93c4c2c901fd85f5
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 16:34:18 2013 -0400

    general: Update date

diff --git a/BOOK/general.ent b/BOOK/general.ent
index 78360b2..92df0a1 100644
--- a/BOOK/general.ent
+++ b/BOOK/general.ent
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
 
-<!ENTITY month "06"> <!-- Use two digits -->
-<!ENTITY month_name "June">
-<!ENTITY day "17"> <!-- Use two digits -->
+<!ENTITY month "07"> <!-- Use two digits -->
+<!ENTITY month_name "July">
+<!ENTITY day "03"> <!-- Use two digits -->
 <!ENTITY year "2013"> <!-- Use four digits -->
 
 <!ENTITY releasedate "&month_name; &day;, &year;">

commit 7efa4961fdc6551fd60cd0c80d861df492d5d2fa
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 13:02:13 2013 -0400

    creatingfiles: Note additional users/groups as optional
    
    None are required, make that more clear.

diff --git a/BOOK/final-preps/creatingfiles.xml b/BOOK/final-preps/creatingfiles.xml
index b4d0d54..02d97ca 100644
--- a/BOOK/final-preps/creatingfiles.xml
+++ b/BOOK/final-preps/creatingfiles.xml
@@ -58,7 +58,7 @@ EOF</userinput></screen>
 
   <variablelist os="b">
 
-    <title>Additional users you may want to add:</title>
+    <title>Additional optional users you may want to add:</title>
 
     <varlistentry>
       <term><literal>bin:x:1:1:bin:/bin:/bin/false</literal></term>
@@ -147,7 +147,7 @@ EOF</userinput></screen>
 
   <variablelist os="c">
 
-    <title>Additional groups you may want to add</title>
+    <title>Additional optional groups you may want to add</title>
 
     <varlistentry>
       <term><literal>adm:x:16:root,adm,daemon</literal></term>

commit 29214ff6c6d670ba9cb7a6f83da9199b29856d71
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:53:50 2013 -0400

    addinguser: Use sudo
    
    Rather than logging in as root, it's just more convenient.

diff --git a/BOOK/final-preps/addinguser.xml b/BOOK/final-preps/addinguser.xml
index 724fb85..9a26d23 100644
--- a/BOOK/final-preps/addinguser.xml
+++ b/BOOK/final-preps/addinguser.xml
@@ -17,11 +17,10 @@
   work environment, create a new user called <systemitem
   class="username">clfs</systemitem> as a member of a new group (also named
   <systemitem class="groupname">clfs</systemitem>) and use this user during
-  the installation process. As <systemitem class="username">root</systemitem>,
-  issue the following commands to add the new user:</para>
+  the installation process.</para>
 
-<screen><userinput>groupadd clfs
-useradd -s /bin/bash -g clfs -m -k /dev/null clfs</userinput></screen>
+<screen><userinput>sudo groupadd clfs
+sudo useradd -s /bin/bash -g clfs -m -k /dev/null clfs</userinput></screen>
 
   <variablelist>
     <title>The meaning of the command line options:</title>
@@ -75,13 +74,13 @@ useradd -s /bin/bash -g clfs -m -k /dev/null clfs</userinput></screen>
   to have a password), give <systemitem class="username">clfs</systemitem>
   a password:</para>
 
-<screen><userinput>passwd clfs</userinput></screen>
+<screen><userinput>sudo passwd clfs</userinput></screen>
 
   <para>Grant <systemitem class="username">clfs</systemitem> full access to
   <filename class="directory">${CLFS}</filename> by making <systemitem
   class="username">clfs</systemitem> the directory's owner:</para>
 
-<screen><userinput>chown -Rv clfs ${CLFS}</userinput></screen>
+<screen><userinput>sudo chown -Rv clfs ${CLFS}</userinput></screen>
 
   <para>Next, login as user <systemitem class="username">clfs</systemitem>.
   This can be done via a virtual console, through a display manager, or

commit b355162bb93c717e71cdd29f6b04250aed77c5ba
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:52:02 2013 -0400

    hostreqs: Add sudo
    
    Make it easier to perform root commands, most distros now have users
    setup to use sudo for root operations already.

diff --git a/BOOK/prologue/common/hostreqs.xml b/BOOK/prologue/common/hostreqs.xml
index ab71c49..9bc0a2a 100644
--- a/BOOK/prologue/common/hostreqs.xml
+++ b/BOOK/prologue/common/hostreqs.xml
@@ -77,6 +77,10 @@
     </listitem>
 
     <listitem>
+      <para><emphasis role="strong">Sudo-1.7.4p4</emphasis></para>
+    </listitem>
+
+    <listitem>
       <para><emphasis role="strong">Tar-1.23</emphasis></para>
     </listitem>
 
@@ -108,6 +112,7 @@ gzip --version | head -n1
 make --version | head -n1
 patch --version | head -n1
 sed --version | head -n1
+sudo -V | head -n1
 tar --version | head -n1
 makeinfo --version | head -n1</literal>
 

commit 096729a0ffc6a6fa58e432333e1a5e8aacb3a2ea
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:43:37 2013 -0400

    final-prep: Don't install ${CLFS}
    
    Should already be present due to create-dir section.

diff --git a/BOOK/final-preps/aboutclfs.xml b/BOOK/final-preps/aboutclfs.xml
index 87b1f6a..1d42569 100644
--- a/BOOK/final-preps/aboutclfs.xml
+++ b/BOOK/final-preps/aboutclfs.xml
@@ -30,11 +30,6 @@
   <quote>/mnt/clfs</quote> (or whatever the variable was set to) when it
   processes the command line.</para>
 
-  <para>If you haven't created the <filename class="directory">${CLFS}</filename>
-  directory, do so at this time by issuing the following commands:</para>
-
-<screen><userinput>install -dv ${CLFS}</userinput></screen>
-
   <para>Do not forget to check that <envar>${CLFS}</envar> is set whenever
   you leave and reenter the current working environment (as when doing a
   <quote>su</quote> to <systemitem class="username">root</systemitem> or

commit e9d5b1a1be6e0246e9b419878cf56a4b54a28bc8
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:36:25 2013 -0400

    materials-intro: Remove cross-lfs.org link
    
    The contents found at the link are horribly outdated and thus not
    useful.  Google will turn up much better results for recent packages.

diff --git a/BOOK/materials/common/introduction.xml b/BOOK/materials/common/introduction.xml
index 72e6678..510c742 100644
--- a/BOOK/materials/common/introduction.xml
+++ b/BOOK/materials/common/introduction.xml
@@ -22,9 +22,7 @@
   <para>Download locations may not always be accessible. If a download
   location has changed since this book was published, Google (<ulink
   url="http://www.google.com/"/>) provides a useful search engine for
-  most packages. If this search is unsuccessful, try one of the
-  alternative means of downloading discussed at <ulink
-  url="&packages-root;"/>.</para>
+  most packages.</para>
 
   <para>Downloaded packages and patches will need to be stored somewhere
   that is conveniently available throughout the entire build. A working

commit 7d96901a48eb17779307a80f5df19804ed70621b
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:32:57 2013 -0400

    create-dir: Wrap CLFS var in {}
    
    For consistency.

diff --git a/BOOK/create-dir/creatingbuilddir.xml b/BOOK/create-dir/creatingbuilddir.xml
index 08831f0..eacb6fc 100644
--- a/BOOK/create-dir/creatingbuilddir.xml
+++ b/BOOK/create-dir/creatingbuilddir.xml
@@ -22,7 +22,7 @@
   <para>Ensure that this new directory has permissions that are too restrictive
     such that you can write to it as a non-root user.</para>
 
-<screen><userinput>chmod 777 $CLFS</userinput></screen>
+<screen><userinput>chmod 777 ${CLFS}</userinput></screen>
 
   <para>Now that there is an established place to work, it is time to
   download the packages.</para>

commit 0a9c489208a57812be65951b279f9258966a9181
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:31:16 2013 -0400

    create-dir: Remove remnants of partitioning

diff --git a/BOOK/create-dir/chapter.xml b/BOOK/create-dir/chapter.xml
index da64f88..e4974c7 100644
--- a/BOOK/create-dir/chapter.xml
+++ b/BOOK/create-dir/chapter.xml
@@ -6,7 +6,7 @@
 ]>
 
 <chapter id="chapter-creating-build-dir" xreflabel="Creating a Build Directory">
-  <?dbhtml dir="partitioning"?>
+  <?dbhtml dir="create-dir"?>
   <?dbhtml filename="chapter.html"?>
 
   <title>Creating a Build Directory</title>
diff --git a/BOOK/create-dir/creatingbuilddir.xml b/BOOK/create-dir/creatingbuilddir.xml
index d7b59ac..08831f0 100644
--- a/BOOK/create-dir/creatingbuilddir.xml
+++ b/BOOK/create-dir/creatingbuilddir.xml
@@ -5,7 +5,7 @@
   %general-entities;
 ]>
 
-<sect1 id="ch-partitioning-creatingbuilddir">
+<sect1 id="ch-create-dir-creatingbuilddir">
   <?dbhtml filename="creatingbuilddir.html"?>
 
   <title>Creating a Build Directory</title>

commit 8df0e622306b491f509bf2c2986a513549040476
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:25:40 2013 -0400

    organization: Match actual appendicies
    
    Due to recent changes removing some appendix.

diff --git a/BOOK/prologue/common/organization.xml b/BOOK/prologue/common/organization.xml
index 03f27d8..1332cde 100644
--- a/BOOK/prologue/common/organization.xml
+++ b/BOOK/prologue/common/organization.xml
@@ -59,10 +59,9 @@
 
     <para>The appendices contain information that doesn't really fit anywhere
     else in the book. Appendix A contains definitions of acronyms and
-    terms used in the book; Appendix B gives acknowledgments to people
-    who have helped work on the CLFS project and website; Appendix C and
-    D have information about package dependencies and the the build
-    order; Appendix E provides the Open Publication License.</para>
+    terms used in the book; Appendix B and C have information about package
+    dependencies and the the build order; Appendix D provides the Open
+    Publication License.</para>
 
   </sect2>
 

commit b38c4f7cf34a1a8b290b2afdf1a47a4058e9fc23
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:23:13 2013 -0400

    typography: Remove mention of installed man
    
    Embedded doesn't install man to the target.

diff --git a/BOOK/prologue/common/typography.xml b/BOOK/prologue/common/typography.xml
index 70a7863..4e27a37 100644
--- a/BOOK/prologue/common/typography.xml
+++ b/BOOK/prologue/common/typography.xml
@@ -61,13 +61,7 @@ EOF</userinput></screen>
   <para>This format is used to refer to a specific manual page (hereinafter
   referred to simply as a <quote>man</quote> page). The number inside
   parentheses indicates a specific section inside of <command>man</command>.
-  For example, <command>passwd</command> has two man pages. Per CLFS
-  installation instructions, those two man pages will be located at
-  <filename>/usr/share/man/man1/passwd.1</filename> and
-  <filename>/usr/share/man/man5/passwd.5</filename>. Both man pages have
-  different information in them. When the book uses
-  <filename>passwd(5)</filename> it is specifically referring to
-  <filename>/usr/share/man/man5/passwd.5</filename>.
+  For example, <command>passwd</command> has two man pages.
   <command>man passwd</command> will print the first man page it finds
   that matches <quote>passwd</quote>, which will be
   <filename>/usr/share/man/man1/passwd.1</filename>. For this example,

commit dc26d747061e2e1d6d6ba8c123f80dc1aec61c01
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:18:02 2013 -0400

    foreword: Fix grammar
    
    "supporting" not "support"

diff --git a/BOOK/prologue/common/foreword.xml b/BOOK/prologue/common/foreword.xml
index cfece0c..2a03936 100644
--- a/BOOK/prologue/common/foreword.xml
+++ b/BOOK/prologue/common/foreword.xml
@@ -36,7 +36,7 @@
   always followed, e.g., knowing your system inside and out by virtue
   of having built the system yourself.  Additionally, during a CLFS Embedded
   build, you will learn advanced techniques such as cross-build toolchains,
-  and how to create a smaller footprint system support architectures 
+  and how to create a smaller footprint system supporting architectures
   such as ARM and MIPS, in addition to x86.</para>
 
   <para>We hope you enjoy building your own CLFS Embedded system, and the benefits

commit 79d595420a8eaffc23b5c596291e90f5f667b094
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:16:46 2013 -0400

    foreward: Add Andrew Bradford as CLFS Developer

diff --git a/BOOK/prologue/common/foreword.xml b/BOOK/prologue/common/foreword.xml
index cb9f400..cfece0c 100644
--- a/BOOK/prologue/common/foreword.xml
+++ b/BOOK/prologue/common/foreword.xml
@@ -48,6 +48,6 @@ Jeremy Utley, CLFS 1.x Release Manager (Page Author)
 Ryan Oliver, CLFS Project Co-leader
 Joe Ciccone, Justin Knierim, Chris Staub, Matt Darcy, Ken Moffat,
 Maarten Lankhorst, Zack Winkles, Manuel Canales Esparcia,
-and Nathan Coulson - CLFS Developers</literallayout>
+Nathan Coulson, and Andrew Bradford - CLFS Developers</literallayout>
 
 </sect1>

commit 9592071e5816a05d160c31fa52cf36bb2f3d0876
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:14:49 2013 -0400

    foreword: List archs actually supported
    
    Just MIPS, ARM, and x86.

diff --git a/BOOK/prologue/common/foreword.xml b/BOOK/prologue/common/foreword.xml
index 2ef389b..cb9f400 100644
--- a/BOOK/prologue/common/foreword.xml
+++ b/BOOK/prologue/common/foreword.xml
@@ -37,7 +37,7 @@
   of having built the system yourself.  Additionally, during a CLFS Embedded
   build, you will learn advanced techniques such as cross-build toolchains,
   and how to create a smaller footprint system support architectures 
-  such as Sparc, MIPS, and Alpha, and much more.</para>
+  such as ARM and MIPS, in addition to x86.</para>
 
   <para>We hope you enjoy building your own CLFS Embedded system, and the benefits
   that come from a system tailored to your needs.</para>

commit a0aa1afb530b13183030c0a5038db241c08846ef
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 12:10:15 2013 -0400

    prologue: Remove dead linuxhq.com link
    
    No longer available.

diff --git a/BOOK/prologue/common/prerequisites.xml b/BOOK/prologue/common/prerequisites.xml
index b9bf861..f7aa8fe 100644
--- a/BOOK/prologue/common/prerequisites.xml
+++ b/BOOK/prologue/common/prerequisites.xml
@@ -39,12 +39,6 @@
       <quote>generic</quote> Unix software distributions under Linux.</para>
     </listitem>
     <listitem>
-      <para remap="verbatim">The Linux Users' Guide
-      <ulink url="http://www.linuxhq.com/guides/LUG/guide.html"/></para>
-
-      <para>This guide covers the usage of assorted Linux software.</para>
-    </listitem>
-    <listitem>
       <para remap="verbatim">The Essential Pre-Reading Hint
       <ulink url="&hints-root;essential_prereading.txt"/></para>
 

commit d92e1b87b0762531fd24b78a3ea4484f8468f6d2
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 10:56:01 2013 -0400

    gmp: Remove mention of Debian 5
    
    Minimum reqs for host system have been updated to Debian 6 or newer.

diff --git a/BOOK/cross-tools/common/gmp.xml b/BOOK/cross-tools/common/gmp.xml
index 7d9e478..eb6fcae 100644
--- a/BOOK/cross-tools/common/gmp.xml
+++ b/BOOK/cross-tools/common/gmp.xml
@@ -36,9 +36,8 @@
 <screen os="d"><userinput>make</userinput></screen>
 
     <note os="e">
-      <para>Some versions of GCC (notably 4.3.2 which ships with Debian
-      5) will compile GMP without errors but in a subtly broken way.  To ensure
-      GMP is compiled and functioning correctly, optionally run the test suite:</para>
+      <para>To ensure GMP is compiled and functioning correctly, optionally run
+        the test suite:</para>
 
 <screen><userinput>make check</userinput></screen>
     </note>

commit bacf8740e96fafd640adcb86cd9fd230f87a260a
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Wed Jul 3 10:44:37 2013 -0400

    gmp: Add --build=${CLFS_HOST} to configure
    
    To ensure that GMP picks the correct host arch and bit-ness.
    See: http://lists.cross-lfs.org/pipermail/clfs-support-cross-lfs.org/2013-July/001611.html

diff --git a/BOOK/cross-tools/common/gmp.xml b/BOOK/cross-tools/common/gmp.xml
index 5855c88..7d9e478 100644
--- a/BOOK/cross-tools/common/gmp.xml
+++ b/BOOK/cross-tools/common/gmp.xml
@@ -29,7 +29,7 @@
     <para os="a">Prepare GMP for compilation:</para>
 
 <screen os="b"><userinput>CPPFLAGS=-fexceptions ./configure \
-    --prefix=${CLFS}/cross-tools</userinput></screen>
+    --build=${CLFS_HOST} --prefix=${CLFS}/cross-tools</userinput></screen>
 
     <para os="c">Compile the package:</para>
 

commit fcd9e80c6a200922565bff892c451776023ae290
Author: Andrew Bradford <andrew at bradfordembedded.com>
Date:   Tue Jun 18 08:50:11 2013 -0400

    changelog: Update for create build dir

diff --git a/BOOK/introduction/common/changelog.xml b/BOOK/introduction/common/changelog.xml
index 0dfb8c9..26c99fc 100644
--- a/BOOK/introduction/common/changelog.xml
+++ b/BOOK/introduction/common/changelog.xml
@@ -36,6 +36,15 @@
     </listitem>
 -->
     <listitem>
+      <para>June 17, 2013</para>
+      <itemizedlist>
+        <listitem>
+          <para>[abradford] - Change partitioning to creating build dir.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>June 13, 2013</para>
       <itemizedlist>
         <listitem>

-----------------------------------------------------------------------

Summary of changes:
 BOOK/create-dir/chapter.xml            |    2 +-
 BOOK/create-dir/creatingbuilddir.xml   |    4 ++--
 BOOK/cross-tools/common/gmp.xml        |    7 +++----
 BOOK/final-preps/aboutclfs.xml         |    5 -----
 BOOK/final-preps/addinguser.xml        |   11 +++++------
 BOOK/final-preps/creatingfiles.xml     |    4 ++--
 BOOK/general.ent                       |    6 +++---
 BOOK/introduction/common/changelog.xml |    9 +++++++++
 BOOK/materials/common/introduction.xml |    4 +---
 BOOK/prologue/common/foreword.xml      |    6 +++---
 BOOK/prologue/common/hostreqs.xml      |    5 +++++
 BOOK/prologue/common/organization.xml  |    7 +++----
 BOOK/prologue/common/prerequisites.xml |    6 ------
 BOOK/prologue/common/typography.xml    |    8 +-------
 14 files changed, 38 insertions(+), 46 deletions(-)


hooks/post-receive
-- 
Cross-LFS Embedded Book



More information about the Clfs-commits mailing list