diff --git a/doc/refs/Makefile b/doc/refs/Makefile
index f05ae20..7f87494 100644
--- a/doc/refs/Makefile
+++ b/doc/refs/Makefile
@@ -7,7 +7,7 @@
#
# Devin Reade, 1997.
#
-# $Id: Makefile,v 1.13 1999/01/28 05:22:16 gdr-ftp Exp $
+# $Id: Makefile,v 1.14 1999/02/21 23:37:11 gdr-ftp Exp $
#
# Set this to 'true' (without the quotes) for local links (used
@@ -37,7 +37,7 @@ PSD = psd
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/
+ GIFDIR = file:/home/gdr/graphics
.ELSE
HTML_ROOT = http://www.gno.org/~gno
GIFDIR = http://www.gno.org/icons
@@ -80,9 +80,9 @@ TEX2HTML_FLAGS = -info "" -local_icons -dir $(HTMLD) -up_url refs.html \
TEXINPUTS = ':/usr/local/lib/latex2html'
DVI = intro.dvi kern.dvi
-PS_LTR = intro.ltr.ps kern.ltr.ps
+PS_LTR = intro.ltr.ps kern.ltr.ps gsh-ltr-ps
PS_A4 = intro.a4.ps kern.a4.ps
-HTML = $(HTMLD)/intro.html $(HTMLD)/kern.html
+HTML = $(HTMLD)/intro.html $(HTMLD)/kern.html gsh-h
.PRECIOUS: $(DVI)
@@ -92,20 +92,27 @@ MKSO = $(MANORG)/mkso.data
# Scratch files to clean up
-MANUAL_GARBAGE = top.html
+MANUAL_GARBAGE =
TEX_GARBAGE = *.err *.aux *.log *.dvi *.toc *.idx *.ilg *.ind
DVIPS_GARBAGE = *.ps *.djc
BIB_GARBAGE = *.blg *.bbl
+UPLOADDIR = uploads
+
UPLOADS = \
- intro.dvi.Z intro.ltr.ps.Z intro.a4.ps.Z \
- kern.dvi.Z kern.ltr.ps.Z kern.a4.ps.Z \
- htmld.tar.gz
+ $(UPLOADDIR)/intro.dvi.Z \
+ $(UPLOADDIR)/intro.ltr.ps.Z \
+ $(UPLOADDIR)/intro.a4.ps.Z \
+ $(UPLOADDIR)/kern.dvi.Z \
+ $(UPLOADDIR)/kern.ltr.ps.Z \
+ $(UPLOADDIR)/kern.a4.ps.Z \
+ $(UPLOADDIR)/gsh.ltr.ps.Z \
+ $(UPLOADDIR)/htmld.tar.gz
#
# targets
#
-upload: all $(UPLOADS)
+upload: all setup $(UPLOADS)
all: dvi ps h man notes
dvi: $(DVI)
ps: ps_ltr ps_a4
@@ -119,7 +126,7 @@ h: $(HTML) \
$(HTMLD)/related.html \
$(HTMLD)/oldrefs.html \
$(HTMLD)/bugs.html \
- $(HTMLD)/unaval.html top.html cleanhtml
+ $(HTMLD)/unaval.html cleanhtml
bib: intro.bbl
intro.bbl: gno.bib
@@ -128,20 +135,28 @@ intro.bbl: gno.bib
# keeps intro.tex in sync with ../../verbatim/boot/README.install
notes:; ./mknotes
-htmld.tar.gz: h
+$(UPLOADDIR)/htmld.tar.gz: h
+ rm -rf $(HTMLD)/gsh
+ (cd gsh; tar -cf - gsh) | (cd $(HTMLD); tar -xpBf -)
tar -cf - $(HTMLD) | gzip --best > $@
-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 $< > $@
+$(UPLOADDIR)/intro.dvi.Z: intro.dvi; compress -c $< > $@
+$(UPLOADDIR)/intro.ltr.ps.Z: intro.ltr.ps; compress -c $< > $@
+$(UPLOADDIR)/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 $< > $@
+$(UPLOADDIR)/kern.dvi.Z: kern.dvi; compress -c $< > $@
+$(UPLOADDIR)/kern.ltr.ps.Z: kern.ltr.ps; compress -c $< > $@
+$(UPLOADDIR)/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 $< > $@
+$(UPLOADDIR)/gsh.ltr.ps.Z: gsh/gsh.ltr.ps.Z; cp $< $@
+$(UPLOADDIR)/gsh/gsh.ltr.ps.Z: gsh-ltr-ps
+
+gsh-h:; cd gsh; $(MAKE) h
+gsh-ltr-ps:; cd gsh; $(MAKE) ps
+
+# 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 $< > $@
REPLACE= perl -p -e 's,%%HTML_ROOT%%,$(HTML_ROOT),g;' \
-e 's,%%FTP_ROOT%%,$(FTP_ROOT),g;' \
@@ -218,9 +233,6 @@ cleanhtml:
# -e '($$cts == 1) && (s/^\s*
\s*$$//);'
-top.html:
- ln -s $(HTMLD)/index.html top.html
-
# This target creates the html versions of all the current man pages,
# plus the chapter index pages. Unfortunately, this target rebuilds
@@ -232,11 +244,17 @@ man: mansetup
mansetup: newer
+setup:
+ @/bin/true; \
+ [ -d $(UPLOADDIR) ] || mkdir -p $(UPLOADDIR)
+
clean:
- -rm -rf *~ $(TEX_GARBAGE) $(BIB_GARBAGE) $(DVIPS_GARBAGE) $(UPLOADS)
+ -rm -rf *~ $(TEX_GARBAGE) $(BIB_GARBAGE) $(DVIPS_GARBAGE) $(UPLOADDIR)
+ cd gsh; $(MAKE) $@
clobber: clean
-rm -rf $(MANUAL_GARBAGE) $(HTMLD) $(PSD) $(DVID) newer
+ cd gsh; $(MAKE) $@
#
# default rules
@@ -252,9 +270,6 @@ $(HTMLD)/%.html: %.tex
< $(HTMLD)/refs.html `" \
$(TEX2HTML_FLAGS) $<
-$(HTMLD)/%.gif: GIF/%.gif
- ln $< $@
-
%.ltr.ps: %.dvi
$(DVIPS) -tletter $(DVIPS_FLAGS) -o $@ $<
diff --git a/doc/refs/README b/doc/refs/README
index 3a4b5d2..f07f48d 100644
--- a/doc/refs/README
+++ b/doc/refs/README
@@ -19,7 +19,7 @@ points above.
Devin Reade
December 1997.
-$Id: README,v 1.3 1998/02/19 03:03:49 gdr-ftp Exp $
+$Id: README,v 1.4 1999/02/21 23:37:12 gdr-ftp Exp $
WHAT THE FILES ARE
@@ -82,6 +82,11 @@ documentation. They are:
LaTeX2e
LaTeX is responsible for creating the DVI and Postscript
versions of the documentation.
+
+ Building the sgml source requires teTeX, version 0.9 or
+ higher. It can be obtained from:
+ ftp://ftp.rrzn.uni-hannover.de/pub/local/misc/teTeX-beta
+
bibtex, makeidx
These two utilities are required for making the bibliography
and index, respectively. They are likely part of your
@@ -105,6 +110,10 @@ documentation. They are:
source to html. It is available at
http://www.oac.uci.edu/indiv/ehood/man2html.html
+ sgmltools
+ The sgml sources are built using sgmltools v2.x. See
+ http://www.sgmltools.org
+
WHERE TO BUILD IT
^^^^^^^^^^^^^^^^^
diff --git a/doc/refs/head.html b/doc/refs/head.html
index a7bad61..ecae552 100644
--- a/doc/refs/head.html
+++ b/doc/refs/head.html
@@ -1,11 +1,16 @@
%%TITLE%%
-
-
+
-
diff --git a/doc/refs/index.html b/doc/refs/index.html
index 18a7574..8be44dd 100644
--- a/doc/refs/index.html
+++ b/doc/refs/index.html
@@ -1,11 +1,10 @@
GNO Documentation Page
-
-
@@ -19,28 +18,38 @@ runs on top of the native operating system, GS/OS.
This is master documentation site for GNO.
It consists of the following sections:
-- Frequently Asked Questions
-
- Reference Manuals
-
- Manual Pages
-
- Bug Reports
+
- Frequently Asked Questions
+
- Reference Manuals
+
- Manual Pages
+
- Bug Reports
- The Describe Database
- Status Lists for Work Under Development:
-
- GNO-Related Web Links
-
- Old Documentation (August 1996 Revision for GNO v2.0.4)
+
- GNO-Related Web Links
+
- Old Documentation (August 1996 Revision for GNO v2.0.4)
NEW!
+
+21 February 1999
+
+The Gsh Users' Guide is now available for download or online viewing.
+It is not yet updated for gsh v2.0.
+See the Reference Manuals
+page for details.
+
+15 February 1999
+
GNO v2.0.6 is (finally) available. This is a full release and the
current documentation and scripts assume that you are not
installing on top of an existing system.
Ensure that you read the chapter on installing v2.0.6 in the
-
+
Overview and Installation Reference.
@@ -58,6 +67,7 @@ or have any suggestions, please report them via the
The current release does not include networking support.
+
Remember:
If someone comes up to you on the street and offers you some
diff --git a/doc/refs/intro.tex b/doc/refs/intro.tex
index dc6b087..20b6b3e 100644
--- a/doc/refs/intro.tex
+++ b/doc/refs/intro.tex
@@ -1,7 +1,7 @@
%
% GNO Overview
%
-% $Id: intro.tex,v 1.14 1999/02/15 18:54:37 gdr-ftp Exp $
+% $Id: intro.tex,v 1.15 1999/02/21 23:37:12 gdr-ftp Exp $
%
\documentclass{report}
@@ -9,7 +9,13 @@
\usepackage{hthtml}
\usepackage{makeidx}
\makeindex
-\bodytext{bgcolor=#ffffff}
+\bodytext{
+ bgcolor=#ffffff
+ textcolor=#000000
+ linkcolor=#0000FF
+ vlinkcolor=#001177
+ alinkcolor=#001177
+ }
\begin{document}
@@ -36,7 +42,7 @@
\newcommand{\kernel}[1]{\htlink{#1}
{http://www.gno.org/~gno/kern.html}}
\newcommand{\gsh}[1]{\htlink{#1}
- {http://www.gno.org/~gno/gsh.html}}
+ {http://www.gno.org/~gno/gsh/index.html}}
\newcommand{\manpages}[1]{\htlink{#1}
{http://www.gno.org/~gno/manindex.html}}
\parindent=0pt
@@ -975,7 +981,7 @@ directories. Here is a brief rundown of thier contents:
\em
\textbf{Important Note:}
-Before attempting to install GNO v2.0.4, you are strongly encouraged to
+Before attempting to install GNO v2.0.6, you are strongly encouraged to
read this entire chapter, and then consult the
\faqhtml{GNO FAQ} (Frequently Asked Questions list, which is also
available via \faqtext{ftp}) for those sections related to installation.
diff --git a/doc/refs/kern.tex b/doc/refs/kern.tex
index ea78205..34ee3e3 100644
--- a/doc/refs/kern.tex
+++ b/doc/refs/kern.tex
@@ -1,14 +1,20 @@
%
% GNO Kernel Reference Manual
%
-% $Id: kern.tex,v 1.5 1998/06/12 14:47:37 gdr-ftp Exp $
+% $Id: kern.tex,v 1.6 1999/02/21 23:37:12 gdr-ftp Exp $
%
\documentclass{report}
\usepackage{html}
\usepackage{makeidx}
\makeindex
-\bodytext{bgcolor=#ffffff}
+\bodytext{
+ bgcolor=#ffffff
+ textcolor=#000000
+ linkcolor=#0000FF
+ vlinkcolor=#001177
+ alinkcolor=#001177
+ }
\begin{document}
\title{GNO Kernel Reference Manual}
diff --git a/doc/refs/manindex.html b/doc/refs/manindex.html
index 9079227..2861ca0 100644
--- a/doc/refs/manindex.html
+++ b/doc/refs/manindex.html
@@ -11,20 +11,20 @@ for GNO v2.0.4.
Each of the chapters has an introductory page, titled intro.
For a brief introduction to the manual pages in general, see the
-Introduction to Chapter 1.
+Introduction to Chapter 1.
diff --git a/doc/refs/mkhtmlman b/doc/refs/mkhtmlman
index 1d996b9..69a9440 100755
--- a/doc/refs/mkhtmlman
+++ b/doc/refs/mkhtmlman
@@ -2,7 +2,7 @@
#
# Devin Reade, November 1997.
#
-# $Id: mkhtmlman,v 1.8 1999/01/18 01:46:07 gdr-ftp Exp $
+# $Id: mkhtmlman,v 1.9 1999/02/21 23:37:13 gdr-ftp Exp $
man2html=/usr/local/bin/man2html
TMPDIR=${TMPDIR:-/tmp}
@@ -76,7 +76,7 @@ for section in 1 2 3 4 5 6 7 8; do
echo "creating $dest/$f.html"
nroff -man$macro $F | $man2html -nodepage | \
perl -p -e \
- 's/
/GNO: '"$f2($section)"'<\/title>/;'\
+ 's//GNO: '"$f2($section)"'<\/title>/;'\
> $dest/$f.html
fi
done
diff --git a/doc/refs/mkmandex b/doc/refs/mkmandex
index 827281d..c21c6ff 100755
--- a/doc/refs/mkmandex
+++ b/doc/refs/mkmandex
@@ -7,7 +7,7 @@
#
# Devin Reade, November 1997.
#
-# $Id: mkmandex,v 1.1 1997/11/24 05:07:27 gdr Exp $
+# $Id: mkmandex,v 1.2 1999/02/21 23:37:13 gdr-ftp Exp $
#
# initialize and check usage
@@ -34,10 +34,16 @@ $hdir = $hroot . '/man/';
printf("\n" .
"\n" .
"\n".
- '' . "\n" .
+ '' . "\n" .
"Chapter %s: %s\n" .
"\n" .
- "\n" .
+ "\n" .
"Chapter %s: %s
\n" .
"\n",
$num, $sec, $num, $sec);
diff --git a/doc/refs/mksgml b/doc/refs/mksgml
new file mode 100755
index 0000000..27ac773
--- /dev/null
+++ b/doc/refs/mksgml
@@ -0,0 +1,25 @@
+#! /usr/bin/perl
+
+$months[0] = '';
+$months[1] = 'January';
+$months[2] = 'February';
+$months[3] = 'March';
+$months[4] = 'April';
+$months[5] = 'May';
+$months[6] = 'June';
+$months[7] = 'July';
+$months[8] = 'August';
+$months[9] = 'September';
+$months[10] = 'October';
+$months[11] = 'November';
+$months[12] = 'December';
+
+while (<>) {
+ if (m,\$Date: 1999/02/21 23:37:13 $,) {
+ $year = $1;
+ $month = $2;
+ $day = $3;
+ $_ = $` . $day . ' ' . $months[int($month)] . ' ' . $year . $';
+ }
+ print;
+}
diff --git a/doc/refs/mkstatus b/doc/refs/mkstatus
index 436afc8..8d9bf59 100755
--- a/doc/refs/mkstatus
+++ b/doc/refs/mkstatus
@@ -5,7 +5,7 @@
#
# Usage: mkstatus infile outfile.html
#
-# $Id: mkstatus,v 1.1 1998/04/11 03:23:23 gdr-ftp Exp $
+# $Id: mkstatus,v 1.2 1999/02/21 23:37:13 gdr-ftp Exp $
#
# check usage and open files
@@ -32,7 +32,7 @@ printf(outfp
"\n" .
"\n" .
- '' . "\n" .
"
\n");
diff --git a/doc/refs/oldrefs.html b/doc/refs/oldrefs.html
index 2ba1429..d6b42d6 100644
--- a/doc/refs/oldrefs.html
+++ b/doc/refs/oldrefs.html
@@ -6,17 +6,17 @@ into html source.
@@ -42,20 +42,20 @@ pages is not divided along chapter boundries.
-- Part 1
+
- Part 1
Chapter 1: Commands and Applications
(intro(1) and binprint(1) to sum(1))
-
- Part 2
+
- Part 2
Chapter 1: Commands and Applications
(sz(1) to tar(1))
-
- Part 3
+
- Part 3
- Chapter 1: Commands and Applications
(tee(1) to yes(1))
- Chapter 2: System Calls
(alarm(2) to statfs(2))
- - Part 4
+
- Part 4
- Chapter 2: System Calls
(truncate(2) to wait(2))
diff --git a/doc/refs/posthtml b/doc/refs/posthtml
new file mode 100755
index 0000000..e9b6e2a
--- /dev/null
+++ b/doc/refs/posthtml
@@ -0,0 +1,8 @@
+#! /usr/bin/perl5 -i
+
+while(<>) {
+ chomp;
+ s,>
Back to the GNO Home page or the Reference Manuals page.
-
- Overview and Installation
+
- Overview and Installation
- This document contains introductory information (including how
to obtain GNO), installation
instructions, a list of hardware requirements, suggested readings,
@@ -29,21 +29,24 @@ It is also available for download in various formats:
-
- Kernel Reference Manual
+
- Kernel Reference Manual
- 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:
-
- GNO Shell User's Manual
+
- GNO Shell User's Manual
- This is the reference manual for the GNO Shell, otherwise known
as gsh. The current version is more of a tutorial than a
true reference manual.
It is also available for download in various formats:
- Compressed Postscript (Letter):
- (not yet available)
+ By HTTP
+ or FTP
- Compressed Postscript (A4):
(not yet available)
See the note on the A4 paper format,
below.
- - Compressed DVI:
- (not yet available)
- Appleworks (Classic) in a NuFX archive:
(not yet available)
- Text (ASCII) in a NuFX archive:
diff --git a/doc/refs/tail.html b/doc/refs/tail.html
index 2007767..34776dc 100644
--- a/doc/refs/tail.html
+++ b/doc/refs/tail.html
@@ -1,7 +1,7 @@
+src="http://www.gno.org/icons/a2viewable.gif" align=right>
Devin Reade
gdr@trenco.gno.org