cvs commit: ALFS/docs/syntax_doc/alfs_dtd elem_package.xml elem_packageinfo.xml

jwrober at linuxfromscratch.org jwrober at linuxfromscratch.org
Sun Feb 22 19:15:20 PST 2004


jwrober     04/02/22 20:15:20

  Modified:    docs/syntax_doc/alfs_dtd elem_package.xml
                        elem_packageinfo.xml
  Log:
  finished first pass across all elements
  
  Revision  Changes    Path
  1.6       +32 -35    ALFS/docs/syntax_doc/alfs_dtd/elem_package.xml
  
  Index: elem_package.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/alfs_dtd/elem_package.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- elem_package.xml	4 Nov 2003 03:07:50 -0000	1.5
  +++ elem_package.xml	23 Feb 2004 03:15:20 -0000	1.6
  @@ -6,22 +6,20 @@
   <title>Syntax</title>
   
   <synopsis>
  -<!ELEMENT package        (packageinfo?,stage+)>
  +<!ELEMENT package        (packageinfo?, stage+)>
   <!ATTLIST package
  -          name           CDATA #REQUIRED
  -          version        CDATA #REQUIRED>
  +             name           CDATA #REQUIRED
  +             version        CDATA #REQUIRED>
   </synopsis>
   
  -<para>This element occurs in the elements
  -<link linkend="elem_alfs">alfs</link>,
  -<link linkend="elem_alfs">else</link>,
  -<link linkend="elem_stage">stage</link>.
  -and <link linkend="elem_then">then</link>
  +<para>This element occurs in the elements :  
  +<xref linkend="elem_alfs"/>  |  
  +<xref linkend="elem_stage"/>
   </para>
   
  -<para>See also :
  -<link linkend="elem_packageinfo">packageinfo</link>,
  -<link linkend="elem_stage">stage</link>.
  +<para>See also :  
  +<xref linkend="elem_packageinfo"/>  |  
  +<xref linkend="elem_stage"/>
   </para>
   
   </sect2>
  @@ -29,38 +27,39 @@
   <sect2>
   <title>Description</title>
   
  -<para>The element <token>package</token> describes the build process
  -of a package.</para>
  +<para>The element <filename>package</filename> is one of the many main
  +operation elements.  It describes the build process of a package.</para>
   
  -<para>The actual build process is described by the <token>stage</token> sub-elements.
  -</para>
  +<para>The actual build process is described by the
  +<filename>stage</filename> sub-elements.</para>
   
  -<para>The attribute <token>name</token> contains the name of the package.</para>
  +<para>The attribute <filename>name</filename> contains the name of the
  +package.</para>
   
  -<para>The attribute <token>version</token> contains the version of the package.</para>
  +<para>The attribute <filename>version</filename> contains the version of
  +the package.</para>
   
   </sect2>
   
   <sect2>
   <title>Examples</title>
   
  -<programlisting>
  -<package name="zlib" version="1.1.4">
  -	<stage name="Unpacking a package.">
  -		<unpack>
  -			<archive>/usr/src/lfs-packages/zlib.1.1.4.tar.gz</archive>
  -			<destination>/usr/src</destination>
  -		</unpack>
  -	</stage>
  -
  -        .....
  -</package>
  -</programlisting>
  +<userinput><screen><package name="zlib"
  +version="1.1.4">
  +	<stage name="Unpacking a package.">
  +		<unpack>
  +			<archive>/usr/src/lfs-packages/zlib.1.1.4.tar.gz</archive>
  +			<destination>/usr/src</destination>
  +		</unpack>
  +	</stage>
  +
  +	.....
   
  -<para>The equivalent bash script is :</para>
  +</package></screen></userinput>
   
  -<programlisting>
  -echo Generating package zlib 1.1.4
  +<para>The equivalent bash script is :</para>
  +
  +<userinput><screen>echo Generating package zlib 1.1.4
   
   #-----------------------------------------
   echo Stage "Unpacking a package."
  @@ -77,9 +76,7 @@
   
   ...
   
  -echo End of generating package zlib 1.1.4
  -
  -</programlisting>
  +echo End of generating package zlib 1.1.4</screen></userinput>
   
   </sect2>
   
  
  
  
  1.6       +19 -53    ALFS/docs/syntax_doc/alfs_dtd/elem_packageinfo.xml
  
  Index: elem_packageinfo.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/alfs_dtd/elem_packageinfo.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- elem_packageinfo.xml	4 Nov 2003 03:07:50 -0000	1.5
  +++ elem_packageinfo.xml	23 Feb 2004 03:15:20 -0000	1.6
  @@ -6,17 +6,17 @@
   <title>Syntax</title>
   
   <synopsis>
  -<!ELEMENT packageinfo    (description?,requires*,utilizes*)>
  +<!ELEMENT packageinfo    (description?, requires*, utilizes*)>
   </synopsis>
   
  -<para>This element occurs in the element
  -<link linkend="elem_package">package</link>.
  +<para>This element occurs in the element :  
  +<xref linkend="elem_package"/>
   </para>
   
  -<para>See also :
  -<link linkend="elem_description">description</link>,
  -<link linkend="elem_requires">requires</link>.
  -<link linkend="elem_utilizes">utilizes</link>.
  +<para>See also :  
  +<xref linkend="elem_description"/>  |  
  +<xref linkend="elem_requires"/>  |  
  +<xref linkend="elem_utilizes"/>
   </para>
   
   </sect2>
  @@ -24,59 +24,27 @@
   <sect2>
   <title>Description</title>
   
  -<para>The element <token>packageinfo</token> groups
  -elements containg information about the package, namely
  -a description and some deopendency relationship.</para>
  +<para>The element <filename>packageinfo</filename> groups elements containg
  +information about the package, namely a description and some deopendency
  +relationship.</para>
   
  -<para>The description of the packge is contained
  -in the <token>description</token> sub-element.
  -</para>
  +<para>The description of the packge is contained in the
  +<filename>description</filename> sub-element.</para>
   
  -<para>The relationship "depends-on" is described
  -by the <token>requires</token> sub-element.
  -</para>
  +<para>The relationship "depends-on" is described by the
  +<filename>requires</filename> sub-element.</para>
   
  -<para>The relationship "will utilize" is described
  -by the <token>utilizes</token> sub-element.
  -</para>
  +<para>The relationship "will utilize" is described by the
  +<filename>utilizes</filename> sub-element.</para>
   
   </sect2>
   
   <sect2>
   <title>Examples</title>
   
  -<programlisting>
  -    <package name="gimp" version="1.2.3">
  -        <packageinfo>
  -	        <description>
  -                    <para>The gimp package contains the GNU Image
  -		    Manipulation Program.
  -		    This is useful for photo retouching, image
  -		    composition and image authoring.
  -		    </para>
  -		</description>
  -
  -                <requires><name>gtk+</name></requires>
  -
  -		<utilizes><name>libtiff</name></utilizes>
  -		<utilizes><name>libpng</name></utilizes>
  -		<utilizes><name>libjpeg</name></utilizes>
  -		<utilizes><name>aalib</name></utilizes>
  -		<utilizes><name>mpeg_lib</name></utilizes>
  -		<utilizes><name>python</name></utilizes>
  -
  -        </required>
  -
  -	....
  -
  -    </package>
  +<para>The equivalent bash script is :</para>
   
  -</programlisting>
  -
  -<para>The equivalent bash script is :</para>
  -
  -<programlisting>
  -echo Generating package zlib 1.1.4
  +<userinput><screen>echo Generating package zlib 1.1.4
   
   #-----------------------------------------
   echo Stage "Unpacking a package."
  @@ -93,9 +61,7 @@
   
   ...
   
  -echo End of generating package zlib 1.1.4
  -
  -</programlisting>
  +echo End of generating package zlib 1.1.4</screen></userinput>
   
   </sect2>
   
  
  
  



More information about the alfs-log mailing list