libk: Artifact [b795aa8a1c]

Artifact b795aa8a1c9fb6f7c292b9b115db8d5ad4d7e73a95889cd6a1a0bf173afb9103:

Executable file global/build-manpage.sh — part of check-in [34c625a47b] at 2019-08-19 05:42:02 on branch trunk — switch over to new build mechanism and formally deprecate makefiles (user: lexi, size: 1192) [annotate] [blame] [check-ins using]

#!/usr/bin/env sh
(test -d global && test -f build.sh) || {
	echo >&2 "($0) run [1m$me[21m from root of [1mlibk[21m source directory"
	exit 1
}

. global/common.sh
reqpack cmark "generate documentation"


file="$1"
filename="$(basename "$file")"
stem=${filename%%.md}
mandest="$out/doc/man"
section=${section:-4}
out="$mandest/$stem.$section"
desc_rec="$(grep -m1 "^$stem:" global/modules)"
if test "$desc_rec" != ""; then
	desc=" - $(echo $desc_rec | cut -d: -f4)"
else
	desc=""
fi
date="$(date -r"$file" "+%d %A %Y")"

mkdir -p "$mandest"

echo  >"$out" ".TH ${stem^^} \"$section\" \"$date\" \"hale.su libk [r$build]\" \"modules\""

echo >>"$out" ".SH NAME"
echo >>"$out" "$stem$desc"
echo >>"$out" ".SH SYNOPSIS" 

dhead=$(grep -m1 -n "^# description$" "$file")
if test $? -eq 0; then
	descline=$(echo "$dhead" | cut -d: -f1)
	offset=1
else
	descline=$(grep -m2 -n "^#" "$file" | tail -n1 | cut -d: -f1)
	offset=0
fi

tail -n+2 $file | head -n$(expr $descline - 2) | cmark -t man >>"$out"

echo >>"$out" ".SH DESCRIPTION"

tail -n+$(expr $descline + $offset) "$file"  | cmark -t man >> "$out"

if has gzip; then
	gzip -f "$out"
	out="$out.gz"
fi

say "wrote manpage for $stem to $out"

libk Artifact [b795aa8a1c]

Artifact b795aa8a1c9fb6f7c292b9b115db8d5ad4d7e73a95889cd6a1a0bf173afb9103: