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
signature.asc
Description: PGP signature
