groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH v2 2/4] scripts/bash_aliases: man_lsfunc(), man_lsvar(): Use mans


From: Alejandro Colomar
Subject: [PATCH v2 2/4] scripts/bash_aliases: man_lsfunc(), man_lsvar(): Use mansect(1)
Date: Sun, 3 Nov 2024 02:17:01 +0100

Remove the man_section() function, and call the mansect(1) program
instead.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
---
 scripts/bash_aliases | 45 ++++++--------------------------------------
 1 file changed, 6 insertions(+), 39 deletions(-)

diff --git a/scripts/bash_aliases b/scripts/bash_aliases
index e461707c8..25425c389 100644
--- a/scripts/bash_aliases
+++ b/scripts/bash_aliases
@@ -38,39 +38,6 @@ sed_rm_ccomments()
 ########################################################################
 #      Linux man-pages
 
-#  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 'SEE ALSO';
-
-man_section()
-{
-       if [ $# -lt 2 ]; then
-               >&2 echo "Usage: ${FUNCNAME[0]} <dir> <section>...";
-               return $EX_USAGE;
-       fi
-
-       local page="$1";
-       shift;
-       local sect="$*";
-
-       find "$page" -type f \
-       |xargs wc -l \
-       |grep -v -e '\b1 ' -e '\btotal\b' \
-       |awk '{ print $2 }' \
-       |sort \
-       |while read -r manpage; do
-               (sed -n '/^\.TH/,/^\.SH/{/^\.SH/!p}' <"$manpage";
-                for s in $sect; do
-                       <"$manpage" \
-                       sed -n \
-                               -e "/^\.SH $s/p" \
-                               -e "/^\.SH $s/,/^\.SH/{/^\.SH/!p}";
-                done;) \
-               |mandoc -Tutf8 2>/dev/null \
-               |col -pbx;
-       done;
-}
-
 #  man_lsfunc()  prints the name of all C functions declared in the SYNOPSIS
 # of all manual pages in a directory (or in a single manual page file).
 # Each name is printed in a separate line
@@ -83,9 +50,9 @@ man_lsfunc()
                return $EX_USAGE;
        fi
 
-       for arg in "$@"; do
-               man_section "$arg" 'SYNOPSIS';
-       done \
+       mansect 'SYNOPSIS' "$@" \
+       |mandoc -Tutf8 2>/dev/null \
+       |col -pbx \
        |sed_rm_ccomments \
        |pcregrep -Mn '(?s)^ [\w ]+ \**\w+\([\w\s(,)[\]*]*?(...)?\s*\); *$' \
        |grep '^[0-9]' \
@@ -106,9 +73,9 @@ man_lsvar()
                return $EX_USAGE;
        fi
 
-       for arg in "$@"; do
-               man_section "$arg" 'SYNOPSIS';
-       done \
+       mansect 'SYNOPSIS' "$@" \
+       |mandoc -Tutf8 2>/dev/null \
+       |col -pbx \
        |sed_rm_ccomments \
        |pcregrep -Mv '(?s)^ [\w ]+ \**\w+\([\w\s(,)[\]*]+?(...)?\s*\); *$' \
        |pcregrep -Mn \
-- 
2.39.5

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]