- updated to list the ftp locations of the various documents

This commit is contained in:
gdr 1997-11-30 06:45:16 +00:00
parent ce32f61b41
commit 17de7accde
2 changed files with 165 additions and 37 deletions

View File

@ -5,7 +5,7 @@
#
# Devin Reade, 1997.
#
# $Id: Makefile,v 1.2 1997/11/24 05:46:28 gdr Exp $
# $Id: Makefile,v 1.3 1997/11/30 06:45:15 gdr Exp $
#
# Set this to 'true' (without the quotes) for local links (used
@ -43,13 +43,20 @@ MINDEX = index.html
HTML_ROOT = http://trenco.myrias.com/~gno
GIFDIR = http://trenco.myrias.com/icons
.END
FTP_ROOT = ftp://trenco.myrias.com/pub/apple2/gno
FTP_ROOT = ftp://trenco.myrias.com/pub/apple2/apple.16bit/gno
# Where can the FAQ be located?
#FAQ = http://web.cs.ualberta.ca/~glyn/FAQ.csa2g
FAQ = http://trenco.myrias.com/~gno/FAQ.html
FAQLOG = http://trenco.myrias.com/~gno/FAQ-log
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
# Where can the old v2.0.4 docs be found?
#OLD_HTML = http://web.cs.ualberta.ca/~glyn/GNOv2.0.4Docs
@ -69,14 +76,15 @@ CONTACT2 = '<br>Document Version: '
# Some more programs and flags
GETDATE = ./getdate -date
GETVERS = ./getdate -version
DVIPS_FLAGS = -tletter
DVIPS_FLAGS =
LATEX_FLAGS =
TEX2HTML_FLAGS = -info "" -local_icons -dir $(HTMLD) -up_url $(MINDEX)
TEXINPUTS = ':/usr/local/lib/latex2html'
DVI = kern.dvi # intro.dvi
PS = kern.ps # intro.ps
HTML = $(HTMLD)/kern.html # $(HTMLD)/intro.html
DVI = intro.dvi kern.dvi
PS_LTR = intro.ltr.ps kern.ltr.ps
PS_A4 = intro.a4.ps kern.a4.ps
HTML = $(HTMLD)/intro.html $(HTMLD)/kern.html
.PRECIOUS: $(DVI)
@ -89,33 +97,55 @@ MKSO = $(MANORG)/mkso.data
MANUAL_GARBAGE = top.html
TEX_GARBAGE = *.err *.aux *.log *.dvi *.toc *.idx *.ilg *.ind
DVIPS_GARBAGE = *.ps *.djc
BIB_GARBAGE = *.blg *.bbl
UPLOADS = htmld.tar.gz \
kern.dvi.Z kern.ps.Z
intro.dvi.Z intro.ltr.ps.Z intro.a4.ps.Z \
kern.dvi.Z kern.ltr.ps.Z kern.a4.ps.Z
#
# targets
#
all: h dvi ps man
all: dvi ps h man
dvi: $(DVI)
ps: $(PS)
ps: ps_ltr ps_a4
ps_ltr: $(PS_LTR)
ps_a4: $(PS_A4)
h: $(HTML) $(HTMLD)/index.html $(HTMLD)/unaval.html top.html cleanhtml
bib: intro.bbl
intro.bbl: gno.bib
bibtex intro
upload: man $(UPLOADS)
htmld.tar.gz: h
tar -cf - $(HTMLD) | gzip --best > $@
kern.dvi.Z: kern.dvi; compress -c $< > $@
kern.ps.Z: kern.ps; compress -c $< > $@
intro.dvi.Z: intro.dvi; compress -c $< > $@
intro.ltr.ps.Z: intro.ltr.ps; compress -c $< > $@
intro.a4.ps.Z: intro.a4.ps; compress -c $< > $@
kern.dvi.Z: kern.dvi; compress -c $< > $@
kern.ltr.ps.Z: kern.ltr.ps; compress -c $< > $@
kern.a4.ps.Z: kern.a4.ps; compress -c $< > $@
gsh.dvi.Z: gsh.dvi; compress -c $< > $@
gsh.ltr.ps.Z: gsh.ltr.ps; compress -c $< > $@
gsh.a4.ps.Z: gsh.a4.ps; compress -c $< > $@
$(HTMLD)/index.html: $(MINDEX)
@echo "making $@"; \
[ -d $(HTMLD) ] || mkdir -p $(HTMLD); \
perl -p -e 's,%%HTML_ROOT%%,$(HTML_ROOT),g;' \
-e 's,%%FTP_ROOT%%,$(FTP_ROOT),g;' \
-e 's,%%FTP_INTRO%%,$(FTP_INTRO),g;' \
-e 's,%%FTP_KERN%%,$(FTP_KERN),g;' \
-e 's,%%FTP_GSH%%,$(FTP_GSH),g;' \
-e 's,%%FAQ%%,$(FAQ),g;' \
-e 's,%%FAQLOG%%,$(FAQLOG),g;' \
-e 's,%%FAQ_TEXT%%,$(FAQ_TEXT),g;' \
-e 's,%%FAQLOG_TEXT%%,$(FAQLOG_TEXT),g;' \
-e 's,%%OLD_HTML%%,$(OLD_HTML),g;' \
-e 's,%%GIFDIR%%,$(GIFDIR),g;' \
< $< > $@
@ -149,7 +179,7 @@ man: mansetup
mansetup: newer
clean:
-rm -rf *~ $(TEX_GARBAGE) $(DVIPS_GARBAGE) $(UPLOADS)
-rm -rf *~ $(TEX_GARBAGE) $(BIB_GARBAGE) $(DVIPS_GARBAGE) $(UPLOADS)
clobber: clean
-rm -rf $(MANUAL_GARBAGE) $(HTMLD) $(PSD) $(DVID) newer
@ -171,24 +201,22 @@ $(HTMLD)/%.html: %.tex
$(HTMLD)/%.gif: GIF/%.gif
ln $< $@
#$(PSD)/%.ps: %.ps
# @true; [ -d $(PSD) ] || mkdir $(PSD)
# rm -f $@
# ln $*.ps $@
%.ltr.ps: %.dvi
$(DVIPS) -tletter $(DVIPS_FLAGS) -o $@ $<
#$(DVID)/%.dvi: %.dvi
# @true; [ -d $(DVID) ] || mkdir $(DVID)
# rm -f $@
# ln $< $@
%.ps: %.dvi
$(DVIPS) $(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

@ -33,14 +33,36 @@ Windows&nbsp;(95,&nbsp;NT) ... <em>Just&nbsp;say&nbsp;GNO!</em>
<H2>Frequently Asked Questions (and Answers)</H2>
</A>
The
<A HREF="%%FAQ%%">FAQ</A>
for the USENET newsgroup, comp.sys.apple2.gno may be found
<A HREF="%%FAQ%%">here</A>.
It is recommended reading and contains information that is not covered
in the manuals, or that supercedes the manuals. For a summary of the
most recent changes (since the last update), see the FAQ
<A HREF="%%FAQLOG%%">Change Log</A>.
The newsgroup <b> comp.sys.apple2.gno </b> is the primary source
for GNO information on USENET. The FAQ (Frequently Asked Questions
list) for this newsgroup is recommended reading and contains
information that is not covered in the manuals, or that supercedes
the manuals.
The FAQ is posted monthy on <b> comp.sys.apple2.gno</b>, and is also
available online.
<p>
A summary of the most recent changes (typically since the previous
monthly posting) may be obtained from the (abbreviated) Change Log.
<p>
The online html version of these documents may be found at:
<ul>
<li><A HREF="%%FAQ%%">%%FAQ%%</A>
(FAQ)
<li><A HREF="%%FAQLOG%%">%%FAQLOG%%</A>
(Change Log)
</ul>
<p>
The text version of these documents are available via ftp at the
following locations:
<ul>
<li><A HREF="%%FAQ_TEXT%%">%%FAQ_TEXT%%</A>
(FAQ)
<li><A HREF="%%FAQLOG_TEXT%%">%%FAQLOG_TEXT%%</A>
(Change Log)
</ul>
<p>
<hr>
@ -49,16 +71,89 @@ most recent changes (since the last update), see the FAQ
</A>
These are based on Procyon's August 1996 v2.0.4 documents, but have
been updated and enhanced.
been updated and enhanced. <em>These manuals are still being revised;
if you find errors or omissions, please contact the maintainer (Devin
Reade) at the address at the bottom of this page.</em>
<p>
<dt><A HREF="%%HTML_ROOT%%/intro.html">Overview and Installation</A>
<dd>This document contains introductory information, installation
instructions, a list of hardware requirements, suggested readings,
and similar material. It is a good starting point for those new to GNO.
It is also available for download in various formats:
<ul>
<!--
<li><A HREF="%%HTML_ROOT%%/intro.html">Overview</A> -->
<li><A HREF="%%HTML_ROOT%%/unaval.html">Overview</A>
<li><A HREF="%%HTML_ROOT%%/kern.html">Kernel Reference Manual</A>
<li><A HREF="%%HTML_ROOT%%/unaval.html">GNO Shell User's Manual</A>
<li>Compressed Postscript (Letter):
<A HREF="%%FTP_INTRO%%.ltr.ps.Z">%%FTP_INTRO%%.ltr.ps.Z</A>
<li>Compressed Postscript (A4):
<A HREF="%%FTP_INTRO%%.a4.ps.Z">%%FTP_INTRO%%.a4.ps.Z</A>
<br>
<em>See the <A HREF="#a4note">note</A> on the A4 paper format,
below.</em>
<li>Compressed DVI:
<A HREF="%%FTP_INTRO%%.dvi.Z">%%FTP_INTRO%%.dvi.Z</A>
<li>Appleworks (Classic) in a NuFX archive:
<A HREF="unaval.html">(not yet available)</A>
<li>Text (ASCII) in a NuFX archive:
<A HREF="unaval.html">(not yet available)</A>
</ul>
<p>
<dt><A HREF="%%HTML_ROOT%%/kern.html">Kernel Reference Manual</A>
<dd>This is a technical introduction and reference to the GNO Kernel,
which is the heart of the GNO system. It can be heavy reading for
the new user, but is a must for the application programmer.
It is also available for download in various formats:
<ul>
<li>Compressed Postscript (Letter):
<A HREF="%%FTP_KERN%%.ltr.ps.Z">%%FTP_KERN%%.ltr.ps.Z</A>
<li>Compressed Postscript (A4):
<A HREF="%%FTP_KERN%%.a4.ps.Z">%%FTP_KERN%%.a4.ps.Z</A>
<br>
<em>See the <A HREF="#a4note">note</A> on the A4 paper format,
below.</em>
<li>Compressed DVI:
<A HREF="%%FTP_KERN%%.dvi.Z">%%FTP_KERN%%.dvi.Z</A>
<li>Appleworks (Classic) in a NuFX archive:
<A HREF="unaval.html">(not yet available)</A>
<li>Text (ASCII) in a NuFX archive:
<A HREF="unaval.html">(not yet available)</A>
</ul>
<p>
<dt><A HREF="%%HTML_ROOT%%/unaval.html">GNO Shell User's Manual</A>
<dd>This is the reference manual for the GNO Shell, otherwise known
as <b>gsh</b>. The current version is more of a tutorial than a
true reference manual.
It is also available for download in various formats:
<ul>
<li>Compressed Postscript (Letter):
<A HREF="unaval.html">(not yet available)</A>
<li>Compressed Postscript (A4):
<A HREF="unaval.html">(not yet available)</A>
<br>
<em>See the <A HREF="#a4note">note</A> on the A4 paper format,
below.</em>
<li>Compressed DVI:
<A HREF="unaval.html">(not yet available)</A>
<li>Appleworks (Classic) in a NuFX archive:
<A HREF="unaval.html">(not yet available)</A>
<li>Text (ASCII) in a NuFX archive:
<A HREF="unaval.html">(not yet available)</A>
</ul>
<p>
<A NAME="a4note">
<h3>Note on A4 Paper Formats</h3>
</A>
Since I do not use the A4 paper format, I would be interested
in feedback on how the formatting turns out. Currently, the
DVI files are created for the the letter paper size, and only
in the DVI to Postscript conversion is the A4 paper size taken
into account. While this greatly simplifies the document
&quot;build&quot; process, it might result in less than desirable
output. Please email your observations to me at the address at
the bottom of this page.
<p>
<hr>
@ -94,6 +189,11 @@ For a brief introduction to the manual pages in general, see the
System Administration
</ul>
<p>
These manual pages are part of the GNO base distribution and are therefore
not available at this time in any other format. They may be published
in Postscript form after GNO v2.0.6 is released.
<p>
<hr>
<A NAME="related">