[PATCH 0/3] Add mansect(1) program and manual page

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 2600 bytes --]

Hi Branden, Colin,

I'm proposing the addition of this program to the Linux man-pages
repository, as a spin-off of the man_section() shell function that we
already have.  Eventually, we could move it to a separate repository, if
it is more appropriate.

Could you please review?  (And also give any opinions you have about
it.)  It originally supports man(7) only, but we probably can extend it
for mdoc(7) easily.

Here's the manual page, for ease of review:

	$ MANWIDTH=64 man man1/mansect.1 | cat
	mansect(1)          General Commands Manual         mansect(1)

	NAME
	     mansect  -  print  the  source code of sections of manual
	     pages

	SYNOPSIS
	     mansect section [file ...]

	DESCRIPTION
	     The mansect command prints the source code of the section
	     of the given manual‐page files.  If no files  are  speci‐
	     fied, the standard input is used.

	     section is a basic regular expression.

	     The TH line is unconditionally printed.

	     The  output of this program is suitable for piping to the
	     groff(1) pipeline.

	EXAMPLES
	     $ man ‐w strtol strtoul | xargs mansect ’\(NAME\|SEE ALSO\)’
	     .TH strtol 3 2024‐07‐23 "Linux man‐pages 6.9.1"
	     .SH NAME
	     strtol, strtoll, strtoq - convert a string to a long integer
	     .SH SEE ALSO
	     .BR atof (3),
	     .BR atoi (3),
	     .BR atol (3),
	     .BR strtod (3),
	     .BR strtoimax (3),
	     .BR strtoul (3)
	     .TH strtoul 3 2024‐07‐23 "Linux man‐pages 6.9.1"
	     .SH NAME
	     strtoul, strtoull, strtouq - convert a string to an unsigned long integer
	     .SH SEE ALSO
	     .BR a64l (3),
	     .BR atof (3),
	     .BR atoi (3),
	     .BR atol (3),
	     .BR strtod (3),
	     .BR strtol (3),
	     .BR strtoumax (3)

	SEE ALSO
	     lexgrog(1), groff(1), man(1)

	Linux man‐pages (unrelea... (date)                  mansect(1)


What do you think of it?

Have a lovely night!
Alex

Alejandro Colomar (2):
  src/bin/mansect, mansect.1: Add program and its manual page
  scripts/bash_aliases: man_section(), man_lsfunc(), man_lsvar(): Use
    mansect(1)

Vincent Lefevre (1):
  signal.7: Better description for SIGFPE

 man/man1/mansect.1   | 61 ++++++++++++++++++++++++++++++++++++++++++++
 man/man7/signal.7    |  2 +-
 scripts/bash_aliases | 38 +++++----------------------
 src/bin/mansect      | 33 ++++++++++++++++++++++++
 4 files changed, 101 insertions(+), 33 deletions(-)
 create mode 100644 man/man1/mansect.1
 create mode 100755 src/bin/mansect

-- 
2.39.5


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]