cvs commit: ALFS/docs/syntax_doc/preface acknowledgements.xml audience.xml changelog.xml contactinfo.xml conventions.xml

jwrober at linuxfromscratch.org jwrober at linuxfromscratch.org
Mon Nov 3 18:48:55 PST 2003


jwrober     03/11/03 19:48:55

  Modified:    docs/syntax_doc index.xml
               docs/syntax_doc/book book.ent bookinfo.xml
               docs/syntax_doc/preface acknowledgements.xml audience.xml
                        changelog.xml contactinfo.xml conventions.xml
  Log:
  update acknowledgements and other preface items
  
  Revision  Changes    Path
  1.9       +2 -2      ALFS/docs/syntax_doc/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/index.xml,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- index.xml	30 Sep 2003 14:55:47 -0000	1.8
  +++ index.xml	4 Nov 2003 02:48:54 -0000	1.9
  @@ -3,8 +3,8 @@
   			"/usr/share/docbook/docbookx.dtd" [
   
   <!ENTITY alfs-dtd-version "3.1">
  -<!ENTITY version "&alfs-dtd-version;-20030930">
  -<!ENTITY releasedate "September 30th, 2003">
  +<!ENTITY version "&alfs-dtd-version;-20031103">
  +<!ENTITY releasedate "November 3rd, 2003">
   
   <!ENTITY % book      SYSTEM "book/book.ent">
   <!ENTITY % preface   SYSTEM "preface/preface.ent">
  
  
  
  1.2       +1 -1      ALFS/docs/syntax_doc/book/book.ent
  
  Index: book.ent
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/book/book.ent,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- book.ent	27 Sep 2003 04:42:01 -0000	1.1
  +++ book.ent	4 Nov 2003 02:48:54 -0000	1.2
  @@ -14,7 +14,7 @@
   <!ENTITY book-product "ALFS DTD">
   
   <!ENTITY ftp-root "ftp://ftp.linuxfromscratch.org">
  -<!ENTITY http-root "http://ftp.linuxfromscratch.org">
  +<!ENTITY http-root "http://www.linuxfromscratch.org">
   <!ENTITY hints-root "http://www.linuxfromscratch.org/hints">
   <!ENTITY alfs-root "http://www.linuxfromscratch.org/alfs">
   <!ENTITY nbsp " ">
  
  
  
  1.2       +1 -0      ALFS/docs/syntax_doc/book/bookinfo.xml
  
  Index: bookinfo.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/book/bookinfo.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- bookinfo.xml	27 Sep 2003 04:42:01 -0000	1.1
  +++ bookinfo.xml	4 Nov 2003 02:48:54 -0000	1.2
  @@ -2,6 +2,7 @@
   
   <title>&book-product;</title>
   <subtitle>Version &version;</subtitle>
  +
   &book-info-authorgroup;
   &book-info-copyright;
   &book-info-legalnotice;
  
  
  
  1.6       +16 -10    ALFS/docs/syntax_doc/preface/acknowledgements.xml
  
  Index: acknowledgements.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/preface/acknowledgements.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- acknowledgements.xml	30 Sep 2003 01:17:31 -0000	1.5
  +++ acknowledgements.xml	4 Nov 2003 02:48:54 -0000	1.6
  @@ -2,24 +2,30 @@
   <?dbhtml filename="acknowledgements.html" dir="preface"?>
   <title>Acknowledgements</title>
   
  -<para>We would like to thank the following people and organizations for their 
  +<para>We would like to thank the following people and organizations for their
   contributions towards the Automated Linux From Scratch project:</para>
   
   <itemizedlist>
   
  -<listitem><para><ulink url="mailto:vdzuba at linuxfromscratch.org">Vassili 
  -Dzuba</ulink> for helping to create the <acronym>DTD</acronym> and writing the 
  -intial version of this book.</para></listitem>
  +<listitem><para><ulink url="mailto:vassili at linuxfromscratch.org">Vassili
  +Dzuba</ulink>  <vassili at linuxfromscratch.org>  &emdash;
  +  for helping to create the <acronym>DTD</acronym> and writing
  +the intial version of this book.</para></listitem>
   
  -<listitem><para><ulink url="mailto:gerard at linuxfromscratch.org">Gerard 
  -Beekmans</ulink> for being more then a great help.</para></listitem>
  +<listitem><para><ulink url="mailto:gerard at linuxfromscratch.org">Gerard
  +Beekmans</ulink>  <gerard at linuxfromscratch.org>  &emdash;
  +  for being more then a great help.</para></listitem>
   
  -<listitem><para>Jesse Tien-Ten-Que for helping to create the 
  -<acronym>DTD</acronym> and writing the initial version of this 
  +<listitem><para><ulink url="mailto:jwrober at linuxfromscratch.org">James
  +Robertson</ulink>  <jwrober at linuxfromscratch.org>  
  +&emdash;  Current documentation editor.</para></listitem>
  +
  +<listitem><para>Jesse Tien-Ten-Que for helping to create the
  +<acronym>DTD</acronym> and writing the initial version of this
   book.</para></listitem>
   
  -<listitem><para>Countless other people on the <acronym>ALFS</acronym> mailing 
  -list who are making this project happen by giving their suggestions, testing 
  +<listitem><para>Countless other people on the <acronym>ALFS</acronym> mailing
  +list who are making this project happen by giving their suggestions, testing
   the tools and submitting bug reports.</para></listitem>
   
   </itemizedlist>
  
  
  
  1.5       +5 -4      ALFS/docs/syntax_doc/preface/audience.xml
  
  Index: audience.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/preface/audience.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- audience.xml	30 Sep 2003 02:38:46 -0000	1.4
  +++ audience.xml	4 Nov 2003 02:48:54 -0000	1.5
  @@ -2,10 +2,11 @@
   <?dbhtml filename="audience.html" dir="preface"?>
   <title>Who Would Want To Read This Book</title>
   
  -<para>This book is mainly aimed at those who want more information on the 
  -&book-product;. The DTD is designed to be implementation agnostic. This means 
  -that you may be reading this book as part of an <acronym>ALFS</acronym> source 
  -tarball or on the <acronym>ALFS</acronym> website.</para>
  +<para>This book is mainly aimed at those who want more information on the
  +&book-product;. The <acronym>DTD</acronym> is designed to be implementation
  +agnostic. This means that you may be reading this book as part of an
  +<acronym>ALFS</acronym> source tarball or on the <acronym>ALFS</acronym>
  +website.</para>
   
   </sect1>
   
  
  
  
  1.8       +20 -17    ALFS/docs/syntax_doc/preface/changelog.xml
  
  Index: changelog.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/preface/changelog.xml,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- changelog.xml	30 Sep 2003 14:56:10 -0000	1.7
  +++ changelog.xml	4 Nov 2003 02:48:54 -0000	1.8
  @@ -6,49 +6,52 @@
   
   <itemizedlist>
   
  -<listitem><para>September 30th, 2003 [jwrober]: Added an alfs_dtd intro 
  +<listitem><para>November 3rd, 2003 [jwrober]: Updated acknowledgements,
  +conventions and general preface pages.</para></listitem>
  +
  +<listitem><para>September 30th, 2003 [jwrober]: Added an alfs_dtd intro
   page.</para></listitem>
   
  -<listitem><para>September 26th, 2003 [jwrober]: Modified the header of each 
  -page to conform with the DocBook rules that the LFS and BLFS books use (for 
  +<listitem><para>September 26th, 2003 [jwrober]: Modified the header of each
  +page to conform with the DocBook rules that the LFS and BLFS books use (for
   consistency).</para></listitem>
   
  -<listitem><para>September 24th, 2003 [jwrober]: Removed all references to 
  -nALFS, moved files to the ALFS/docs from the ALFS/nALFS/doc moudule in 
  +<listitem><para>September 24th, 2003 [jwrober]: Removed all references to
  +nALFS, moved files to the ALFS/docs from the ALFS/nALFS/doc moudule in
   CVS.</para></listitem>
   
  -<listitem><para>September 22nd, 2003 [jwrober]: Various changes to file 
  -locations and began standardizing document look and feel like the LFS and BLFS 
  +<listitem><para>September 22nd, 2003 [jwrober]: Various changes to file
  +locations and began standardizing document look and feel like the LFS and BLFS
   Books.</para></listitem>
   
  -<listitem><para>September 18th, 2003 [vdzuba]:  Reorganized the document, now 
  +<listitem><para>September 18th, 2003 [vdzuba]:  Reorganized the document, now
   split into small chunks.</para> </listitem>
   
  -<listitem><para>February 20th, 2003 [vdzuba]:  Added the elements <if>, 
  +<listitem><para>February 20th, 2003 [vdzuba]:  Added the elements <if>,
   <then> and <else>.</para></listitem>
   
  -<listitem><para>February 5th, 2003 [vdzuba]:  Added an option to <link> 
  +<listitem><para>February 5th, 2003 [vdzuba]:  Added an option to <link>
   and added element <version>.</para></listitem>
   
  -<listitem><para>January 19th, 2003 [vdzuba]:  Upgraded to version 3.1 of the 
  +<listitem><para>January 19th, 2003 [vdzuba]:  Upgraded to version 3.1 of the
   DTD.</para></listitem>
   
  -<listitem><para>January 8th, 2003 [vdzuba]:  Replaced "option?" by "option*" 
  +<listitem><para>January 8th, 2003 [vdzuba]:  Replaced "option?" by "option*"
   in copy.</para></listitem>
   
  -<listitem><para>December 5th, 2002 [vdzuba]:  Added bash script equivalent to 
  +<listitem><para>December 5th, 2002 [vdzuba]:  Added bash script equivalent to
   all examples.</para></listitem>
   
  -<listitem><para>October 22nd, 2002 [vdzuba]:  Replaced "parent" with "parents" 
  +<listitem><para>October 22nd, 2002 [vdzuba]:  Replaced "parent" with "parents"
   in mkdir.</para></listitem>
   
  -<listitem><para>October 21st, 2002 [vdzuba]:  Added element 
  +<listitem><para>October 21st, 2002 [vdzuba]:  Added element
   <digest>.</para></listitem>
   
  -<listitem><para>October 13th, 2002 [vdzuba]:  Make attribute append of 
  +<listitem><para>October 13th, 2002 [vdzuba]:  Make attribute append of
   <variable> optional.</para></listitem>
   
  -<listitem><para>September 5th, 2002 [vdzuba]:  Added chapter with 
  +<listitem><para>September 5th, 2002 [vdzuba]:  Added chapter with
   syntax.</para></listitem>
   
   <listitem><para>May 7th, 2002 [highos]:  Initial structure.</para></listitem>
  
  
  
  1.6       +55 -2     ALFS/docs/syntax_doc/preface/contactinfo.xml
  
  Index: contactinfo.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/preface/contactinfo.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- contactinfo.xml	30 Sep 2003 01:17:31 -0000	1.5
  +++ contactinfo.xml	4 Nov 2003 02:48:54 -0000	1.6
  @@ -2,8 +2,61 @@
   <?dbhtml filename="contactinfo.html" dir="preface"?>
   <title>Contact Information</title>
   
  -<para>Please direct your emails to the <acronym>ALFS</acronym> mailing list 
  +<sect2>
  +<title>Mailing Lists</title>
  +
  +<para>The &book-product; uses two mailing list hosted from the Linux From
  +Scratch servers.</para>
  +
  +<para>Please direct the majority of your emails to the <acronym>ALFS</acronym> mailing list at
   <ulink url="mailto:alfs-discuss at linuxfromscratch.org">alfs-discuss at linuxfromscratch.org</ulink>.
  -This is an excellent place to post questions and bug reports.</para>
  +This is an excellent place to post questions and bug reports. For complete mailing list information, refer to
  +<ulink url="&http-root;/mailman/listinfo/alfs-discuss">&http-root;/mailman/listinfo/alfs-discuss</ulink>.
  +</para>
  +
  +<para>The second list is really for the development team's use and is available at
  +<ulink url="mailto:alfs-log at linuxfromscratch.org">alfs-log at linuxfromscratch.org</ulink>.
  +This is an excellent place to see the daily activity of the project. For complete mailing list information, refer to
  +<ulink url="&http-root;/mailman/listinfo/alfs-log">&http-root;/mailman/listinfo/alfs-log</ulink>
  +</para>
  +
  +</sect2>
  +
  +<sect2>
  +<title>News Server</title>
  +
  +<para>All the mailing lists hosted at linuxfromscratch.org are also
  +accessible via the <acronym>NNTP</acronym> server. All messages posted to a
  +mailing list will be copied to its correspondent newsgroup, and vice versa.</para>
  +
  +<para>The news server can be reached at
  +<ulink url="news:news.linuxfromscratch.org">news.linuxfromscratch.org</ulink>.
  +</para>
  +
  +</sect2>
  +
  +<sect2>
  +<title>WWW Links</title>
  +
  +<para>Some other links that might interest you:</para>
  +
  +<para>Linux From Scratch:</para>
  +<blockquote><para><ulink url="&http-root;">&http-root;</ulink>
  +</para></blockquote>
  +
  +<para>Automated Linux From Scratch:</para>
  +<blockquote><para><ulink url="&alfs-root;">&alfs-root;</ulink>
  +</para></blockquote>
  +
  +</sect2>
  +
  +<sect2>
  +<title>Other</title>
  +
  +<para>The current &book-product; documentation maintainer is &book-maintainer-fullname;.
  +If you need to reach &book-maintainer-firstname;, send an email to
  +<ulink url="mailto:&book-maintainer-address;">&book-maintainer-address;</ulink>.</para>
  +
  +</sect2>
   
   </sect1>
  
  
  
  1.2       +36 -2     ALFS/docs/syntax_doc/preface/conventions.xml
  
  Index: conventions.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/preface/conventions.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- conventions.xml	30 Sep 2003 02:39:29 -0000	1.1
  +++ conventions.xml	4 Nov 2003 02:48:54 -0000	1.2
  @@ -3,9 +3,43 @@
   <title>Conventions Used In This Book</title>
   
   <para>To make things easy to follow, there are a number of conventions used
  -throughout the book. Following are some examples:</para>
  +throughout the book.  Following are some examples:</para>
   
  -<para>PAGE TO BE WRITTEN</para>
  +<screen><command>./configure --prefix=/usr</command></screen>
  +
  +<blockquote><para>This form of text is designed to be typed in exactly as seen
  +unless otherwise noted in the surrounding text.</para></blockquote>
  +
  +<para><filename>install-info: unknown option
  +'--dir-file=/mnt/lfs/usr/info/dir'</filename></para>
  +
  +<blockquote><para>This form of text (fixed width text) is showing screen
  +output, probably as the result of commands issued and is also used to show
  +filenames such as <filename>/bin/grep</filename></para></blockquote>
  +
  +<para><emphasis>Emphasis</emphasis></para>
  +
  +<blockquote><para>This form of text is used for several purposes in the
  +book but mainly to emphasize important points or to give examples as to
  +what to type.</para></blockquote>
  +
  +<para><ulink url="&alfs-root;">&alfs-root;</ulink></para>
  +
  +<blockquote><para>This form of text is used for hyperlinks, both within the
  +book and to external pages such as HowTo's, download locations,
  +websites, etc.</para></blockquote>
  +
  +<screen><userinput><command>cat > $LFS/etc/group << "EOF"</command>>
  +	root:x:0:
  +	bin:x:1:
  +	......
  +<command>EOF</command></userinput></screen>
  +
  +<blockquote><para>This type of section is used mainly when creating
  +configuration files.  The first command (in bold) tells the system to create
  +the file <filename>$LFS/etc/group</filename> from whatever is typed on the
  +following lines until the sequence <acronym>EOF</acronym> is encountered.
  +Therefore, this whole section is generally typed as seen.</para></blockquote>
   
   </sect1>
   
  
  
  



More information about the alfs-log mailing list