URL: <https://savannah.gnu.org/bugs/?66410>
Summary: mdoc: warning of .Lb usage without library
definition excessive
Group: GNU roff
Submitter: None
Submitted: Tue 05 Nov 2024 09:36:30 PM UTC
Category: Macro package mdoc
Severity: 3 - Normal
Item Group: Warning/Suspicious behaviour
Status: None
Privacy: Public
Assigned to: None
Open/Closed: Open
Discussion Lock: Any
Planned Release: None
_______________________________________________________
Follow-up Comments:
-------------------------------------------------------
Date: Tue 05 Nov 2024 09:36:30 PM UTC By: Anonymous
If the .Lb macro is used without a corresponding library definition present
then the following warning is emitted:
mdoc warning: .Lb: no description for library 'libxyz' available (#123)
This seems overly restrictive, denying man pages for standalone applications
from taking advantage of this useful semantic markup to make descriptive
reference to libraries which are relevant to the present document but are
unlikely to be, or cannot be guaranteed to have registered doc strings in the
target system. (It would not be for an application to define such strings for
a third party library.)
Could this warning perhaps be restricted to use of the .Lb macro in sections
where it would be expected to be expanded with system library details?
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?66410>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/
signature.asc
Description: PGP signature
