On Sat, Jul 21, 2001 at 07:48:17PM +0000, Mikhael Goikhman wrote:
> On 21 Jul 2001 19:26:09 +0200, Dominik Vogt wrote:
> > 
> > The recent fixes in the man page for Solaris etc. (\f...) broke
> > the bold typeface of the reformatted sections.  For example: 
> > 
> >   .TP
> >   .BI "Menu " menu-name " [ " position " ] [ " double-click-action " ]"
> > 
> > was changed to
> > 
> >   .IP "Menu \fImenu-name\fP [ \fIposition\fP ] [ \fIdouble-click-action\fP 
> > ]"
> > 
> > The "Menu", "[" and "]" parts of the old version are bold while
> > they are not in the new one.  Of course this can be fixed by
> > adding more \fB...\fP pairs, but I'd *really* prefer to find a way
> > to do that without \f...  Isn't there a way to split the .BI lines
> > into several?  Any ideas are welcome.
> 
> I suggest the following style for all commands:
> 
>   .B "Menu "
>   .I     menu-name
>   .BI    "[ " position " ]"
>   .BI    "[ " double-click-action " ]"
> 
>   .B Popup
>   .I      popup-name
>   .BI     "[ " position " ]"
>   .BI     "[ " default-action " ]"
> 
> I.e. use .B for command, .I for mandatory parameters, .BI for optional.
> I also think, the spaces in braces are not really needed: .BI [ position ]

Looks good to me.  The only thing I don't get working is the
indentation of the text paragraphs:

  .TP
  .B "Menu "
  .I     menu-name
  .BI    "[ " position " ]"
  bla blub

results in

  Menu menu-name [ position ] bla blub

and

  .TP
  .B "Menu "
  .I     menu-name
  .BI    "[ " position " ]"

  bla blub

gives me

  Menu menu-name [ position ] bla blub

        bla blub

but we want

  Menu menu-name [ position ] bla blub
        bla blub

> This syntax is more readable in my opinion. I may do all these changes.

Bye

Dominik ^_^  ^_^

 --

> 
> I.e. use .B for command, .I for mandatory parameters, .BI for optional.
> I also think, the spaces in braces are not really needed: .BI [ position ]

Looks good to me.  The only thing I don't get working is the
indentation of the text paragraphs:

.TP
.B "Menu "
.

> 
> This syntax is more readable in my opinion. I may do all these changes.
> 
> Regards,
.

> 
> This syntax is more readable in my opinion. I may do all these changes.
> 
> Regards,
> Mikhael.
> --
> Visit the official FVWM web page at <URL:http://www.fvwm.org/>.
> To unsubscribe from the list, send "unsubscribe fvwm-workers" in the
> body of a message to [EMAIL PROTECTED]
> To report problems, send mail to [EMAIL PROTECTED]


Bye

Dominik ^_^  ^_^

 --
Dominik Vogt, [EMAIL PROTECTED]
Reply-To: [EMAIL PROTECTED]
--
Visit the official FVWM web page at <URL:http://www.fvwm.org/>.
To unsubscribe from the list, send "unsubscribe fvwm-workers" in the
body of a message to [EMAIL PROTECTED]
To report problems, send mail to [EMAIL PROTECTED]

Reply via email to