fixing links and build

This commit is contained in:
gdr 2012-08-25 07:22:00 +00:00
parent cafd46ab01
commit ffe0029aa6
7 changed files with 329 additions and 38 deletions

22
doc/refs/.cvsignore Normal file
View File

@ -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

274
doc/refs/GNUmakefile Normal file
View File

@ -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"

View File

@ -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 $*; \

View File

@ -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><A HREF="status.lib.html">Library routines,
header files, and related manual pages.</A>
<li>Programs (<A HREF="status-bin.html">HTML</A>,
<A HREF="status-bin.txt">text</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>

View File

@ -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}

View File

@ -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/<BODY>/<title>GNO: '"$f2($section)"'<\/title><body bgcolor=\#ffffff textcolor=\#000000 linkcolor=\#0000FF vlinkcolor=\#001177 alinkcolor=\#001177>/;'\
> $dest/$f.html

View File

@ -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");