diff --git a/doc/refs/.cvsignore b/doc/refs/.cvsignore new file mode 100644 index 0000000..e3fc3e4 --- /dev/null +++ b/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 diff --git a/doc/refs/GNUmakefile b/doc/refs/GNUmakefile new file mode 100644 index 0000000..2ca965a --- /dev/null +++ b/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)\ + \ + <$(ADDRESS)>
Last Updated: ' +CONTACT2 = '
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 '(//) && ($$cts=1);' \ + -e '(//) && ($$cts=0);' \ + -e '($$cts == 1) && (s/(
|
)//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,(.*),) && 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" diff --git a/doc/refs/Makefile b/doc/refs/Makefile index 7f87494..c018b3e 100644 --- a/doc/refs/Makefile +++ b/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 $*; \ diff --git a/doc/refs/index.html b/doc/refs/index.html index 43bcd03..a2fd119 100644 --- a/doc/refs/index.html +++ b/doc/refs/index.html @@ -4,7 +4,7 @@ - + Back to the GNO Consortium PageThe Describe Database
  • Status Lists for Work Under Development:
  • GNO-Related Web Links
  • Old Documentation (August 1996 Revision for GNO v2.0.4) diff --git a/doc/refs/intro.tex b/doc/refs/intro.tex index 20b6b3e..a19ece5 100644 --- a/doc/refs/intro.tex +++ b/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} diff --git a/doc/refs/mkhtmlman b/doc/refs/mkhtmlman index 69a9440..bdbd250 100755 --- a/doc/refs/mkhtmlman +++ b/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 - 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 +# GNOROOT is the root of the GNO source tree. +# MANHTML is the directory where we will be putting our manual pages. +# +MYDIR=`dirname $0` + +[ -z "$GNOROOT" ] && GNOROOT=$MYDIR/../.. +[ -z "$MANHTML" ] && MANHTML=$MYDIR/work +[ -z "$NAME" ] && NAME="Fake Name" +[ -z "$ADDR" ] && ADDR="nobody@example.com" + + 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//GNO: '"$f2($section)"'<\/title><body bgcolor=\#ffffff textcolor=\#000000 linkcolor=\#0000FF vlinkcolor=\#001177 alinkcolor=\#001177>/;'\ > $dest/$f.html diff --git a/doc/refs/mkstatus b/doc/refs/mkstatus index 8d9bf59..12735f9 100755 --- a/doc/refs/mkstatus +++ b/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\n" . - '' . "\n" . "\n" . "\n" . - '' . "\n" . "
    \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 ".'Devin Reade '. + "then contact ".'Devin Reade '. "to ensure your name gets on the list. This should eliminate\n". "duplicated work

    \n"); @@ -293,7 +292,7 @@ printf(outfp "


    \n" . "Devin Reade\n" . "
    \n" . - 'gdr@trenco.gno.org' ."\n". + 'gdr@gno.org' ."\n". "

    \n");