r1589 - in nALFS/hackers_guide/trunk: . book introduction/welcome part2/common part2/hacker part3/editor preface

jwrober at linuxfromscratch.org jwrober at linuxfromscratch.org
Wed Nov 17 19:41:16 PST 2004


Author: jwrober
Date: 2004-11-17 20:41:14 -0700 (Wed, 17 Nov 2004)
New Revision: 1589

Modified:
   nALFS/hackers_guide/trunk/book/book.ent
   nALFS/hackers_guide/trunk/index.xml
   nALFS/hackers_guide/trunk/introduction/welcome/acknowledgements.xml
   nALFS/hackers_guide/trunk/introduction/welcome/changelog.xml
   nALFS/hackers_guide/trunk/introduction/welcome/contactinfo.xml
   nALFS/hackers_guide/trunk/part2/common/bugzilla.xml
   nALFS/hackers_guide/trunk/part2/common/svn.xml
   nALFS/hackers_guide/trunk/part2/hacker/hacker.xml
   nALFS/hackers_guide/trunk/part2/hacker/prereqs.xml
   nALFS/hackers_guide/trunk/part2/hacker/svn.xml
   nALFS/hackers_guide/trunk/part3/editor/editor.xml
   nALFS/hackers_guide/trunk/preface/organization.xml
   nALFS/hackers_guide/trunk/preface/prerequisites.xml
Log:
updates from jamie bennett

Modified: nALFS/hackers_guide/trunk/book/book.ent
===================================================================
--- nALFS/hackers_guide/trunk/book/book.ent	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/book/book.ent	2004-11-18 03:41:14 UTC (rev 1589)
@@ -28,9 +28,9 @@
 <!ENTITY book-maintainer-firstname "James">
 <!ENTITY book-maintainer-address "jwrober at linuxfromscratch.org">
 
-<!ENTITY product-maintainer-fullname "Kevin Fleming">
-<!ENTITY product-maintainer-firstname "Kevin">
-<!ENTITY product-maintainer-address "kpfleming at linuxfromscratch.org">
+<!ENTITY product-maintainer-fullname "Jeremy Huntwork">
+<!ENTITY product-maintainer-firstname "Jeremy">
+<!ENTITY product-maintainer-address "jhuntwork at linuxfromscratch.org">
 
 <!ENTITY profile-maintainer-fullname "Thomas Pegg">
 <!ENTITY profile-maintainer-firstname "Thomas">

Modified: nALFS/hackers_guide/trunk/index.xml
===================================================================
--- nALFS/hackers_guide/trunk/index.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/index.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -8,8 +8,8 @@
         $LastChangedRevision$ 
 -->
 
-<!ENTITY version "1.2-0.5">
-<!ENTITY releasedate "November 11th, 2004">
+<!ENTITY version "1.2-0.6">
+<!ENTITY releasedate "November 17th, 2004">
 
 <!ENTITY % book         SYSTEM "book/book.ent">
 <!ENTITY % preface      SYSTEM "preface/preface.ent">

Modified: nALFS/hackers_guide/trunk/introduction/welcome/acknowledgements.xml
===================================================================
--- nALFS/hackers_guide/trunk/introduction/welcome/acknowledgements.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/introduction/welcome/acknowledgements.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -48,6 +48,10 @@
 Has</ulink>  <neven at linuxfromscratch.org>  &emdash;
    &book-product; Creator, Project developer.</para></listitem>
 
+<listitem><para><ulink url="mailto:jhuntwork at linuxfromscratch.org">Jeremy
+Huntwork</ulink>  <jhuntwork at linuxfromscratch.org>  
+&emdash;  Project Leader.</para></listitem>
+
 <listitem><para><ulink url="mailto:pterk at datatailors.com">Peter van
 Kampen</ulink>  <pterk at datatailors.com>  &emdash;
   Project developer.</para></listitem>

Modified: nALFS/hackers_guide/trunk/introduction/welcome/changelog.xml
===================================================================
--- nALFS/hackers_guide/trunk/introduction/welcome/changelog.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/introduction/welcome/changelog.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -12,6 +12,9 @@
 
 <itemizedlist>
 
+<listitem><para>November 17th, 2004 [jwrober]: Updates from Jamie
+Bennett.</para></listitem>
+
 <listitem><para>November 11th, 2004 [jwrober]: Filled in a bunch of
 sections from the wiki page notes.</para></listitem>
 

Modified: nALFS/hackers_guide/trunk/introduction/welcome/contactinfo.xml
===================================================================
--- nALFS/hackers_guide/trunk/introduction/welcome/contactinfo.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/introduction/welcome/contactinfo.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -61,12 +61,17 @@
 <blockquote><para><ulink url="&alfs-root;">&alfs-root;</ulink>
 </para></blockquote>
 
+<para>The LFS IRC server has a channel dedicated to nALFS development.  Pop on
+any time.</para>
+<blockquote><para><ulink url="irc://irc.linuxfromscratch.org/#alfs-dev">
+irc://irc.linuxfromscratch.org/#alfs-dev</ulink></para></blockquote>
+
 </sect2>
 
 <sect2>
 <title>Other</title>
 
-<para>The current &book-product; source code owner is
+<para>The current &book-product; project leader is
 &product-maintainer-fullname;.  If you need to reach
 &product-maintainer-firstname;, send an email to
 

Modified: nALFS/hackers_guide/trunk/part2/common/bugzilla.xml
===================================================================
--- nALFS/hackers_guide/trunk/part2/common/bugzilla.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/part2/common/bugzilla.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -9,35 +9,42 @@
 <title>Bugzilla</title>
 
 <para>The &book-product; package tracks all "<emphasis
-role="bold">bugs</emphasis>" in the LFS Bugzilla database. A "<emphasis
-role="bold">bug</emphasis>" is defined as an issue, todo or enhancement request tied to
-one of the ALFS products. The Bugzilla database can be accessed via the web at <ulink
-url="&bugzilla-root;">&bugzilla-root;</ulink>. The package is split across two Bugzilla
-products: "<emphasis role="bold">ALFS Profiles</emphasis>" and "<emphasis
-role="bold">Automated Linux From Scratch</emphasis>". The distinction between the two
+role="bold">bugs</emphasis>" in the LFS Bugzilla database. A
+"<emphasis role="bold">bug</emphasis>" is defined as an issue,
+to-do or enhancement request tied to one of the ALFS products. The
+Bugzilla database can be accessed via the web at <ulink
+url="&bugzilla-root;">&bugzilla-root;</ulink>. The package is split
+across two Bugzilla products: "<emphasis role="bold">ALFS
+Profiles</emphasis>" and "<emphasis role="bold">Automated
+Linux From Scratch</emphasis>". The distinction between the two
 should be pretty clear.</para>
 
-<para>The "<emphasis role="bold">Automated Linux From Scratch</emphasis>" product
-is then split up into five components: "<emphasis role="bold">Back End
-(XML)</emphasis>", "<emphasis role="bold">Doc</emphasis>s", "<emphasis
-role="bold">DTD</emphasis>", "<emphasis role="bold">Extras</emphasis>", and
-"<emphasis role="bold">Front End (GUI)</emphasis>". The "<emphasis
-role="bold">Back End (XML)</emphasis>" component is for all of the back end handlers
-that parse the XML and perform the work they ask for. The "<emphasis
-role="bold">Docs</emphasis>" component is to track all issues related to the three
-works (this book, the ALFS DTD Syntax Doc and the Users Guide). The "<emphasis
-role="bold">DTD</emphasis>" component is designed to take care of all issues around the
-main ALFS DTD and any other DTD's that the project uses. A good example would be the logging
-DTD.  The "<emphasis role="bold">Extras</emphasis>" component is for any add-ons
-or extras to the &book-product; package. The "<emphasis role="bold">Front End
-(GUI)</emphasis>" is designed to track any bugs for the <filename>ncurses</filename>
-GUI.</para>
+<para>The "<emphasis role="bold">Automated Linux From
+Scratch</emphasis>" product is then split up into five components:
+"<emphasis role="bold">Back End (XML)</emphasis>",
+"<emphasis role="bold">Doc</emphasis>s", "<emphasis
+role="bold">DTD</emphasis>", "<emphasis
+role="bold">Extras</emphasis>", and "<emphasis
+role="bold">Front End (GUI)</emphasis>". The "<emphasis
+role="bold">Back End (XML)</emphasis>" component is for all of the
+back end handlers that parse the XML and perform the work they ask for.
+The "<emphasis role="bold">Docs</emphasis>" component is to
+track all issues related to the three works (this book, the ALFS DTD
+Syntax Doc and the Users Guide). The "<emphasis
+role="bold">DTD</emphasis>" component is designed to take care of
+all issues around the main ALFS DTD and any other DTD's that the project
+uses. A good example would be the logging DTD.  The "<emphasis
+role="bold">Extras</emphasis>" component is for any add-ons or
+extras to the &book-product; package. The "<emphasis
+role="bold">Front End (GUI)</emphasis>" is designed to track any
+bugs for the <filename>ncurses</filename> GUI.</para>
 
-<para>If you find a bug in one of the products, first look in the Bugzilla database to see
-if your issue is there.  If not, then please read the <xref
-linkend="intro-welcome-contactinfo"/> page on how to contact the development team at the
-appropriate mailing list. The team will decide if your issue is really a bug or just user
-error. If a bug is found, then you can (or one of the development team will) add the bug in
-the database for work on later.</para>
+<para>If you find a bug in one of the products, first look in the
+Bugzilla database to see if your issue is there.  If not, then please
+read the <xref linkend="intro-welcome-contactinfo"/> page on how to
+contact the development team at the appropriate mailing list. The team
+will decide if your issue is really a bug or just user error. If a bug
+is found, then you can (or one of the development team will) add the bug
+in the database for work on later.</para>
 
 </sect1>

Modified: nALFS/hackers_guide/trunk/part2/common/svn.xml
===================================================================
--- nALFS/hackers_guide/trunk/part2/common/svn.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/part2/common/svn.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -11,7 +11,7 @@
 <sect2>
 <title>Check Out</title>
 
-<para>Bleading edge development of &book-product; occurs on the TRUNK of
+<para>Bleeding edge development of &book-product; occurs on the TRUNK of
 the LFS subversion (SVN) repository.</para>
 
 <para>To get a good feel for what all the repository contains, you can
@@ -37,14 +37,14 @@
 arbitrary, you do not have to use
 <filename>ALFS/nALFS</filename> if you do not want to.</para>
 
-<para>If all you want to do is udpate the local sandbox, then issue
+<para>If all you want to do is update the local sandbox, then issue
 this command in the local working directory (eg.
 <filename>ALFS/nALFS</filename> in your sandbox:</para>
 
 <emphasis role="bold"><filename>svn update</filename></emphasis></note>
 
 <para>If you are planning on being able to check files back in, you need
-to ensure that you do a priviledged checkout.  To do a priviledged
+to ensure that you do a privileged checkout.  To do a priviledged
 checkout, add a "+ssh" just after the second "svn"
 in the above command.  Here is an example :</para>
 
@@ -72,6 +72,19 @@
 
 </itemizedlist>
 
+<para>The standard LFS and BLFS profiles are in a third place the
+repository.  You can find them in the following locations :</para>
+
+<itemizedlist>
+
+<listitem><para><emphasis role="bold">LFS</emphasis> :
+<filename>/ALFS/profile/LFS/trunk</filename></para></listitem>
+
+<listitem><para><emphasis role="bold">BLFS</emphasis> :
+<filename>/ALFS/profiles/BLFS/trunk</filename></para></listitem>
+
+</itemizedlist>
+
 <para>The current stable version of the &book-product; source code is
 developed on the 1.2 branch in the repository.  You can do an anonymous
 checkout of this branch by issuing the following command :</para>

Modified: nALFS/hackers_guide/trunk/part2/hacker/hacker.xml
===================================================================
--- nALFS/hackers_guide/trunk/part2/hacker/hacker.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/part2/hacker/hacker.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -11,7 +11,7 @@
 <sect1>
 
 <para>This chapter contains all the information you need to write code for
-the &book-product;.</para>
+&book-product;.</para>
 
 </sect1>
 

Modified: nALFS/hackers_guide/trunk/part2/hacker/prereqs.xml
===================================================================
--- nALFS/hackers_guide/trunk/part2/hacker/prereqs.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/part2/hacker/prereqs.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -25,6 +25,8 @@
 
 <listitem><para>GCC-3.3 or newer.</para></listitem>
 
+<listitem><para>libxml2 2.6.10 or newer.</para></listitem>
+
 <listitem><para>SVN-1.0.5 or newer.</para></listitem>
 
 <listitem><para>OpenSSL-0.9.7c or newer.</para></listitem>

Modified: nALFS/hackers_guide/trunk/part2/hacker/svn.xml
===================================================================
--- nALFS/hackers_guide/trunk/part2/hacker/svn.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/part2/hacker/svn.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -121,7 +121,7 @@
 <para>All other types of files fall into two categories:</para>
 
 <blockquote><para>those that should be present 
-<emphasis role="bold">only</emphasis> in the CVS repository</para>
+<emphasis role="bold">only</emphasis> in the SVN repository</para>
 </blockquote>
 
 <para>Nothing needs to be done for these files, other than the relevant

Modified: nALFS/hackers_guide/trunk/part3/editor/editor.xml
===================================================================
--- nALFS/hackers_guide/trunk/part3/editor/editor.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/part3/editor/editor.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -34,12 +34,12 @@
 and finally a prerequisites page.</para></listitem>
 
 <listitem><para>Each has an Introduction that contains: a welcome page,
-acknowledgements, docuement conventions, contact info and changelog.</para></listitem>
+acknowledgements, document conventions, contact info and changelog.</para></listitem>
 
 </itemizedlist>
 
 <para>This is where the similarities end.  After this point, each book
-takes on the charastistics necessary for its audience.</para>
+takes on the characteristics necessary for its audience.</para>
 
 <para>The books are available from the SVN repository.  See the <xref
 linkend="common-svn"/> page for instructions.  In the root of the
@@ -49,7 +49,7 @@
 rendered editions.</para>
 
 <para><emphasis role="bold">A note on version numbers</emphasis> :
-The guides each have a seperate version number.  The number is split
+The guides each have a separate version number.  The number is split
 into two pieces.  The first piece is the major and minor version of
 &book-product; that the guide is written for.  The second piece is the
 version of the guide itself.  The version numbering scheme is set up
@@ -59,7 +59,7 @@
 versioned to be the same as the version of the DTD itself.  The ALFS DTD
 is special in this regard.  &book-product; uses the DTD, but the DTD is
 "implementation agnostic" and keeps its own version number
-seperate from any implementation (&book-product; is one implementation
+separate from any implementation (&book-product; is one implementation
 of the ALFS DTD).</para>
 
 </sect1>

Modified: nALFS/hackers_guide/trunk/preface/organization.xml
===================================================================
--- nALFS/hackers_guide/trunk/preface/organization.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/preface/organization.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -28,7 +28,7 @@
 </sect2>
 
 <sect2>
-<title>Part III &emdash; &book-product; Documentataion Editors</title>
+<title>Part III &emdash; &book-product; Documentation Editors</title>
 
 <para>This part contains information just for &book-product;'s documentation
 editors available at <xref linkend="editor"/>.</para>

Modified: nALFS/hackers_guide/trunk/preface/prerequisites.xml
===================================================================
--- nALFS/hackers_guide/trunk/preface/prerequisites.xml	2004-11-15 04:11:35 UTC (rev 1588)
+++ nALFS/hackers_guide/trunk/preface/prerequisites.xml	2004-11-18 03:41:14 UTC (rev 1589)
@@ -8,7 +8,7 @@
 <?dbhtml filename="prerequisites.html" dir="preface"?>
 <title>Prerequisites</title>
 
-<para>There not that many common prerequisites for all of the consituent nALFS components.
-It would be best to see the other sections for details on specific prerequisites.</para>
+<para>There are not that many common prerequisites for all of the
+consituent nALFS components.  It would be best to see their individual sections for details on specific prerequisites.</para>
 
 </sect1>




More information about the alfs-log mailing list