Author: locilka
Date: Fri Jul 11 11:51:54 2008
New Revision: 48983
URL: http://svn.opensuse.org/viewcvs/yast?rev=48983&view=rev
Log:
- Added documentation for AC Setup and for texts in control file.
Added:
trunk/installation/control/docs/examples/globals-automatic_configuration.xml
trunk/installation/control/docs/examples/texts.xml
Modified:
trunk/installation/control/docs/control-doc.xml
trunk/installation/control/docs/control-section.xml
trunk/installation/package/yast2-installation.changes
Modified: trunk/installation/control/docs/control-doc.xml
URL: http://svn.opensuse.org/viewcvs/yast/trunk/installation/control/docs/control-doc.xml?rev=48983&r1=48982&r2=48983&view=diff
==============================================================================
--- trunk/installation/control/docs/control-doc.xml (original)
+++ trunk/installation/control/docs/control-doc.xml Fri Jul 11 11:51:54 2008
@@ -14,25 +14,24 @@
<firstname>Anas</firstname>
<surname>Nashif</surname>
<affiliation>
- <orgname> SUSE Linux AG</orgname>
+ <orgname>SUSE Linux AG</orgname>
+ </affiliation>
+ </author>
+ <author>
+ <firstname>Jiri</firstname>
+ <surname>Srain</surname>
+ <affiliation>
+ <orgname>SUSE Linux, s.r.o.</orgname>
+ </affiliation>
+ </author>
+ <author>
+ <firstname>Lukas</firstname>
+ <surname>Ocilka</surname>
+ <affiliation>
+ <orgname>SUSE Linux, s.r.o.</orgname>
</affiliation>
</author>
</authorgroup>
- <copyright>
- <year>2004</year>
- <holder> SUSE Linux AG</holder>
- </copyright>
- <revhistory>
- <revision>
- <revnumber>
- 0.1
- </revnumber>
- <date>
- $Date$
- </date>
- <revremark>Initial Release as PDF</revremark>
- </revision>
- </revhistory>
</articleinfo>
Modified: trunk/installation/control/docs/control-section.xml
URL: http://svn.opensuse.org/viewcvs/yast/trunk/installation/control/docs/control-section.xml?rev=48983&r1=48982&r2=48983&view=diff
==============================================================================
--- trunk/installation/control/docs/control-section.xml (original)
+++ trunk/installation/control/docs/control-section.xml Fri Jul 11 11:51:54 2008
@@ -172,7 +172,7 @@
<section id="control_configuration">
<title>Configuration</title>
<section id="control_workflows">
- <title>workflows</title>
+ <title>Workflows</title>
<para>
Using the control file, multiple workflows can be defined for
@@ -412,6 +412,60 @@
</itemizedlist>
</section>
+ <!-- FATE #303939: Enable redetection of hardware at customer first boot -->
+ <section id="control_globals_automatic_configuration">
+ <title>Automatic Configuration</title>
+
+ <para>This is another feature defined in <emphasis>globals</emphasis> section.
+ <emphasis>Automatic Configuration</emphasis> is called via the script
+ <emphasis>inst_automatic_configuration</emphasis> at the end of the second stage
+ installation. Having the configuration in control file enables this function for
+ another modes and makes it very well configurable.</para>
+
+ <para>This is an example of AC setup:</para>
+ <programlisting>
+ http://www.w3.org/2001/XInclude"/>
+ </programlisting>
+
+ <para>AC setup <emphasis>automatic_configuration</emphasis> consists of list of several
+ <emphasis>ac_step</emphasis> definitions. On definition for one AC step. These steps
+ can be compared to sets of scripts or sets of installation proposals, e.g.,
+ <emphasis>network proposal</emphasis> that consists of <emphasis>lan</emphasis>,
+ <emphasis>modem</emphasis>, ... and <emphasis>firewall</emphasis> proposals which
+ might depend on each others proposals.</para>
+
+ <para>Every single <emphasis>ac_step</emphasis> consists of</para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis>text_id</emphasis> - which is the very same ID as used in
+ <link linkend="control_texts">texts</link> (you have to define the AC label
+ there).</para>
+ </listitem>
+ <listitem>
+ <para><emphasis>type</emphasis> - defines how the AC step items will
+ be handled. Possible values are <emphasis>scripts</emphasis> or
+ <emphasis>proposals</emphasis>. More types cannot be mixed within one AC step.
+ All <emphasis>scripts</emphasis> are called only once one by one,
+ all <emphasis>proposals</emphasis> in one AC step are called first with
+ <emphasis>MakeProposal</emphasis> parameter then again all with
+ <emphasis>Write</emphasis> parameter.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis>ac_items</emphasis> - is a list of scripts or proposals each in
+ a separate <emphasis>ac_item</emphasis>.</para>
+
+ <para>For scripts an <emphasis>ac_item</emphasis> is a name
+ of YaST client script without <emphasis>inst_</emphasis> prefix, e.g.,
+ <emphasis>firewall</emphasis> would call <emphasis>inst_firewall</emphasis> script.</para>
+
+ <para>For proposals an <emphasis>ac_item</emphasis> is a name
+ of YaST proposal without <emphasis>_proposal</emphasis> suffix, e.g.,
+ <emphasis>firewall</emphasis> would call <emphasis>firewall_proposal</emphasis>.</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
<section id="control_software">
<title>Software</title>
<para>
@@ -1192,5 +1246,23 @@
</programlisting>
</section>
+
+ <section id="control_texts">
+ <title>Texts</title>
+
+ <para>Some kind of texts can be, of course, placed in several parts of the control
+ file but they wouldn't be translated. This control file section makes it possible to
+ mark some texts for translation.</para>
+
+ <para>The structure is rather easy:</para>
+
+ <programlisting>
+ http://www.w3.org/2001/XInclude"/>
+ </programlisting>
+
+ <para>Translated texts can be got using
+ <emphasis>ProductControl::GetTranslatedText (text_id)</emphasis> call.</para>
+ </section>
</section>
</section>
Added: trunk/installation/control/docs/examples/globals-automatic_configuration.xml
URL: http://svn.opensuse.org/viewcvs/yast/trunk/installation/control/docs/examples/globals-automatic_configuration.xml?rev=48983&view=auto
==============================================================================
--- trunk/installation/control/docs/examples/globals-automatic_configuration.xml (added)
+++ trunk/installation/control/docs/examples/globals-automatic_configuration.xml Fri Jul 11 11:51:54 2008
@@ -0,0 +1,49 @@
+
+<globals>
+ ...
+
+ <!-- List of steps in AC -->
+
+
+ <!-- One step definition -->
+
+ ac_1
+ <type>scripts</type>
+
+ initialization
+ hostname
+ netprobe
+ rpmcopy_secondstage
+
+
+
+ ...
+
+
+ ac_3
+ <type>proposals</type>
+
+ x11
+ printer
+ sound
+ tv
+
+
+
+ ...
+
+
+ ...
+</globals>
+
+<texts>
+
+ ...
+
+ <!-- Label used during AC, uses "text_id" from "ac_step" -->
+ <label>Initialization...</label>
+ <label>Configuring hardware...</label>
+
+ ...
+
+</texts>
\ No newline at end of file
Added: trunk/installation/control/docs/examples/texts.xml
URL: http://svn.opensuse.org/viewcvs/yast/trunk/installation/control/docs/examples/texts.xml?rev=48983&view=auto
==============================================================================
--- trunk/installation/control/docs/examples/texts.xml (added)
+++ trunk/installation/control/docs/examples/texts.xml Fri Jul 11 11:51:54 2008
@@ -0,0 +1,11 @@
+
+<texts>
+ <!-- Unique tag that identifies the text -->
+
+ <label>Some XML-escaped text: <b>bold </b>.</label>
+
+
+ <congratulate>
+ <label><p><b>Congratulations!</b></p></label>
+ </congratulate>
+</texts>
\ No newline at end of file
Modified: trunk/installation/package/yast2-installation.changes
URL: http://svn.opensuse.org/viewcvs/yast/trunk/installation/package/yast2-installation.changes?rev=48983&r1=48982&r2=48983&view=diff
==============================================================================
--- trunk/installation/package/yast2-installation.changes (original)
+++ trunk/installation/package/yast2-installation.changes Fri Jul 11 11:51:54 2008
@@ -1,4 +1,9 @@
-------------------------------------------------------------------
+Fri Jul 11 11:11:11 CEST 2008 - locilka@suse.cz
+
+- Added documentation for AC Setup and for texts in control file.
+
+-------------------------------------------------------------------
Thu Jul 10 17:48:59 CEST 2008 - locilka@suse.cz
- Settings for Automatic Configuration moved to control file
--
To unsubscribe, e-mail: yast-commit+unsubscribe@opensuse.org
For additional commands, e-mail: yast-commit+help@opensuse.org