From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from danbala.tuwien.ac.at (danbala.ifoer.tuwien.ac.at [128.130.168.64]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o58A2f7n032168 for ; Tue, 8 Jun 2010 06:02:42 -0400 (EDT) Received: by danbala.tuwien.ac.at (Postfix, from userid 116) id 1270239086D; Tue, 8 Jun 2010 12:02:40 +0200 (MEST) Date: Tue, 8 Jun 2010 12:02:40 +0200 From: Thomas Klausner To: discuss@mdocml.bsd.lv Subject: Re: OT: Vt vs. Ft/Fn (WAS: Giving up on emulating SYNOPSIS vspace.) Message-ID: <20100608100240.GV16352@danbala.tuwien.ac.at> References: <4C0C2CC4.3040306@bsd.lv> <20100606234253.GA24356@bramka.kerhand.co.uk> <4C0CD40F.70402@bsd.lv> <20100607232645.GD8550@iris.usta.de> <4C0D83E1.5040500@bsd.lv> <20100608000646.GE8550@iris.usta.de> <4C0E09BC.9040900@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: <4C0E09BC.9040900@bsd.lv> On Tue, Jun 08, 2010 at 11:13:32AM +0200, Kristaps Dzonsons wrote: > mdoc.samples documents `Vt' as doing funny business in SYNOPSIS, not > `Va' (wtf?). From what I understand, Vt's the conventional way of > putting variables in the SYNOPSIS. `F' macros are certainly not the > way. > > jmc, wiz, any suggestions and/or observations? I like Ingo's > notation of `Vt/Va'. I've never seen it before (mdocml's manuals > use `Vt' standalone as suggested in mdoc.samples), but you know > better. I found some examples in libelf manpages (from FreeBSD) and a few in random places. More .Vt usage like groff's mdoc(7) describes. > I think we can take this opportunity, in mdoc.7, to specify how > variables should get documented in the SYNOPSIS. And what about the > following: > > - CPP defines? > - structs Vt's? (the `Bd' was used in one of your examples) > > We have `Dv' for defines, but that doesn't help me with wanting to > print out `.Dv #define FOOBAR'. rpcgen(1) actually uses Dv in that case, but it's the only occurrence. For the name of the struct, using Vt is fine, but for the struct definition including members, there currently is no better tag than Bd, which at least keeps it readable. Do we want to extend mdoc? Thomas -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv