Re: NEWBIE: getting your document structure right.. :)

[Norman Walsh <ndw@nwalsh.com>]

/ Jorge Godoy <godoy@conectiva.com.br> was heard to say:
| On Tue, Feb 22, 2000 at 09:42:15PM -0700, Dan Miner wrote:
| > 
| > <Goals>
| >   <GoalDef>my goal</GoalDef>
| >   <GoalExplain>more details about why this goal is important, etc.</GoalExplain>
| >   <GoalDef>my goal 2</GoalDef>
| >   <GoalExplain>more text about why this goal is important, etc.</GoalExplain>
| > </Goals>
| > 
| > I understand display is somewhat a secondary concern but I'l hoping
| > for a display like:
| > 
| > 	* my goal
| > 	  more details about why this goal is important, etc.
| > 
| > 	* my goal 2
| > 	  more text about why this goal is important, etc.
| 
| It seems to me like a variablelist.

I agree, with perhaps some stylesheet tweaks to get precisely that
formatting.

| > Also, how can I express example information/code/command that is actually
| > part of the paragraph flow?
| > 
| > For example:
| > 
| > <para>Be sure to run <InlineExample role=eg>G C000</InlineExample> your newly
| > created program by using the monitor run or go command.</para>
| > 
| > Formatted as:
| > Be sure to run (e.g. G C000) your newly created program by using the
| > monitor run or go command.
| 
| You'll have to create this new element or modify some element's
| appearance using a stylesheet. 

Oh, I really try to avoid that answer whenever possible because it makes
the documents much less portable. I'd be tempted myself to use
<literal>, <userinput>, or even <systemitem role="inlineexample">
before creating a new element.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | If you are hankering after
http://nwalsh.com/                 | certainty, you are better advised
                                   | to seek it in religion: the
                                   | stock-in-trade of science is not
                                   | certainty but doubt.--K.C. Cole