On 25/02/12 23:34, Thomas wrote:
'-i''<level>'::
+
Specifies the level of information that*FvwmCommand*  outputs.
+
[horizontal]
0::: Error messages only
+
------
FvwmCommand -i0 FvwmBanner
------
+
will show a banner without any output. On the other hand,
+
------
FvwmCommand -i 0 foobar
------
+
will return
+
------
[fvwm][executeModule]:<<ERROR>>  No such module
´foobar´ in ModulePath '/usr/lib/X11/fvwm'
------
+
Note that Fvwm doesn't return any error messages in cases like below
since 'windowid' itself is a valid command.
+
------
FvwmCommand -i 0 'windowid foo bar'
------

The 'horizontal' list style emits a two column DocBook table which does not translate very well to the manpage troff format, stick to the default vertical labeled lists (DocBook 'variable' lists) which are rendered much better.

Put this in your manpage:

8<---------------------------------
'-i' '<level>':: Specifies the level of information that *FvwmCommand* outputs.

0::: Error messages only
+
--

------
FvwmCommand -i0 FvwmBanner
------

will show a banner without any output. On the other hand,

------
FvwmCommand -i 0 foobar
------

will return

------
[fvwm][executeModule]: <<ERROR>> No such module
´foobar´ in ModulePath '/usr/lib/X11/fvwm'
------

Note that Fvwm doesn't return any error messages in cases like below
since 'windowid' itself is a valid command.

------
FvwmCommand -i 0 'windowid foo bar'
------

--
8<----------------------------------

Note that I've used a single 'open' block for list item continuation because it's less cluttered and less prone to editing mistakes. Also you don't need a continuation line between the two list items (nested lists are detected automatically by asciidoc), nor does the list item's first text paragraph require explicit continuation.


Cheers, Stuart

--
You received this message because you are subscribed to the Google Groups 
"asciidoc" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/asciidoc?hl=en.

Reply via email to