[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
signature.asc
Description: PGP signature
- [PATCH 0/3] Add mansect(1) program and manual page, Alejandro Colomar, 2024/11/02
- [PATCH] CONTRIBUTING.d/patches: Document new features alongside the features, Alejandro Colomar, 2024/11/02
- [PATCH 1/3] signal.7: Better description for SIGFPE, Alejandro Colomar, 2024/11/02
- [PATCH 2/3] src/bin/mansect, mansect.1: Add program and its manual page, Alejandro Colomar, 2024/11/02
- [PATCH 3/3] scripts/bash_aliases: man_section(), man_lsfunc(), man_lsvar(): Use mansect(1), Alejandro Colomar, 2024/11/02
- [PATCH v2 0/4] Add mansect(1), Alejandro Colomar, 2024/11/02
- [PATCH v2 1/4] src/bin/mansect, mansect.1: Add program and its manual page, Alejandro Colomar, 2024/11/02
- [PATCH v2 2/4] scripts/bash_aliases: man_lsfunc(), man_lsvar(): Use mansect(1),
Alejandro Colomar <=
- [PATCH v2 3/4] scripts/bash_aliases: man_lsfunc(), man_lsvar(): Use pcre2grep(1) instead of pcregrep(1), Alejandro Colomar, 2024/11/02
- [PATCH v2 4/4] src/bin/mansect: Preprocess with preconv(1), Alejandro Colomar, 2024/11/02