OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: Re: DOCBOOK: Re: New element for Step alternatives?


Bob Stayton said:
> Just to be perfectly clear, your example would be
> coded as:
> 
> <procedure>
>   <step>
>      <para>Create a new user account on the system.</para>
>   </step>
>   <step>
>     <para>Set the password for this account using one of
>           the following methods:</para>
>     <stepalternatives>
>       <step>
>         <para>Using the administration GUI, select "Set Password."</para>
>       </step>
>       <step>
>         <para>Modify the /etc/shadow file to contain the new password.</para>
>       </step>
>     </stepalternatives>
>   </step>
> </procedure>
> 
> This is the structure that I would support.
> It is very similar to substeps.  The "stuff"
> in step provides the context information for
> either stepalternatives or substeps.


Exactly.  In fact, we could indeed use substeps from a purely syntaxtic
standpoint (using some attribute to distinguish), but this is very unclear
to writers.  We feel that using an element specifically for alternatives is
more clear for the writing community.


Steve Cogorno
Sun Microsystems


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC