########################################################################
# 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
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]' \
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 \