discuss@mandoc.bsd.lv
 help / color / mirror / Atom feed
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

      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).