svn commit: r362191 - head/sbin/md5
Yuri Pankov
yuripv at yuripv.dev
Mon Jun 15 13:57:04 UTC 2020
Mateusz Piotrowski wrote:
> Hi,
>
> On 6/15/20 2:33 PM, Rodney W. Grimes wrote:
>> [ Charset UTF-8 unsupported, converting... ]
>>> Author: fernape (ports committer)
>>> Date: Mon Jun 15 10:08:02 2020
>>> New Revision: 362191
>>> URL: https://svnweb.freebsd.org/changeset/base/362191
>>>
>>> Log:
>>> md5(1): fix style in man page
>>
>> Mandoc is fine to ignore this, but it is wrong to call it useless.
>>
>> I really wish that this stop. .Tn might be useless to mandoc,
>> but it is a very usable thing if your formatting to something
>> other than txt, as in a ps or pdf.
>
> In that case I would consider patching our in-tree mandoc to not warn
> about Tn. Or request support for Tn or a well-defined replacement upstream.
>
> I can see the benefit of keeping Tn around, as it /might/ potentially
> create nice formatting for HTML. On the other hand, I don't like the
> idea of not following the linter.
It's marked as obsolete exactly because it's misused, quoting mdoc(7):
Even though the macro name (“tradename”) suggests a semantic
function, historic usage is inconsistent, mostly using it as a
presentation-level macro to request a small caps font.
If we want to somehow emphasize the text, .Sy, .Em, or similar macros
should be used instead, I don't see why though, it certainly doesn't
help the readability (IMO, of coursE).
More information about the svn-src-head
mailing list