gno/doc/refs/mkhtmlman

#! /bin/sh
#
# Devin Reade, November 1997.
#
# $Id: mkhtmlman,v 1.9 1999/02/21 23:37:13 gdr-ftp Exp $

man2html=/usr/local/bin/man2html
TMPDIR=${TMPDIR:-/tmp}

#
# Make sure we know where everything is going.
#
if [ -z "$GNOROOT" ]; then
	echo "GNOROOT variable not set"
	exit 1
fi
if [ -z "$MANHTML" ]; then
	echo "MANHTML variable not set"
	exit 1
fi
if [ -z "$NAME" ]; then
	echo "NAME variable not set"
	exit 1
fi
if [ -z "$ADDR" ]; then
	echo "ADDR variable not set"
	exit 1
fi
if [ ! -x ./newer ]; then
	echo "./newer does not exist"
	exit 1
fi
set +e

listfile=$TMPDIR/mkhtmlman.1.$$

trap "rm -f $listfile" 0 1 2 15 

MANDIRS="$GNOROOT/usr.man $GNOROOT/*bin* $GNOROOT/*lib*"

for section in 1 2 3 4 5 6 7 8; do
    dest=$MANHTML/man$section
    [ -d $dest ] || mkdir -p $dest

    for F in 00.DUMMY `find $MANDIRS -type f -name '*.'$section -print \
	| grep -v .AppleDouble \
	| grep -v .finderinfo \
	| grep -v .resource \
	| grep -v libcurses/PSD.doc \
	| grep -v bin/gsh/updates1.1 \
	| grep -v sed/tests` ; do
	[ "$F" = 00.DUMMY ] && continue;
	if egrep -q -e '^'"$F"'$' ignored.pages; then
	    echo "$F: ignored"
	    continue
	fi
	F_noG="$F"
	if [ -f $F'G' ]; then
	    F="$F"G
	fi
	macro=''
	if ! egrep -q -e '^\.TH.*GNO' $F; then
	    if egrep -q -e '^\.Sh NAME' $F; then
		echo "$F: Using the BSD-formatted man page."
		macro=doc
	    else
		echo "$F: This does not appear to be a GNO manual page." \
		    "Skipped."
		continue
	    fi
	fi
	f=`basename $F_noG`
	f2=`echo $f | perl -pe 's/\.[^\.]+$//;'`
	echo "$f" >> $listfile
	if ! ./newer $dest/$f.html $F; then
	    echo "creating $dest/$f.html"
	    nroff -man$macro $F | $man2html -nodepage | \
	    perl -p -e \
    's/<BODY>/<title>GNO: '"$f2($section)"'<\/title><body bgcolor=\#ffffff textcolor=\#000000 linkcolor=\#0000FF vlinkcolor=\#001177 alinkcolor=\#001177>/;'\
		> $dest/$f.html
	fi
    done
    echo "creating $dest/00.index.html"
    sort $listfile | \
	./mkmandex -s$section -name="$NAME" -addr="$ADDR" -mkso="$MKSO" \
		-hroot="$HTMLROOT" > $dest/00.index.html
    rm $listfile
done
Initial checkin of documentation (latex/html source). Only the kern reference is really ready for viewing, and that is still missing the index. 1997-11-24 05:07:28 +00:00			`#! /bin/sh`
			`#`
			`# Devin Reade, November 1997.`
			`#`
mksgml posthtml: - initial checkin Makefile: - changes to allow for the new gsh ref manual - moved .Z .gz files into an "uploads" subdir README: - added some comments re the sgml stuff head.html, index.html, mkmandex, mkhtmlman, manindex.html, mkstatus, oldrefs.html, refs.html, tail.html: - eliminated <base> tags - fully specify page colours refs.html: - added links for new gsh manual index.html: - add dates for "NEW" section - added comment about new gsh manual intro.tex: - fully specify page colours - fixed a typo: "2.0.4" --> "2.0.6" in installation notes kern.tex: - fully specify page colours 1999-02-21 23:37:13 +00:00			`# $Id: mkhtmlman,v 1.9 1999/02/21 23:37:13 gdr-ftp Exp $`
Initial checkin of documentation (latex/html source). Only the kern reference is really ready for viewing, and that is still missing the index. 1997-11-24 05:07:28 +00:00
			`man2html=/usr/local/bin/man2html`
			`TMPDIR=${TMPDIR:-/tmp}`

			`#`
			`# Make sure we know where everything is going.`
			`#`
			`if [ -z "$GNOROOT" ]; then`
			`echo "GNOROOT variable not set"`
			`exit 1`
			`fi`
			`if [ -z "$MANHTML" ]; then`
			`echo "MANHTML variable not set"`
			`exit 1`
			`fi`
			`if [ -z "$NAME" ]; then`
			`echo "NAME variable not set"`
			`exit 1`
			`fi`
			`if [ -z "$ADDR" ]; then`
			`echo "ADDR variable not set"`
			`exit 1`
			`fi`
- added the html man pages to the default target - fixed the making of the html man pages so that they only happen when they're actually required. 1997-11-24 05:46:29 +00:00			`if [ ! -x ./newer ]; then`
			`echo "./newer does not exist"`
			`exit 1`
			`fi`
Initial checkin of documentation (latex/html source). Only the kern reference is really ready for viewing, and that is still missing the index. 1997-11-24 05:07:28 +00:00			`set +e`

			`listfile=$TMPDIR/mkhtmlman.1.$$`

			`trap "rm -f $listfile" 0 1 2 15`

			`MANDIRS="$GNOROOT/usr.man $GNOROOT/bin $GNOROOT/lib"`

			`for section in 1 2 3 4 5 6 7 8; do`
			`dest=$MANHTML/man$section`
			`[ -d $dest ] \|\| mkdir -p $dest`

			for F in 00.DUMMY `find $MANDIRS -type f -name '*.'$section -print \
Makefile, intro.tex, mknotes: The file ../../verbatim/boot/README.install is now partially generated from intro.tex via the mknotes script. intro.tex: - expanded and corrected v2.0.6 installation notes - translated " --> '' (TeX style) mkhtmlman: Don't try to create man pages from resource forks (which would have been created by either CAP or Netatalk). 1999-01-18 01:46:07 +00:00			`\| grep -v .AppleDouble \`
			`\| grep -v .finderinfo \`
			`\| grep -v .resource \`
don't snag the sed tests, which happen to have names that look like man pages 1997-11-24 06:46:18 +00:00			`\| grep -v libcurses/PSD.doc \`
Makefile, README, index.html, intro.tex, unaval.html: - changed occurances from trenco.myrias.com to either ftp.gno.org or www.gno.org, as appropriate index.html: - make reference to post-v2.0.4 patches avail from ftp.gno.org - deleted reference to Soenke's describe database (obsolete), replaced it with ref to the hosted by www.gno.org mkhtmlman: - fixed bug where a non-man-page file was picked up by this script out of the gsh source directory. - man pages may appear now as both name.n and name.nG, where the "n" is the section number. If both files appear, then the former is BSD-formatted source and the latter is GNO-formatted source. Make sure we're only picking up the latter. 1998-01-26 07:13:14 +00:00			`\| grep -v bin/gsh/updates1.1 \`
don't snag the sed tests, which happen to have names that look like man pages 1997-11-24 06:46:18 +00:00			\| grep -v sed/tests` ; do
Initial checkin of documentation (latex/html source). Only the kern reference is really ready for viewing, and that is still missing the index. 1997-11-24 05:07:28 +00:00			`[ "$F" = 00.DUMMY ] && continue;`
- split the top level GNO docs web page into subpages - add a file containing a list of man pages to ignore when building the html versions of the pages 1998-02-19 03:04:10 +00:00			`if egrep -q -e '^'"$F"'$' ignored.pages; then`
			`echo "$F: ignored"`
- when making html versions of the man pages, skip files that appear not to be GNO man pages, despite the file name. Be verbose about it. 1998-02-04 07:17:13 +00:00			`continue`
			`fi`
- split the top level GNO docs web page into subpages - add a file containing a list of man pages to ignore when building the html versions of the pages 1998-02-19 03:04:10 +00:00			`F_noG="$F"`
Makefile, README, index.html, intro.tex, unaval.html: - changed occurances from trenco.myrias.com to either ftp.gno.org or www.gno.org, as appropriate index.html: - make reference to post-v2.0.4 patches avail from ftp.gno.org - deleted reference to Soenke's describe database (obsolete), replaced it with ref to the hosted by www.gno.org mkhtmlman: - fixed bug where a non-man-page file was picked up by this script out of the gsh source directory. - man pages may appear now as both name.n and name.nG, where the "n" is the section number. If both files appear, then the former is BSD-formatted source and the latter is GNO-formatted source. Make sure we're only picking up the latter. 1998-01-26 07:13:14 +00:00			`if [ -f $F'G' ]; then`
			`F="$F"G`
			`fi`
- split the top level GNO docs web page into subpages - add a file containing a list of man pages to ignore when building the html versions of the pages 1998-02-19 03:04:10 +00:00			`macro=''`
			`if ! egrep -q -e '^\.TH.*GNO' $F; then`
			`if egrep -q -e '^\.Sh NAME' $F; then`
			`echo "$F: Using the BSD-formatted man page."`
			`macro=doc`
			`else`
			`echo "$F: This does not appear to be a GNO manual page." \`
			`"Skipped."`
			`continue`
			`fi`
			`fi`
			f=`basename $F_noG`
			f2=`echo $f \| perl -pe 's/\.[^\.]+$//;'`
			`echo "$f" >> $listfile`
- added the html man pages to the default target - fixed the making of the html man pages so that they only happen when they're actually required. 1997-11-24 05:46:29 +00:00			`if ! ./newer $dest/$f.html $F; then`
			`echo "creating $dest/$f.html"`
- split the top level GNO docs web page into subpages - add a file containing a list of man pages to ignore when building the html versions of the pages 1998-02-19 03:04:10 +00:00			`nroff -man$macro $F \| $man2html -nodepage \| \`
- added the html man pages to the default target - fixed the making of the html man pages so that they only happen when they're actually required. 1997-11-24 05:46:29 +00:00			`perl -p -e \`
mksgml posthtml: - initial checkin Makefile: - changes to allow for the new gsh ref manual - moved .Z .gz files into an "uploads" subdir README: - added some comments re the sgml stuff head.html, index.html, mkmandex, mkhtmlman, manindex.html, mkstatus, oldrefs.html, refs.html, tail.html: - eliminated <base> tags - fully specify page colours refs.html: - added links for new gsh manual index.html: - add dates for "NEW" section - added comment about new gsh manual intro.tex: - fully specify page colours - fixed a typo: "2.0.4" --> "2.0.6" in installation notes kern.tex: - fully specify page colours 1999-02-21 23:37:13 +00:00			`'s/<BODY>/<title>GNO: '"$f2($section)"'<\/title><body bgcolor=\#ffffff textcolor=\#000000 linkcolor=\#0000FF vlinkcolor=\#001177 alinkcolor=\#001177>/;'\`
Initial checkin of documentation (latex/html source). Only the kern reference is really ready for viewing, and that is still missing the index. 1997-11-24 05:07:28 +00:00			`> $dest/$f.html`
- added the html man pages to the default target - fixed the making of the html man pages so that they only happen when they're actually required. 1997-11-24 05:46:29 +00:00			`fi`
Initial checkin of documentation (latex/html source). Only the kern reference is really ready for viewing, and that is still missing the index. 1997-11-24 05:07:28 +00:00			`done`
- added the html man pages to the default target - fixed the making of the html man pages so that they only happen when they're actually required. 1997-11-24 05:46:29 +00:00			`echo "creating $dest/00.index.html"`
Initial checkin of documentation (latex/html source). Only the kern reference is really ready for viewing, and that is still missing the index. 1997-11-24 05:07:28 +00:00			`sort $listfile \| \`
			`./mkmandex -s$section -name="$NAME" -addr="$ADDR" -mkso="$MKSO" \`
			`-hroot="$HTMLROOT" > $dest/00.index.html`
			`rm $listfile`
			`done`