Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 3 May 2017 04:54:16 +1000 (EST)
From:      Bruce Evans <brde@optusnet.com.au>
To:        Ed Maste <emaste@freebsd.org>
Cc:        Bruce Evans <brde@optusnet.com.au>, Konstantin Belousov <kib@freebsd.org>,  "src-committers@freebsd.org" <src-committers@freebsd.org>,  "svn-src-all@freebsd.org" <svn-src-all@freebsd.org>,  "svn-src-head@freebsd.org" <svn-src-head@freebsd.org>
Subject:   Re: svn commit: r317681 - head/share/man/man7
Message-ID:  <20170503044547.N3070@besplex.bde.org>
In-Reply-To: <CAPyFy2Ckp4fvyngx0brfcHBzRBsCbYWkomzZuvD8ajMy7kZhBA@mail.gmail.com>
References:  <201705021452.v42EqZSB010115@repo.freebsd.org> <20170503013818.F2099@besplex.bde.org> <CAPyFy2Ckp4fvyngx0brfcHBzRBsCbYWkomzZuvD8ajMy7kZhBA@mail.gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 2 May 2017, Ed Maste wrote:

> On 2 May 2017 at 12:35, Bruce Evans <brde@optusnet.com.au> wrote:
>>
>> -current man can't handle macros like "Sy" with -width or some other
>> things including the things used above.  This causes it to produce
>> excessive column spacing.  The formatting is bad enough without this
>> (verbose headers but all columns except "Architecture" have only 1-2
>> digits).  -current man just considers "Sy " as literal and increases
>> the column spacing by 3, giving a spacing of 7 columns instead of 4,
>> where we really want a negative number but 2 would work OK.
>
> We discussed this in review D7261. I created arch.7 with ".Sy based on
> an example from FreeBSD 10's mdoc(7). In D7261 I noted that there were
> existing man pages with both ".Sy and "Sy .

All examples in at least FreeBSD-5's mdoc(7) use ".Sy" if it is the first
macro in a ``subsection''.  "Sy" is used more often but not as the first
macro.  Typically after '.It'.

> Do you believe we should remove them altogether?

I think you mean "all of them in .Bl and similar macros".  I don't like
removing features that once worked.  Someone might be using them.  I
only noticed that I was using this one when it stopped working :-).

Bruce



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20170503044547.N3070>