man: Silence mandoc warnings for pkg.m4.7

man -Tlint pkg.m4

  new sentence, new line
    (mdoc) A new sentence starts in the middle of a text line. Start it
    on a new input line to help formatters produce correct spacing.

  skipping paragraph macro
    In mdoc(7) documents, this happens

      - at the beginning and end of sections and subsections
      - right before non-compact lists and displays
      - at the end of items in non-column, non-compact lists
      - and for multiple consecutive paragraph macros.

    In man(7) documents, it happens

      - for empty P, PP, and LP macros
      - for IP macros having neither head nor body arguments
      - for br or sp right after SH or SS

  no blank before trailing delimiter
    (mdoc) The last argument of a macro that supports trailing
    delimiter arguments is longer than one byte and ends with a
    trailing delimiter. Consider inserting a blank such that the
    delimiter becomes a separate argument, thus moving it out of
    the scope of the macro.

  man: pkg.m4.7:30:34: WARNING: new sentence, new line
  man: pkg.m4.7:38:20: WARNING: new sentence, new line
  man: pkg.m4.7:33:2: WARNING: skipping paragraph macro: Pp after Sh
  man: pkg.m4.7:41:2: WARNING: skipping paragraph macro: Pp at the end of Ss
  man: pkg.m4.7:46:2: WARNING: skipping paragraph macro: Pp at the end of Ss
  man: pkg.m4.7:134:27: STYLE: no blank before trailing delimiter: Nm ... check.
  man: pkg.m4.7:143:27: STYLE: no blank before trailing delimiter: Nm ... check.

https://man.openbsd.org/mandoc.1
feature/tap-sh
orbea 2018-04-09 21:43:47 -07:00 committed by William Pitcock
parent 8d060b84da
commit 4704b9325c
1 changed files with 7 additions and 9 deletions

View File

@ -27,23 +27,21 @@
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
is a collection of autoconf macros which help to configure compiler and linker is a collection of autoconf macros which help to configure compiler and linker
flags for development libraries. This allows build systems to detect other flags for development libraries.
dependencies and use them with the system toolchain. This allows build systems to detect other dependencies and use them with the
system toolchain.
.Sh "AUTOCONF MACROS" .Sh "AUTOCONF MACROS"
.Pp
.Ss "PKG_PREREQ(MIN-VERSION)" .Ss "PKG_PREREQ(MIN-VERSION)"
Checks that the version of the Checks that the version of the
.Nm .Nm
autoconf macros in use is at autoconf macros in use is at least MIN-VERSION.
least MIN-VERSION. This can be used to ensure a particular This can be used to ensure a particular
.Nm .Nm
macro will be available. macro will be available.
.Pp
.Ss "PKG_PROG_PKG_CONFIG([MIN-VERSION])" .Ss "PKG_PROG_PKG_CONFIG([MIN-VERSION])"
Checks for an implementation of Checks for an implementation of
.Nm pkg-config .Nm pkg-config
which is at least MIN-VERSION or newer. which is at least MIN-VERSION or newer.
.Pp
.Ss "PKG_CHECK_MODULES(VARIABLE-PREFIX, MODULES [,ACTION-IF-FOUND [,ACTION-IF-NOT-FOUND]])" .Ss "PKG_CHECK_MODULES(VARIABLE-PREFIX, MODULES [,ACTION-IF-FOUND [,ACTION-IF-NOT-FOUND]])"
.Ss "PKG_CHECK_MODULES_STATIC(VARIABLE-PREFIX, MODULES [,ACTION-IF-FOUND [,ACTION-IF-NOT-FOUND]])" .Ss "PKG_CHECK_MODULES_STATIC(VARIABLE-PREFIX, MODULES [,ACTION-IF-FOUND [,ACTION-IF-NOT-FOUND]])"
Checks whether a given module set exists, and if so, defines Checks whether a given module set exists, and if so, defines
@ -131,7 +129,7 @@ in a single macro.
Convenience macro to trigger Convenience macro to trigger
.Nm AM_CONDITIONAL .Nm AM_CONDITIONAL
after a after a
.Nm PKG_WITH_MODULES check. .Nm PKG_WITH_MODULES check.\&
.Nm VARIABLE-PREFIX .Nm VARIABLE-PREFIX
is exported as a make variable. is exported as a make variable.
.Ss "PKG_HAVE_DEFINE_WITH_MODULES(VARIABLE-PREFIX, MODULES, [DESCRIPTION], [DEFAULT])" .Ss "PKG_HAVE_DEFINE_WITH_MODULES(VARIABLE-PREFIX, MODULES, [DESCRIPTION], [DEFAULT])"
@ -140,6 +138,6 @@ Convenience macro to trigger
and and
.Nm AC_DEFINE .Nm AC_DEFINE
after a after a
.Nm PKG_WITH_MODULES check. .Nm PKG_WITH_MODULES check.\&
.Nm VARIABLE-PREFIX .Nm VARIABLE-PREFIX
is exported as a make variable. is exported as a make variable.