svn commit: r317681 - head/share/man/man7

[Bruce Evans]

On Tue, 2 May 2017, Ed Maste wrote:

> On 2 May 2017 at 12:35, Bruce Evans <brde at 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