From: Jason McIntyre <jmc@kerhand.co.uk>
To: discuss@mdocml.bsd.lv
Subject: Re: .Li hiccup (and \*(Pu issue)
Date: Wed, 26 May 2010 07:55:45 +0059 [thread overview]
Message-ID: <20100526065609.GB28547@bramka.kerhand.co.uk> (raw)
In-Reply-To: <20100525232818.GA29800@iris.usta.de>
On Wed, May 26, 2010 at 01:28:18AM +0200, Ingo Schwarze wrote:
> >
> > % egrep 'Li [:.;] ' `cat manuals.txt `
> > usr.sbin/bgpd/bgpd.conf.5:.Ar as-number Ns Li : Ns Ar local ,
>
> Cargo-cult alert: Why not just
>
> .Ar as-number : Ns Ar local ,
>
> That seems to work with all our formatters, and i don't see why
> it shouldn't work, or why we should put any more macros in there.
>
well, my reading of that example would be the author wants `:' in a
literal font. but after reading your mail, i'm not sure whether you
think that should be the result or not.
that is, i don;t know whether you think i should change the expr.1
example and the \*(Pu example, or whether you think mandoc itself should
be changed. can you clarify this please? (then if it's a mandoc change,
i can bow out of the discussion ;)
but getting back to your example, no matter what was intended, i'd say
that your example without Li is much better anyway. Li is a colossal
waste of space.
>
> That said, i think
>
> .Ar expr1 No : Ar expr2
>
> is easier to understand and might look better in variable-width
> output - of course, it is currently broken in the same way as
> in the .Li, .Fl and .Ar cases, the empty .No is missing from
> the syntax tree just like the other ones.
>
i think the No is needless here too.
jmc
--
To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv
prev parent reply other threads:[~2010-05-26 6:56 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <20100525065543.GB8074@bramka.kerhand.co.uk>
[not found] ` <4BFBCEBB.4070205@bsd.lv>
[not found] ` <20100525141839.GG8074@bramka.kerhand.co.uk>
2010-05-25 20:42 ` Kristaps Dzonsons
2010-05-25 22:38 ` Jason McIntyre
2010-05-25 23:28 ` Ingo Schwarze
2010-05-26 0:49 ` Kristaps Dzonsons
2010-05-26 6:56 ` Jason McIntyre [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20100526065609.GB28547@bramka.kerhand.co.uk \
--to=jmc@kerhand.co.uk \
--cc=discuss@mdocml.bsd.lv \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).