cvs commit: ALFS/docs/syntax_doc/alfs_dtd elem_option.xml elem_ownership.xml

jwrober at linuxfromscratch.org jwrober at linuxfromscratch.org
Sun Feb 22 19:14:56 PST 2004


jwrober     04/02/22 20:14:56

  Modified:    docs/syntax_doc/alfs_dtd elem_option.xml elem_ownership.xml
  Log:
  finished first pass across all elements
  
  Revision  Changes    Path
  1.6       +17 -21    ALFS/docs/syntax_doc/alfs_dtd/elem_option.xml
  
  Index: elem_option.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/alfs_dtd/elem_option.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- elem_option.xml	4 Nov 2003 03:07:50 -0000	1.5
  +++ elem_option.xml	23 Feb 2004 03:14:56 -0000	1.6
  @@ -6,24 +6,24 @@
   <title>Syntax</title>
   
   <synopsis>
  -<!ELEMENT option         (#PCDATA)>
  +<!ELEMENT option         (#PCDATA)>
   </synopsis>
   
  -<para>This element occurs in the elements
  -<link linkend="elem_copy">copy</link>,
  -<link linkend="elem_link">link</link>,
  -<link linkend="elem_mkdir">mkdir</link>,
  -<link linkend="elem_move">move</link>,
  -<link linkend="elem_ownership">ownership</link>
  -and <link linkend="elem_permissions">permissions</link>.
  -.</para>
  +<para>This element occurs in the elements :  
  +<xref linkend="elem_copy"/>  |  
  +<xref linkend="elem_link"/>  |  
  +<xref linkend="elem_mkdir"/>  |  
  +<xref linkend="elem_move"/>  |  
  +<xref linkend="elem_ownership"/>  |  
  +<xref linkend="elem_permissions"/>
  +</para>
   
   </sect2>
   
   <sect2>
   <title>Description</title>
   
  -<para>The element <token>option</token> allows to specify an option
  +<para>The element <filename>option</filename> allows to specify an option
   of the englobing element.</para>
   
   </sect2>
  @@ -31,20 +31,16 @@
   <sect2>
   <title>Examples</title>
   
  -<programlisting>
  -<mkdir base="/usr/local/lib">
  -   <option>parents</option>
  -   <name>X11</name>
  -</mkdir>
  -</programlisting>
  +<userinput><screen><mkdir base="/usr/local/lib">
  +	<option>parents</option>
  +	<name>X11</name>
  +</mkdir></screen></userinput>
   
  -<para>The equivalent bash script is :</para>
  +<para>The equivalent bash script is :</para>
   
  -<programlisting>
  -cd /usr/local/lib
  +<userinput><screen>cd /usr/local/lib
   echo Making directory X11
  -mkdir -p X11
  -</programlisting>
  +<command>mkdir -p X11</command></screen></userinput>
   
   </sect2>
   
  
  
  
  1.6       +43 -53    ALFS/docs/syntax_doc/alfs_dtd/elem_ownership.xml
  
  Index: elem_ownership.xml
  ===================================================================
  RCS file: /home/cvsroot/ALFS/docs/syntax_doc/alfs_dtd/elem_ownership.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- elem_ownership.xml	4 Nov 2003 03:07:50 -0000	1.5
  +++ elem_ownership.xml	23 Feb 2004 03:14:56 -0000	1.6
  @@ -6,23 +6,21 @@
   <title>Syntax</title>
   
   <synopsis>
  -<!ELEMENT ownership      (option?, name+)>
  +<!ELEMENT ownership      (option?, name+)>
   <!ATTLIST ownership
  -          base           CDATA #IMPLIED
  -          user           CDATA #IMPLIED
  -          group          CDATA #IMPLIED>
  +             base           CDATA #IMPLIED
  +             user           CDATA #IMPLIED
  +             group          CDATA #IMPLIED>
   </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_option">option</link>,
  -<link linkend="elem_name">name</link>.
  +<para>See also :  
  +<xref linkend="elem_option"/>  |  
  +<xref linkend="elem_name"/>
   </para>
   
   </sect2>
  @@ -30,21 +28,22 @@
   <sect2>
   <title>Description</title>
   
  -<para>The element <token>ownership</token> is used to perform
  -a group and/or user ownership change on a file or set of files</para>
  +<para>The element <filename>ownership</filename> is one of the many main
  +operation elements.  It is used to perform a group and/or user ownership
  +change on a file or set of files</para>
   
   <para>The only option supported is "recursive"</para>
   
  -<para>The sub-element <token>name</token> contains the name of the
  +<para>The sub-element <filename>name</filename> contains the name of the
   file (or directory) whose ownership is to be changed.</para>
   
  -<para>The attribute <token>base</token> specifies the directory
  +<para>The attribute <filename>base</filename> specifies the directory
   in which the command is performed.</para>
   
  -<para>The attribute <token>user</token> specifies the name of the user
  +<para>The attribute <filename>user</filename> specifies the name of the user
   which will own the file or directory</para>
   
  -<para>The attribute <token>group</token> specifies the name of the group
  +<para>The attribute <filename>group</filename> specifies the name of the group
   which will own the file or directory</para>
   
   </sect2>
  @@ -54,56 +53,47 @@
   
   <para>The first example uses symbolic names.</para>
   
  -<programlisting>
  -<ownership user="root" group="root">
  -    <option>recursive</option>
  -    <name>/etc/rc.d</name>
  -    <name>/etc/sysconfig</name>
  -</ownership>
  -</programlisting>
  -
  -<para>The equivalent bash script is :</para>
  -
  -<programlisting>
  -echo Changing group of /etc/rc.d into root
  -chgrp -R root /etc/rc.d
  +<userinput><screen><ownership user="root" group="root">
  +	<option>recursive</option>
  +	<name>/etc/rc.d</name>
  +	<name>/etc/sysconfig</name>
  +</ownership></screen></userinput>
  +
  +<para>The equivalent bash script is :</para>
  +
  +<userinput><screen>echo Changing group of /etc/rc.d into root
  +<command>chgrp -R root /etc/rc.d</command>
   
   echo Changing owner of /etc/rc.d into root
  -chown -R root /etc/rc.d
  +<command>chown -R root /etc/rc.d</command>
   
   echo Changing group of /etc/sysconfig into root
  -chgrp -R root /etc/sysconfig
  +<command>chgrp -R root /etc/sysconfig</command>
   
   echo Changing owner of /etc/sysconfig into root
  -chown -R root /etc/sysconfig
  -</programlisting>
  +<command>chown -R root /etc/sysconfig</command></screen></userinput>
   
   <para>The second example uses numeric values (0 = root).</para>
   
  -<programlisting>
  -<ownership user="0" group="0">
  -    <option>recursive</option>
  -    <name>/etc/rc.d</name>
  -    <name>/etc/sysconfig</name>
  -</ownership>
  -</programlisting>
  -<para></para>
  -
  -<para>The equivalent bash script is :</para>
  -
  -<programlisting>
  -echo Changing group of /etc/rc.d into 0
  -chgrp -R 0 /etc/rc.d
  +<userinput><screen><ownership user="0" group="0">
  +	<option>recursive</option>
  +	<name>/etc/rc.d</name>
  +	<name>/etc/sysconfig</name>
  +</ownership></screen></userinput>
  +
  +<para>The equivalent bash script is :</para>
  +
  +<userinput><screen>echo Changing group of /etc/rc.d into 0
  +<command>chgrp -R 0 /etc/rc.d</command>
   
   echo Changing owner of /etc/rc.d into 0
  -chown -R 0 /etc/rc.d
  +<command>chown -R 0 /etc/rc.d</command>
   
   echo Changing group of /etc/sysconfig into 0
  -chgrp -R 0 /etc/sysconfig
  +<command>chgrp -R 0 /etc/sysconfig</command>
   
   echo Changing owner of /etc/sysconfig into 0
  -chown -R 0 /etc/sysconfig
  -</programlisting>
  +<command>chown -R 0 /etc/sysconfig</command></screen></userinput>
   
   </sect2>
   
  
  
  



More information about the alfs-log mailing list