Re: desired .Bk semantics?

[Jason McIntyre <jmc@kerhand.co.uk>]

On Sat, Jul 03, 2010 at 06:24:47PM +0200, Kristaps Dzonsons wrote:
> 
> Ingo and Jason,
> 
> I propose the following.  I've enclosed a patch that demonstrates this.
> 
> First, I disabled `Bk' completely.
> 
> Second, when `Op' or `Oo' is encountered with MDOC_SYNPRETTY (i.e., in a
> SYNOPSIS section or with ".nr nS 1"), spaces are made non-breaking.
> 
> Example (mandoc -Owidth=70 ssh.1):
> 
> SYNOPSIS
>      ssh [-1246AaCfgKkMNnqsTtVvXxYy] [-b bind_address]
>          [-c cipher_spec] [-D [bind_address:]port] [-e escape_char]
>          [-F configfile] [-I pkcs11] [-i identity_file]
>          [-L [bind_address:]port:host:hostport] [-l login_name]
>          [-m mac_spec] [-O ctl_cmd] [-o option] [-p port]
>          [-R [bind_address:]port:host:hostport] [-S ctl_path]
>          [-W host:port] [-w local_tun[:remote_tun]] [user@]hostname
>          [command]
> 
> Note: this is after removing the escaped spaces that the manual author
> had added here and there.
> 
> Example (mandoc -Owidth=70 spamd.8):
>      spamd [-45bdv] [-B maxblack] [-c maxcon]
>            [-G passtime:greyexp:whiteexp] [-h hostname] [-l address]
>            [-M address] [-n name] [-p port] [-S secs] [-s secs]
>            [-w window] [-Y synctarget] [-y synclisten]
> 
> This removes the `Bk' mess and gives a nice, regular algorithm for
> formatting in MDOC_SYNPRETTY.
> 
> It can/will be trivially extended to the function macros, Fa and Fn and
> family.
> 
> Thoughts?
> 

spiffing!

i wonder though about disabling Bk...do you mean it just ignores it, or
that the current Bk/Ek in files will cause a problem? i'm not averse to
removing them from pages, but i need to think about our pages being
formatted on another system. for example, for ssh.1 to have a fighting
chance on a non-mandoc system.

i don;t know how practical that is though. i haven;t thought very far
ahead about this. keep the keeps (er) or remove them...

jmc
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv