Re: [PATCH 34/51] man/infocmp.1m: Sort "BUGS" section after "AUTHORS".

[Thomas Dickey]

On Fri, Jul 26, 2024 at 12:52:31PM -0500, G. Branden Robinson wrote:
> The ncurses man pages don't use this section heading much (4 pages), but
> its contents are usually short, and anything irritating enough to
> warrant mention in it is more important for the reader to see than an
> authorship credit.  (In Seventh Edition Unix, this section came as the
> _very_ last, even after "SEE ALSO", but common practice today seems to
> position the latter as the ultimate heading, a reform I endorse.)

man 7 manpages:

   Sections within a manual page
       The  list  below shows conventional or suggested sections.  Most manual
       pages should include at least the highlighted sections.  Arrange a  new
       manual page so that sections are placed in the order shown in the list.
       ...
              CAVEATS
              BUGS
              EXAMPLES
              AUTHORS          [Discouraged]
              REPORTING BUGS   [Not used in man-pages]
              COPYRIGHT        [Not used in man-pages]
              SEE ALSO

Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: man-pages
Upstream-Contact: Michael Kerrisk <mtk.manpages@gmail.com>, 
linux-man@vger.kernel.org
Source: https://www.kernel.org/pub/linux/docs/man-pages/

> ---
>  man/infocmp.1m | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> diff --git a/man/infocmp.1m b/man/infocmp.1m
> index 661a0861d..3d37fe114 100644
> --- a/man/infocmp.1m
> +++ b/man/infocmp.1m
> @@ -646,14 +646,14 @@ .SH HISTORY
>  It is less capable than the SVr4 or \fI\%ncurses\fP versions
>  (e.g., it lacks the sorting options documented in X/Open),
>  but does include the \fB\-x\fP option adapted from \fI\%ncurses\fP.
> -.SH BUGS
> -The \fB\-F\fP option of \fB\%@INFOCMP@\fP(1M) should be a
> -\fB\%@TOE@\fP(1M) mode.
>  .SH AUTHORS
>  Eric S. Raymond <esr@snark.thyrsus.com>
>  and
>  .br
>  Thomas E. Dickey <dickey@invisible\-island.net>
> +.SH BUGS
> +The \fB\-F\fP option of \fB\%@INFOCMP@\fP(1M) should be a
> +\fB\%@TOE@\fP(1M) mode.
>  .SH SEE ALSO
>  \fB\%@CAPTOINFO@\fP(1M),
>  \fB\%@INFOTOCAP@\fP(1M),
> -- 
> 2.30.2
> 



-- 
Thomas E. Dickey <dickey@invisible-island.net>
https://invisible-island.net

signature.asc
Description: PGP signature