From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp-2.sys.kth.se (smtp-2.sys.kth.se [130.237.32.160]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o76Fl5HP005387 for ; Fri, 6 Aug 2010 11:47:06 -0400 (EDT) Received: from smtp-2.sys.kth.se (localhost [127.0.0.1]) by smtp-2.sys.kth.se (Postfix) with ESMTP id EF42B14F10B for ; Fri, 6 Aug 2010 17:46:59 +0200 (CEST) X-Virus-Scanned: by amavisd-new at kth.se Received: from smtp-2.sys.kth.se ([127.0.0.1]) by smtp-2.sys.kth.se (smtp-2.sys.kth.se [127.0.0.1]) (amavisd-new, port 10024) with LMTP id eDuYzsknZgXb for ; Fri, 6 Aug 2010 17:46:57 +0200 (CEST) X-KTH-Auth: kristaps [85.8.60.193] X-KTH-mail-from: kristaps@bsd.lv X-KTH-rcpt-to: discuss@mdocml.bsd.lv Received: from lappy.bsd.lv (h85-8-60-193.dynamic.se.alltele.net [85.8.60.193]) by smtp-2.sys.kth.se (Postfix) with ESMTP id F30A214C137 for ; Fri, 6 Aug 2010 17:46:56 +0200 (CEST) Message-ID: <4C5C2E70.9000506@bsd.lv> Date: Fri, 06 Aug 2010 17:46:56 +0200 From: Kristaps Dzonsons User-Agent: Thunderbird 2.0.0.16 (X11/20080812) X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 To: discuss@mdocml.bsd.lv Subject: Re: mdoc.7 tweaks References: <20100802190029.GA20950@bramka.kerhand.co.uk> <20100802205711.GA7805@iris.usta.de> <20100802210717.GB20950@bramka.kerhand.co.uk> In-Reply-To: <20100802210717.GB20950@bramka.kerhand.co.uk> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Jason McIntyre wrote: > On Mon, Aug 02, 2010 at 10:57:11PM +0200, Ingo Schwarze wrote: >> Everything not related to .Sx / .Sy is ok schwarze@. >> >>> *) uses Sy for macros instead of Sx. we could use something else but >>> not, please, Sx. >> Hmm, i'm not sure. >> Using exactly Sx (and not anything else) has a point. >> On http://mdocml.bsd.lv/mdoc.7.html , you can easily navigate >> the whole manual using the macro hyperlinks. >> I know that is irrelevant for man(1), and for terminal output >> in general, but it may still be considered useful. >> > > hmm. so i have probably confused two things: when we are talking about a > section, Sx is correct. but to just refer to macros, we shouldn;t use > Sx. but i see now that the macro name was additionally also a macro > name. > >> That seems easy; i guess it's a typo, and i would just change lb to lB >> and rb to rB, like this: >> >> \&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBargs...\(rB \(lBres...\(rB >> > > ah. > >> Are you really sure we should switch from .Sx to .Sy right now? >> >> If yes, we need to get it right at once, including choosing the >> macro we really want, but i do not want to digress into .Sy vs. .Ic >> vs. whatever bikeshedding as long as we do not even agree that we >> need to get rid of .Sx at all. >> >> If no, will you pull the .Sx/.Sy parts out of the diff for now, >> or shall i do it? >> > > we should undo the Sx/Sy parts of my diff. which is most of the diff ;( > anyway, i have to sleep now. if you want to take this further, carry on. > if not i'll try and find time tomorrow to redo it. Hi, (Note that I'm back...) I'm fine with using `Sy' within the "usage" section when used with the macro already being documented, but in general I heavily use `Sx' because it works so well with the hyperlinking. I'm fine with the other changes, although I didn't look them over carefully. Ingo, since you've looked this over carefully, can you check this in when you'd like? I'm not sure what the OpenBSD/mandoc sync state is with respect to mdoc.7, but they should be consistent. Thanks, Kristaps -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv