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

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-tc message

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


Subject: DocBook TC teleconference Agenda Item 5.


 Hello Everyone!
 In preparation for tomorrow's telconference, below is a brief 
 writeup of the discussion points for Agenda Item 5.4:
 
 RFE145 Allow additional material after the last step in a Procedure
  
  
 Which was submitted by Sun Microsystems.
 regards,
 Dennis Evans
 Sabine Ocker 
 
	Reasons for request:

- This change will allow titled sections within Procedures
  following the Steps. This is useful for related Examples,
  Where to go from Here info, etc.

- It provides structure (content and title), but is not intended
   to be a major element. The intention is that this is an end
   point, you cannot go anywhere else from here in the hierarchy.
   This section should not contain any other titled material.
   
Requirements:

	- Does not need to be in TOC
	
	- Can be xrefed
	
	- Can have conditional gentext or display based on
	 attributes such as arch


Content model being approximately:

<!ELEMENT Procedure - - (
        (Title, TitleAbbrev?)?, (%component.mix), 
        step+, SimpleSect?)
        	
Sample of how we work around it now:
	
<sect1>
<title>Creating Concatenations</title>
<para>Do not use this procedure on an existing file system or 
data.</para>

<sect2 role="procedure">
<title>How to Create a Concatenation</title>
<procedure>
<step>
<para>Check the prerequisites (<xref linkend="addtasks-20933">) 
and the preliminary information.</para>
</step>
<step>
<para>To create the concatenation from the Solaris Management 
Console</para>
</step>
<step>
<para>To create the concatenation from the command line, use the 
following form of the metainit command:</para>
</step>
</procedure>

<sect3>
<title>Where To Go From Here</title>
<para>Information for the IA archtecture is different.</para>
</sect3>
</sect2>
</sect1>

Sample of how we want to do it:

<sect1>
<title>Creating Concatenations</title>
<para>Do not use this procedure on an existing file system or 
data.</para>

<procedure>
<title>How to Create a Concatenation</title>
<procedure>
<step>
<para>Check the prerequisites (<xref linkend="addtasks-20933">) 
and the preliminary information.</para>
</step>
<step>
<para>To create the concatenation from the Solaris Management 
Console</para>
</step>
<step>
<para>To create the concatenation from the command line, use the 
following form of the metainit command:</para>
</step>

<simplesect>
<title>Where To Go From Here</title>
<para>Information for the IA archtecture is different.</para>
</simplesect>
</procedure>
</sect2>
</sect1>







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


Powered by eList eXpress LLC