From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from kerhand.co.uk (_smtpd@82-69-137-214.dsl.in-addr.zen.co.uk [82.69.137.214]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o63GqpdS023907 for ; Sat, 3 Jul 2010 12:52:52 -0400 (EDT) Received: from localhost (1000@localhost [IPv6:::1]) by kerhand.co.uk (OpenSMTPD) with ESMTP id 1278175969.90cM1tQLlpqdDzvB for ; Sat, 3 Jul 2010 17:52:25 +0100 (BST) Date: Sat, 3 Jul 2010 17:52:25 +0100 From: Jason McIntyre To: discuss@mdocml.bsd.lv Subject: Re: desired .Bk semantics? Message-ID: <20100703165249.GH20174@bramka.kerhand.co.uk> References: <20100702234320.GC6026@iris.usta.de> <20100703065442.GA5970@bramka.kerhand.co.uk> <4C2F2CA9.2030209@bsd.lv> <20100703141126.GB20174@bramka.kerhand.co.uk> <4C2F644F.3070307@bsd.lv> X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4C2F644F.3070307@bsd.lv> User-Agent: Mutt/1.4.2.3i 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