LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

scripts/bash_aliases: man_section(): Accept multiple sections 

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Alejandro Colomar 2021-05-09 23:39:20 +02:00 committed by Michael Kerrisk
parent 3a42b0815e
commit a3ccd456f3
1 changed files with 19 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
scripts/bash_aliases
View File

@ -85,26 +85,35 @@ function grep_syscall_def()
########################################################################
# Linux man-pages
# man_section() prints a specific manual page section (DESCRIPTION, SYNOPSIS,
# man_section() prints specific manual page sections (DESCRIPTION, SYNOPSIS,
# ...) of all manual pages in a directory (or in a single manual page file).
# Usage example: .../man-pages$ man_section man2 SYNOPSIS;
# Usage example: .../man-pages$ man_section man2 SYNOPSIS 'CONFORMING TO';
function man_section()
{
if ! [ -v 2 ]; then
>&2 echo "Usage: ${FUNCNAME[0]} <dir> <section>";
>&2 echo "Usage: ${FUNCNAME[0]} <dir> <section>...";
return ${EX_USAGE};
fi
find "${1}" -type f \
|xargs grep -l "\.SH ${2}" \
local page="$1";
shift;
local sect="$@";
find "${page}" -type f \
|xargs wc -l \
|grep -v -e '\b1 ' -e '\btotal\b' \
|awk '{ print $2 }' \
|sort -V \
|while read -r manpage; do
<${manpage} \
sed -n \
-e '/^\.TH/,/^\.SH/{/^\.SH/!p}' \
-e "/^\.SH ${2}/p" \
-e "/^\.SH ${2}/,/^\.SH/{/^\.SH/!p}" \
cat \
<(<${manpage} sed -n '/^\.TH/,/^\.SH/{/^\.SH/!p}') \
<(for s in ${sect}; do
<${manpage} \
sed -n \
-e "/^\.SH ${s}/p" \
-e "/^\.SH ${s}/,/^\.SH/{/^\.SH/!p}"; \
done;) \
|man -P cat -l - 2>/dev/null;
done;
}