fixing links and build

doc/refs/.cvsignore

@@ -0,0 +1,22 @@
+intro.a4.ps
+intro.aux
+intro.bbl
+intro.blg
+intro.dvi
+intro.idx
+intro.ilg
+intro.ind
+intro.log
+intro.ltr.ps
+intro.out
+kern.a4.ps
+kern.aux
+kern.dvi
+kern.idx
+kern.ilg
+kern.ind
+kern.log
+kern.ltr.ps
+kern.toc
+kern.out
+work

doc/refs/GNUmakefile

@@ -0,0 +1,274 @@
+#
+# $Id: GNUmakefile,v 1.1 2012/08/25 07:21:59 gdr Exp $
+#
+
+SRCROOT = ..
+
+include $(SRCROOT)/etc/constpriv.mk
+include $(SRCROOT)/etc/const.mk
+
+INSTALL_REAL	= $(GNO_PUBLIC_HTML)/refs
+INSTALL_FAKE	= $(INSTALL_REAL)-test
+
+HTML_ROOT	= http://www.gno.org/gno/
+FTP_ROOT	= ftp://ftp.gno.org/pub/apple2/gs.specific/gno
+GIFDIR		= $(HTML_ROOT)icons
+FAQ		= $(HTML_ROOT)FAQ.html
+FAQLOG		= $(HTML_ROOT)FAQ-log.html
+FAQ_TEXT	= $(FTP_ROOT)/doc/faq/CURRENT
+FAQLOG_TEXT	= $(FTP_ROOT)/doc/faq/LOG
+FTP_INTRO	= $(FTP_ROOT)/doc/refs/intro
+FTP_KERN	= $(FTP_ROOT)/doc/refs/kern
+FTP_GSH		= $(FTP_ROOT)/doc/refs/gsh
+OLD_HTML	= $(HTML_ROOT)docs.Aug96
+
+# Pathnames for various programs.
+DVIPS		= dvips
+LATEX		= latex
+TEX2HTML	= latex2html
+MAKEINDEX	= makeindex
+GETDATE		= ./getdate -date
+GETVERS		= ./getdate -version
+
+# Where do we build our pages?  HTMLD is for latex-generated html.
+BUILDDIR	= ./work
+
+DVI		= intro.dvi    kern.dvi
+PS_LTR		= intro.ltr.ps kern.ltr.ps # gsh-ltr-ps
+PS_A4		= intro.a4.ps  kern.a4.ps
+
+REF_PAGES	= $(BUILDDIR)/intro.html \
+		  $(BUILDDIR)/kern.html
+#		  gsh-h
+
+# These are no longer published from this repo
+MAIN_PAGES	= $(BUILDDIR)/index.html \
+		  $(BUILDDIR)/faqindex.html \
+		  $(BUILDDIR)/refs.html \
+		  $(BUILDDIR)/manindex.html \
+		  $(BUILDDIR)/related.html \
+		  $(BUILDDIR)/oldrefs.html \
+		  $(BUILDDIR)/bugs.html \
+		  $(BUILDDIR)/unaval.html
+
+ICONS		=
+ICONS2		= $(BUILDDIR)/icons/back.gif \
+		  $(BUILDDIR)/icons/a2viewable.gif
+
+STATUS_PAGES	= $(BUILDDIR)/status-bin.html \
+		  $(BUILDDIR)/status-bin.txt \
+		  $(BUILDDIR)/status-lib.txt
+
+# Format of the comment block for each html page.
+CONTACT1	= '$(NAME)\
+	<A HREF="mailto:$(ADDRESS)" TITLE="GNO Documentation Feedback">\
+	&lt;$(ADDRESS)&gt;</A><br>Last Updated: '
+CONTACT2	= '<br>Document Version: '
+
+# Other variables for building things
+DVIPS_FLAGS	=
+LATEX_FLAGS	=
+TEX2HTML_FLAGS	= -info "" -local_icons -dir $(BUILDDIR) -up_url refs.html \
+		  -up_title "GNO Reference Manuals"
+TEXINPUTS	= ':/usr/local/lib/latex2html'
+
+# Scratch files to clean up
+MANUAL_GARBAGE	= 
+TEX_GARBAGE	= *.err *.aux *.log *.dvi *.toc *.idx *.ilg *.ind
+DVIPS_GARBAGE	= *.ps *.djc
+BIB_GARBAGE	= *.blg *.bbl
+
+#build:	prep icons dvi ps html
+build:	prep dvi ps html
+
+install: clobber_install work_install ps_install
+
+clobber_install:
+	-/bin/rm -rf $(INSTALL_REAL)/*
+
+fake-install:
+	$(MAKE) install INSTALL_REAL=$(INSTALL_FAKE)
+
+icons:	$(ICONS)
+
+# html:	$(MAIN_PAGES) $(REF_PAGES) $(STATUS_PAGES)
+html:	$(REF_PAGES) $(STATUS_PAGES)
+dvi:	$(DVI)
+ps:	ps_ltr ps_a4
+ps_ltr:	$(PS_LTR)
+ps_a4:	$(PS_A4)
+
+#
+# Install targets
+#
+ps_install:
+	@echo "**** not yet doing ps_install"
+
+work_install:
+	@if [ ! -d $(INSTALL_REAL) ]; then \
+		echo "$(INSTALL_REAL): no such directory"; \
+		exit 1; \
+	fi
+	@workdirs=`(cd work; find . -type d -print)`; \
+	for d in $$workdirs; do \
+		if [ ! -d $(INSTALL_REAL)/$$d ]; then \
+			echo "install -d -m755 $(INSTALL_REAL)/$$d"; \
+			install -d -m755 $(INSTALL_REAL)/$$d; \
+		fi; \
+	done
+	@workfiles=`(cd work; find . -type f \( -name '*.html' -o -name '*.txt' -o -name '*.png' -o -name '*.css' -o -name '*.jpg' -o -name '*.gif' \) -print)`; \
+	for f in $$workfiles; do \
+		if [ ! -d $(INSTALL_REAL)/$$f ]; then \
+			echo "install -m644 ./work/$$f $(INSTALL_REAL)/$$f"; \
+			install -m644 ./work/$$f $(INSTALL_REAL)/$$f; \
+		fi; \
+	done
+
+#
+# Preparation targets
+#
+prep:	$(BUILDDIR) $(BUILDDIR)/webconfig.pl $(BUILDDIR)/newer
+#       $(BUILDDIR)/icons
+
+$(BUILDDIR):
+	@[ -d $(BUILDDIR) ] || mkdir $(BUILDDIR)
+
+$(BUILDDIR)/icons:
+	@[ -d $(BUILDDIR)/icons ] || mkdir $(BUILDDIR)/icons
+
+$(BUILDDIR)/newer: newer.c
+	$(CC) -o $@ $(CFLAGS) $(LDFLAGS) $< $(LDLIBS)
+
+$(BUILDDIR)/webconfig.pl:
+	@echo "creating $@"
+	@rm -f $@
+	@echo '$$htmlroot = "$(HTML_ROOT)";' >> $@
+	@echo '$$ftproot = "$(FTP_ROOT)";' >> $@
+	@echo '$$ftp_intro = "$(FTP_INTRO)";' >> $@
+	@echo '$$ftp_kern = "$(FTP_KERN)";' >> $@
+	@echo '$$ftp_gsh = "$(FTP_GSH)";' >> $@
+	@echo '$$faq = "$(FAQ)";' >> $@
+	@echo '$$faqlog =  "$(FAQLOG)";' >> $@
+	@echo '$$faq_text = "$(FAQ_TEXT)";' >> $@
+	@echo '$$faqlog_text = "$(FAQLOG_TEXT)";' >> $@
+	@echo '$$old_html = "$(OLD_HTML)";' >> $@
+	@echo '$$gifdir = "$(GIFDIR)";' >> $@
+	@echo '$$contact'" = '$(ADDRESS)';" >> $@
+
+#
+# Main page build targets
+#
+$(BUILDDIR)/index.html: index.html tail.html
+	./replace index.html tail.html > $@
+
+$(BUILDDIR)/faqindex.html: faqindex.html head.html tail.html
+	./replace -title='GNO Frequently Asked Questions (Index)' \
+		head.html $< tail.html > $@
+
+$(BUILDDIR)/refs.html: refs.html head.html tail.html
+	./replace -title='GNO Reference Manuals' \
+		head.html $< tail.html > $@
+
+$(BUILDDIR)/manindex.html: manindex.html head.html tail.html
+	./replace -title='GNO Manual Pages Index' \
+		head.html $< tail.html > $@
+
+$(BUILDDIR)/related.html: related.html head.html tail.html
+	./replace -title='GNO-Related Web Pages' \
+		head.html $< tail.html > $@
+
+$(BUILDDIR)/bugs.html: bugs.html head.html tail.html
+	./replace -title='GNO Bug Reports' \
+		head.html $< tail.html > $@
+
+$(BUILDDIR)/oldrefs.html: oldrefs.html head.html tail.html
+	./replace -title='Old (v2.0.4) GNO Documentation' \
+		head.html $< tail.html > $@
+
+$(BUILDDIR)/unaval.html: unaval.html head.html tail.html
+	./replace -title='Unpublished Document' \
+		head.html $< tail.html > $@
+
+# This target creates the html versions of all the current man pages,
+# plus the chapter index pages.  Unfortunately, this target rebuilds
+# _all_ of it's files, not just those that are out of date.
+man:	$(BUILDDIR)/newer
+	@GNOROOT=../.. MANHTML=$(MANHTML) NAME="$(NAME)" \
+	ADDR="$(ADDRESS)" MKSO="$(MKSO)" HTMLROOT="$(HTML_ROOT)" \
+	./mkhtmlman
+
+# looks like newer versions of latex don't need this hack anymore
+cleanhtml:
+	@echo "cleaning guano from html files"; \
+	perl -pi \
+		-e 's/NOWRAP//g;' \
+		-e '(/<!--\s*cleantable-start\s*-->/) && ($$cts=1);' \
+		-e '(/<!--\s*cleantable-end\s*-->/) && ($$cts=0);' \
+		-e '($$cts == 1) && (s/(<BR>|<HR>)//g);' \
+		$(BUILDDIR)/*.html
+
+clean:
+	-rm -rf *~ $(TEX_GARBAGE) $(BIB_GARBAGE) $(DVIPS_GARBAGE) $(UPLOADDIR)
+#	cd gsh; $(MAKE) $@
+
+clobber: clean
+	-rm -rf $(MANUAL_GARBAGE) $(BUILDDIR)
+#	-rm -rf $(MANUAL_GARBAGE) $(HTMLD) $(PSD) $(DVID) newer
+#	cd gsh; $(MAKE) $@
+
+#
+# Status page build targets
+#
+$(BUILDDIR)/status-bin.html: ../../NOTES/status.bin
+	./mkstatus $< $@
+	chmod 644 $@
+
+$(BUILDDIR)/status-bin.txt: ../../NOTES/status.bin
+	install -m644 $< $@
+
+# The lib version doesn't quite have the right format
+#$(BUILDDIR)/status-lib.html: ../../NOTES/status.lib
+#	./mkstatus $< $@
+#	chmod 644 $@
+
+$(BUILDDIR)/status-lib.txt: ../../NOTES/status.lib
+	install -m644 $< $@
+
+#
+# Icon rules
+#
+$(BUILDDIR)/icons/back.gif: icons/back.gif
+	install -m644 $< $@
+
+$(BUILDDIR)/icons/a2viewable.gif: icons/a2viewable.gif
+	install -m644 $< $@
+
+#
+# Implicit rules
+#
+$(BUILDDIR)/%.html: %.tex
+	@$(TEX2HTML) \
+	-prefix "$*". -no_auto_link \
+	-address $(CONTACT1)"`$(GETDATE) <$<`"$(CONTACT2)"`$(GETVERS) <$<`" \
+	-up_title \
+	"`perl -n -e '(m,<title>(.*)</title>,) && printf("%s\n",$$1);'\
+	< $(BUILDDIR)/refs.html `" \
+	$(TEX2HTML_FLAGS) $<
+
+%.ltr.ps: %.dvi
+	$(DVIPS) -tletter $(DVIPS_FLAGS) -o $@ $<
+
+%.a4.ps: %.dvi
+	$(DVIPS) -ta4 $(DVIPS_FLAGS) -o $@ $<
+
+%.dvi: %.tex
+	@for i in 1 2 3; do \
+		echo "****** latex pass $$i"; \
+		TEXINPUTS=$(TEXINPUTS) $(LATEX) $(LATEX_FLAGS) $<; \
+		if [ "$*" = intro ]; then \
+			echo "****** running bibtex"; \
+			bibtex $*; \
+		fi; \
+		$(MAKEINDEX) $*; \
+	done; \
+	echo "****** latex passes done"

doc/refs/Makefile

@@ -7,7 +7,7 @@
 #
 # Devin Reade, 1997.
 #
-# $Id: Makefile,v 1.14 1999/02/21 23:37:11 gdr-ftp Exp $
+# $Id: Makefile,v 1.15 2012/08/25 07:22:00 gdr Exp $
 #
 
 # Set this to 'true' (without the quotes) for local links (used
@@ -18,7 +18,7 @@ DRAFT	=
 # at the bottom of each of the HTML pages.  Do NOT use '<' or '>' in the
 # address.
 NAME		= Devin Reade
-ADDRESS		= gdr@trenco.gno.org
+ADDRESS		= gdr@gno.org
 
 # Pathnames for various programs.
 DVIPS		= dvips
@@ -34,12 +34,12 @@ PSD		= psd
 
 .IF $(DRAFT) == true
 	# This is the root of the html tree used in the generated sources.
-	HTML_ROOT	= file:/home/gdr/src/gno/doc/refs/$(HTMLD)
+	HTML_ROOT	= file:/home/gdr/src/gno/doc/refs/$(HTMLD)/
 
 	# This is the directory where the remaining gifs may be found
 	GIFDIR		= file:/home/gdr/graphics
 .ELSE
-	HTML_ROOT	= http://www.gno.org/~gno
+	HTML_ROOT	= http://www.gno.org/gno/
 	GIFDIR		= http://www.gno.org/icons
 .END
 FTP_ROOT	= ftp://ftp.gno.org/pub/apple2/gs.specific/gno
@@ -77,7 +77,6 @@ DVIPS_FLAGS	=
 LATEX_FLAGS	=
 TEX2HTML_FLAGS	= -info "" -local_icons -dir $(HTMLD) -up_url refs.html \
 		  -up_title "GNO Reference Manuals"
-TEXINPUTS	= ':/usr/local/lib/latex2html'
 
 DVI	= intro.dvi    kern.dvi
 PS_LTR	= intro.ltr.ps kern.ltr.ps gsh-ltr-ps
@@ -279,7 +278,7 @@ $(HTMLD)/%.html: %.tex
 %.dvi: %.tex
 	@for i in 1 2 3; do \
 		echo "****** latex pass $$i"; \
-		TEXINPUTS=$(TEXINPUTS) $(LATEX) $(LATEX_FLAGS) $<; \
+		$(LATEX) $(LATEX_FLAGS) $<; \
 		if [ "$*" = intro ]; then \
 			echo "****** running bibtex"; \
 			bibtex $*; \

doc/refs/index.html

@@ -4,7 +4,7 @@
 </head>
 <body bgcolor=#ffffff>
 
-<!-- $Id: index.html,v 1.11 2001/06/18 13:42:55 gdr Exp $ -->
+<!-- $Id: index.html,v 1.12 2012/08/25 07:22:00 gdr Exp $ -->
 
 <A HREF="/"><IMG src="icons/back.gif"
  alt="Back to the GNO Consortium Page"
@@ -27,9 +27,11 @@ It consists of the following sections:
 <li><A HREF="/gno/describe">The Describe Database</A>
 <li>Status Lists for Work Under Development:
 	<ul>
-	<li><A HREF="status.bin.html">Programs.</A>
+	<li>Programs (<A HREF="status-bin.html">HTML</A>,
-	<li><A HREF="status.lib.html">Library routines,
+	    <A HREF="status-bin.txt">text</A>)
-		header files, and related manual pages.</A>
+	<li>Library routines, header files, and related manual pages
+	    (<A HREF="status-lib.html">HTML</A>,
+	    <A HREF="status-lib.txt">text</A>)
 	</ul>
 <li><A HREF="related.html">GNO-Related Web Links</A>
 <li><A HREF="oldrefs.html">Old Documentation (August 1996 Revision for GNO v2.0.4)</A>

doc/refs/intro.tex

@@ -1,7 +1,7 @@
 %
 % GNO Overview
 %
-% $Id: intro.tex,v 1.15 1999/02/21 23:37:12 gdr-ftp Exp $
+% $Id: intro.tex,v 1.16 2012/08/25 07:22:00 gdr Exp $
 % 
 
 \documentclass{report}
@@ -20,7 +20,8 @@
 \begin{document}
 
 \title{GNO Overview and Installation}
-\author{Jawaid Bazyar \\ Tim Meekins \\ Devin Reade}
+\author{Jawaid Bazyar, Tim Meekins, Devin Reade}
+\date{November 1997}
 \maketitle
 
 \bibliographystyle{plain}
@@ -522,9 +523,9 @@ may be included on the next GNO/ME distribution!
 It is, of course, good to not start work on something that is already
 being worked on or already finished.  Before starting a project, you may
 first wish to check the Program Status List at
-\hturl{http://www.gno.org/~gno/status.bin.html}
+\hturl{http://www.gno.org/gno/status-bin.html}
 or the Library Status List at
-\hturl{http://www.gno.org/~gno/status.lib.html}.
+\hturl{http://www.gno.org/gno/status-lib.html}.
 
 \section{Software Piracy}
 

doc/refs/mkhtmlman

@@ -2,30 +2,24 @@
 #
 # Devin Reade, November 1997.
 #
-# $Id: mkhtmlman,v 1.9 1999/02/21 23:37:13 gdr-ftp Exp $
+# $Id: mkhtmlman,v 1.10 2012/08/25 07:22:00 gdr Exp $
 
-man2html=/usr/local/bin/man2html
 TMPDIR=${TMPDIR:-/tmp}
 
 #
 # Make sure we know where everything is going.
 #
-if [ -z "$GNOROOT" ]; then
+# GNOROOT is the root of the GNO source tree.
-	echo "GNOROOT variable not set"
+# MANHTML is the directory where we will be putting our manual pages.
-	exit 1
+# 
-fi
+MYDIR=`dirname $0`
-if [ -z "$MANHTML" ]; then
+
-	echo "MANHTML variable not set"
+[ -z "$GNOROOT" ] && GNOROOT=$MYDIR/../..
-	exit 1
+[ -z "$MANHTML" ] && MANHTML=$MYDIR/work
-fi
+[ -z "$NAME" ] && NAME="Fake Name"
-if [ -z "$NAME" ]; then
+[ -z "$ADDR" ] && ADDR="nobody@example.com"
-	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
@@ -74,7 +68,7 @@ for section in 1 2 3 4 5 6 7 8; do
 	echo "$f" >> $listfile
 	if ! ./newer $dest/$f.html $F; then
 	    echo "creating $dest/$f.html"
-	    nroff -man$macro $F | $man2html -nodepage | \
+	    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

doc/refs/mkstatus

@@ -5,7 +5,7 @@
 #
 # Usage:   mkstatus infile outfile.html
 #
-# $Id: mkstatus,v 1.2 1999/02/21 23:37:13 gdr-ftp Exp $
+# $Id: mkstatus,v 1.3 2012/08/25 07:22:00 gdr Exp $
 #
 
 # check usage and open files
@@ -28,11 +28,10 @@ printf(outfp
        "<html>\n" .
        "<head>\n" .
        "<title>GNO Status: Programs</title>\n" .
-       '<base HREF="http://www.gno.org/">' . "\n" .
        "</head>\n" .
        "<body bgcolor=#ffffff textcolour=#000000 " .
        "linkcolour=#0000FF vlinkcolour=#001177 alinkcolour=#001177>\n" .
-       '<A HREF="gno"><IMG src="http://www.gno.org/icons/back.gif"' .
+       '<A HREF="/gno"><IMG src="/gno/icons/back.gif"' .
        'alt="Back to the GNO Documentation Page"' .
        'align="right" width="24" height="24" border="0"></A>' . "\n" .
        "<BR CLEAR=RIGHT>\n");
@@ -120,7 +119,7 @@ printf(outfp
 printf(outfp
        "If you would like to work on a given utility, make sure you pick\n".
        "one that has not already been claimed.  Before starting, you should\n".
-       "then contact ".'<A HREF="mailto:gdr@trenco.gno.org">Devin Reade</A> '.
+       "then contact ".'<A HREF="mailto:gdr@gno.org">Devin Reade</A> '.
        "to ensure your name gets on the list.  This should eliminate\n".
        "duplicated work<p>\n");
 
@@ -293,7 +292,7 @@ printf(outfp
        "<hr>\n" .
        "Devin Reade\n" .
        "<br>\n" .
-       '<A HREF="mailto:gdr@trenco.gno.org">gdr@trenco.gno.org</A>' ."\n".
+       '<A HREF="mailto:gdr@gno.org">gdr@gno.org</A>' ."\n".
        "<p></body></html>\n");