File: mkman.sh

package info (click to toggle)
flashproxy 1.7-4
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid, stretch
  • size: 936 kB
  • ctags: 876
  • sloc: python: 3,708; sh: 823; makefile: 246; lisp: 15
file content (62 lines) | stat: -rwxr-xr-x 1,652 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
#!/bin/sh
# Wrapper around help2man that takes input from stdin.

set -o errexit

# Read a python program's description from the first paragraph of its docstring.
get_description() {
	PYTHONPATH=".:$PYTHONPATH" python - "./$1" <<EOF
import imp, sys
sys.dont_write_bytecode = True
mod = imp.load_source("mod", sys.argv[1])
doclines = mod.__doc__.splitlines()
# skip to start of first paragraph
while not doclines[0]:
    doclines.pop(0)
# find where the paragraph ends
try:
    r = doclines.index("")
except ValueError:
    r = len(doclines)
print " ".join(doclines[:r]).strip()
EOF
}

# Fixes some help2man quirks, see `man man`
help2man_fixup() {
	sed -e '
# restricted to usage parameters
/^\.SH SYNOPSIS$/,/^\.SH [A-Z][A-Z]*$/{/^[^.]/{
	# change hypenated parameters to bold, "type exactly as shown"
	s/\\fI\-/\\fB\-/g;
	# change ALL-CAPS parameters to italic, "replace with appropriate argument"
	s/\b\([A-Z][A-Z]*\)\b/\\fI\1\\fR/g;
};}'
}

if stat -c "%s" . >/dev/null 2>&1; then
	size() { stat -c "%s" "$@"; }
else
	size() { stat -f "%z" "$@"; }
fi

prog="$1"
ver="$2"
name="${3:-$(get_description "$1")}"
progname="$(basename "$prog")"

# Prepare a temporary executable file that just dumps its own contents.
trap 'rm -rf .tmp.$$' EXIT INT TERM
shebang="#!/usr/bin/tail -n+2"
mkdir -p ".tmp.$$"
{
echo "$shebang"
cat
} > ".tmp.$$/$progname"
test $(size ".tmp.$$/$progname") -gt $((${#shebang} + 1)) || { echo >&2 "no input received; abort"; exit 1; }
chmod +x ".tmp.$$/$progname"

help2man ".tmp.$$/$progname" --help-option="-q" \
  --name="$name" --version-string="$ver" \
  --no-info --include "$(dirname "$0")/mkman.inc" \
  | help2man_fixup