From 9416f9d55cbe8ef22ccd272d58597a746e0d0dd8 Mon Sep 17 00:00:00 2001 From: gdr-ftp Date: Thu, 19 Feb 1998 03:04:10 +0000 Subject: [PATCH] - split the top level GNO docs web page into subpages - add a file containing a list of man pages to ignore when building the html versions of the pages --- doc/refs/Makefile | 72 ++++++++-- doc/refs/README | 20 ++- doc/refs/faqindex.html | 36 +++++ doc/refs/head.html | 12 ++ doc/refs/ignored.pages | 14 ++ doc/refs/index.html | 318 ++--------------------------------------- doc/refs/kern.tex | 8 +- doc/refs/manindex.html | 35 +++++ doc/refs/mkhtmlman | 26 +++- doc/refs/oldrefs.html | 71 +++++++++ doc/refs/refs.html | 88 ++++++++++++ doc/refs/related.html | 41 ++++++ doc/refs/tail.html | 12 ++ doc/refs/unaval.html | 8 -- 14 files changed, 417 insertions(+), 344 deletions(-) create mode 100644 doc/refs/faqindex.html create mode 100644 doc/refs/head.html create mode 100644 doc/refs/ignored.pages create mode 100644 doc/refs/manindex.html create mode 100644 doc/refs/oldrefs.html create mode 100644 doc/refs/refs.html create mode 100644 doc/refs/related.html create mode 100644 doc/refs/tail.html diff --git a/doc/refs/Makefile b/doc/refs/Makefile index d10e8bc..1bf0023 100644 --- a/doc/refs/Makefile +++ b/doc/refs/Makefile @@ -7,7 +7,7 @@ # # Devin Reade, 1997. # -# $Id: Makefile,v 1.7 1998/01/26 07:13:04 gdr-ftp Exp $ +# $Id: Makefile,v 1.8 1998/02/19 03:03:48 gdr-ftp Exp $ # # Set this to 'true' (without the quotes) for local links (used @@ -32,9 +32,6 @@ DVID = dvid HTMLD = htmld PSD = psd -# The name of the manually-maintained index page in this directory -MINDEX = index.html - .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) @@ -80,7 +77,7 @@ GETDATE = ./getdate -date GETVERS = ./getdate -version DVIPS_FLAGS = LATEX_FLAGS = -TEX2HTML_FLAGS = -info "" -local_icons -dir $(HTMLD) -up_url $(MINDEX) +TEX2HTML_FLAGS = -info "" -local_icons -dir $(HTMLD) -up_url refs.html TEXINPUTS = ':/usr/local/lib/latex2html' DVI = intro.dvi kern.dvi @@ -114,7 +111,14 @@ dvi: $(DVI) ps: ps_ltr ps_a4 ps_ltr: $(PS_LTR) ps_a4: $(PS_A4) -h: $(HTML) $(HTMLD)/index.html $(HTMLD)/unaval.html top.html cleanhtml +h: $(HTML) \ + $(HTMLD)/index.html \ + $(HTMLD)/faqindex.html \ + $(HTMLD)/refs.html \ + $(HTMLD)/manindex.html \ + $(HTMLD)/related.html \ + $(HTMLD)/oldrefs.html \ + $(HTMLD)/unaval.html top.html cleanhtml bib: intro.bbl intro.bbl: gno.bib @@ -137,10 +141,7 @@ 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;' \ +REPLACE= 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;' \ @@ -150,11 +151,52 @@ $(HTMLD)/index.html: $(MINDEX) -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;' \ - < $< > $@ + -e 's,%%GIFDIR%%,$(GIFDIR),g;' -$(HTMLD)/unaval.html: unaval.html - cp $< $@ +$(HTMLD)/index.html: index.html tail.html + @echo "making $@"; \ + [ -d $(HTMLD) ] || mkdir -p $(HTMLD); \ + cat index.html tail.html | $(REPLACE) > $@ + +$(HTMLD)/faqindex.html: faqindex.html + @echo "making $@"; \ + [ -d $(HTMLD) ] || mkdir -p $(HTMLD); \ + cat head.html $< tail.html | $(REPLACE) \ + -e 's,%%TITLE%%,GNO Frequently Asked Questions (Index),;' > $@ +$(HTMLD)/faqindex.html: head.html tail.html + +$(HTMLD)/refs.html: refs.html + @echo "making $@"; \ + [ -d $(HTMLD) ] || mkdir -p $(HTMLD); \ + cat head.html $< tail.html | $(REPLACE) \ + -e 's,%%TITLE%%,GNO Reference Manuals,;' > $@ +$(HTMLD)/refs.html: head.html tail.html + +$(HTMLD)/manindex.html: manindex.html + @echo "making $@"; \ + [ -d $(HTMLD) ] || mkdir -p $(HTMLD); \ + cat head.html $< tail.html | $(REPLACE) \ + -e 's,%%TITLE%%,GNO Manual Pages Index,;' > $@ +$(HTMLD)/manindex.html: head.html tail.html + +$(HTMLD)/related.html: related.html + @echo "making $@"; \ + [ -d $(HTMLD) ] || mkdir -p $(HTMLD); \ + cat head.html $< tail.html | $(REPLACE) \ + -e 's,%%TITLE%%,GNO-Related Web Pages,;' > $@ +$(HTMLD)/related.html: head.html tail.html + +$(HTMLD)/oldrefs.html: oldrefs.html + @echo "making $@"; \ + [ -d $(HTMLD) ] || mkdir -p $(HTMLD); \ + cat head.html $< tail.html | $(REPLACE) \ + -e 's,%%TITLE%%,Old GNO Documentation,;' > $@ +$(HTMLD)/oldrefs.html: head.html tail.html + +$(HTMLD)/unaval.html: head.html unaval.html tail.html + @echo "making $@"; \ + cat head.html unaval.html tail.html | $(REPLACE) \ + -e 's,%%TITLE%%,Unpublished Document,;' > $@ cleanhtml: @echo "cleaning guano from html files"; \ @@ -198,7 +240,7 @@ $(HTMLD)/%.html: %.tex -address $(CONTACT1)"`$(GETDATE) <$<`"$(CONTACT2)"`$(GETVERS) <$<`" \ -up_title \ "`perl -n -e '(m,(.*),) && printf("%s\n",$$1);'\ - < $(MINDEX) `" \ + < $(HTMLD)/refs.html `" \ $(TEX2HTML_FLAGS) $< $(HTMLD)/%.gif: GIF/%.gif diff --git a/doc/refs/README b/doc/refs/README index aabd709..3a4b5d2 100644 --- a/doc/refs/README +++ b/doc/refs/README @@ -19,7 +19,7 @@ points above. Devin Reade December 1997. -$Id: README,v 1.2 1998/01/26 07:13:05 gdr-ftp Exp $ +$Id: README,v 1.3 1998/02/19 03:03:49 gdr-ftp Exp $ WHAT THE FILES ARE @@ -27,20 +27,26 @@ WHAT THE FILES ARE Makefile Configuration file for use with dmake. README This file. + faqindex.html This shows links to the html and text versions + of the GNO FAQ. getdate A perl script which extracts the date or version from an RCS "Id" tag, and prints it in a more "normal" fashion. Usage: "getdate outfile" gno.bib The bibliography used in the Overview. This is processed using BibTeX. + gsh.tex This is the LaTeX source to the "GNO Shell Reference + Manual". + head.html This is information common to the beginning of most + of the other html files. index.html This is the top-level page for the html version. It contains links to the three books, the generated man pages, the FAQ, et al. intro.tex This is the LaTeX source to the "Overview and Installation Manual". - gsh.tex This is the LaTeX source to the "GNO Shell Reference - Manual". kern.tex This is the LaTeX source to the "Kernel Reference Manual". + manindex.html This is an index of the various manual page + chapters. mkhtmlman This is a custom script which drives the man2html program. It basically searches for the man pages in the GNO search tree to convert, and adds in some @@ -50,6 +56,11 @@ WHAT THE FILES ARE newer.c A source file which compiles to a program that compares the modification date of two files. Used by mkhtmlman to avoid unnecessary processing. + oldrefs.html This is an index of old (v2.0.4) documenatation. + refs.html This is an index of the current reference manuals. + related.html This is an index of GNO-related web pages. + tail.html This is information common to the end of most of + the other html files. unaval.html A generic web page that says "the page you requested is not ready yet". @@ -138,9 +149,6 @@ primary GNO site, the following should not need to be changed: is invoked. On the other hand, there shouldn't be any need to change this. - unaval.html: - The maintainer's name and address is hard-coded here. - Once the above dependancies have been addressed, you can use dmake(1) to build the sources. The primary targets are: diff --git a/doc/refs/faqindex.html b/doc/refs/faqindex.html new file mode 100644 index 0000000..834fd14 --- /dev/null +++ b/doc/refs/faqindex.html @@ -0,0 +1,36 @@ + +

GNO Frequently Asked Questions (and Answers)

+ +The newsgroup comp.sys.apple2.gno 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 comp.sys.apple2.gno, and is also +available online. +

+ +A summary of the most recent changes (typically since the previous +monthly posting) may be obtained from the (abbreviated) Change Log. +

+ +The online html version of these documents may be found at: +

+

+ +The text version of these documents are available via ftp at the +following locations: +

+

diff --git a/doc/refs/head.html b/doc/refs/head.html new file mode 100644 index 0000000..a7bad61 --- /dev/null +++ b/doc/refs/head.html @@ -0,0 +1,12 @@ + + +%%TITLE%% + + + + +Back to the GNO Documentation Page +
+ diff --git a/doc/refs/ignored.pages b/doc/refs/ignored.pages new file mode 100644 index 0000000..48da0c3 --- /dev/null +++ b/doc/refs/ignored.pages @@ -0,0 +1,14 @@ +# These are files for which we will _not_ generate html man pages. +# It is critical that there be no whitespace either preceeding nor +# following these file names. +# +# $Id: ignored.pages,v 1.1 1998/02/19 03:03:53 gdr-ftp Exp $ +# +00.DUMMY +../../usr.man/man4/tty.4 +../../bin/gsh/updates1.1 +../../sbin/reboot/boot.hp300.8 +../../sbin/reboot/boot.i386.8 +../../sbin/reboot/boot.sparc.8 +../../sbin/reboot/boot.tahoe.8 +../../sbin/reboot/boot.vax.8 diff --git a/doc/refs/index.html b/doc/refs/index.html index d056ac4..2d1b341 100644 --- a/doc/refs/index.html +++ b/doc/refs/index.html @@ -1,9 +1,15 @@ GNO Documentation Page + +Back to the GNO Consortium Page +
+

The GNO Multitasking Environment

GNO is a UNIX-like software package for the Apple IIgs, which @@ -13,11 +19,11 @@ runs on top of the native operating system, GS/OS. This is master documentation site for GNO. It consists of the following sections:
    -
  1. Frequently Asked Questions -
  2. Reference Manuals -
  3. Manual Pages -
  4. GNO-Related Web Links -
  5. Old Documentation (August 1996 Revision for GNO v2.0.4) +
  6. Frequently Asked Questions +
  7. Reference Manuals +
  8. Manual Pages +
  9. GNO-Related Web Links +
  10. Old Documentation (August 1996 Revision for GNO v2.0.4)

@@ -38,305 +44,3 @@ files for that directory. If someone comes up to you on the street and offers you some Windows (95, NT) ... Just say GNO!

- -

- - -

Frequently Asked Questions (and Answers)

- - -The newsgroup comp.sys.apple2.gno 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 comp.sys.apple2.gno, and is also -available online. -

- -A summary of the most recent changes (typically since the previous -monthly posting) may be obtained from the (abbreviated) Change Log. -

- -The online html version of these documents may be found at: -

-

- -The text version of these documents are available via ftp at the -following locations: -

-

-

- - -

Reference Manuals

- - -These are based on Procyon's August 1996 v2.0.4 documents, but have -been updated and enhanced. 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. -

- -

Overview and Installation -
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: - -

- -

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

- - -

Note on A4 Paper Formats

- -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 -"build" process, it might result in less than desirable -output. Please email your observations to me at the address at -the bottom of this page. -

-

- - - -

Manual Pages

- - -This is the set of manual pages for the GNO base distribution. It does -not include manual pages for utilities and libraries that are considered -to be GNO "add-ons". -Note that these are for GNO v2.0.6, are under active development, and -are subject to change. -Some of the documented functions, programs, and files are not available -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. -

- -

-

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

-

- - -

GNO-Related Web Links

- - -The following links are also likely to be of interest to GNO users -and programmers. - - -

- -The following links have a less direct relevence to GNO, but may still -be useful: -

    -
  • The File System Hierarchy - "standard". This is not a true standard in the ANSI/ISO - sense, but still contains a lot of useful information. - NOTE: GNO is based on 4.4BSD which does not, at this - time, completely follow the suggested hierarchy. GNO sites - should use the hierarchy specified in the - FAQ. -
-
- - - -

Old Documentation

 - -

Reference Manuals (August 1996 Revision)

-These are the reference manuals that shipped with GNO v2.0.4, translated -into html source. -

- -

-

- -The original MS-Word versions of these documents are also available for -download via ftp: -

- -

Manual Pages (August 1996 Revision)

-There are also selected manual pages available. (Be sure to check the ones -installed on your system as well.) Unfortunately, this set of manual -pages is not divided along chapter boundries. -

- -

    -
  • Part 1 - Chapter 1: Commands and Applications - (intro(1) and binprint(1) to sum(1)) -
  • Part 2 - Chapter 1: Commands and Applications - (sz(1) to tar(1)) -
  • Part 3 -
      -
    • Chapter 1: Commands and Applications - (tee(1) to yes(1)) -
    • Chapter 2: System Calls - (alarm(2) to statfs(2)) -
    -
  • Part 4 -
      -
    • Chapter 2: System Calls - (truncate(2) to wait(2)) -
    • Chapter 3: Library Routines -
    • Chapter 4: Devices -
    -
-

- -The original MS-Word versions of these manual pages are also available for -download via ftp at - -%%FTP_ROOT%%/doc/refs/aug96/manpages.zip - -

-Devin Reade -gdr@trenco.gno.org -

- - -Apple II viewable page -
- - - - - diff --git a/doc/refs/kern.tex b/doc/refs/kern.tex index 88eefdc..911f4a5 100644 --- a/doc/refs/kern.tex +++ b/doc/refs/kern.tex @@ -1,7 +1,7 @@ % % GNO Kernel Reference Manual % -% $Id: kern.tex,v 1.3 1997/11/30 06:49:42 gdr Exp $ +% $Id: kern.tex,v 1.4 1998/02/19 03:03:56 gdr-ftp Exp $ % \documentclass{report} @@ -422,6 +422,12 @@ partitions (an arduous and problem-filled task). Named prefixes are handled by the GNO kernel in the same GS/OS calls described in Chapter 3 \bf Pathnames and Prefixes\rm. +The format of the /etc/namespace file can be found in the +\bf namespace\rm(5) manual page. + +Note that if you have a physical partition that matches the name of a +logical partition defined in the /etc/namespace file, then the physical +parition will not be visible while running GNO. \section{Open File Tracking} diff --git a/doc/refs/manindex.html b/doc/refs/manindex.html new file mode 100644 index 0000000..9079227 --- /dev/null +++ b/doc/refs/manindex.html @@ -0,0 +1,35 @@ +

GNO Manual Pages

+ +This is the set of manual pages for the GNO base distribution. It does +not include manual pages for utilities and libraries that are considered +to be GNO "add-ons". +Note that these are for GNO v2.0.6, are under active development, and +are subject to change. +Some of the documented functions, programs, and files are not available +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. +

+ +

+

+ +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. +

diff --git a/doc/refs/mkhtmlman b/doc/refs/mkhtmlman index b54f966..277fcfa 100755 --- a/doc/refs/mkhtmlman +++ b/doc/refs/mkhtmlman @@ -2,7 +2,7 @@ # # Devin Reade, November 1997. # -# $Id: mkhtmlman,v 1.6 1998/02/04 07:17:13 gdr-ftp Exp $ +# $Id: mkhtmlman,v 1.7 1998/02/19 03:04:05 gdr-ftp Exp $ man2html=/usr/local/bin/man2html TMPDIR=${TMPDIR:-/tmp} @@ -47,19 +47,31 @@ for section in 1 2 3 4 5 6 7 8; do | grep -v bin/gsh/updates1.1 \ | grep -v sed/tests` ; do [ "$F" = 00.DUMMY ] && continue; - if ! egrep -q -e '^\.TH.*GNO' $F; then - echo "$F:1: This does not appear to be a GNO manual page. Skipped." + if egrep -q -e '^'"$F"'$' ignored.pages; then + echo "$F: ignored" continue fi - f=`basename $F` - f2=`echo $f | perl -pe 's/\.[^\.]+$//;'` - echo "$f" >> $listfile + F_noG="$F" if [ -f $F'G' ]; then F="$F"G fi + macro='' + if ! egrep -q -e '^\.TH.*GNO' $F; then + if egrep -q -e '^\.Sh NAME' $F; then + echo "$F: Using the BSD-formatted man page." + macro=doc + else + echo "$F: This does not appear to be a GNO manual page." \ + "Skipped." + continue + fi + fi + f=`basename $F_noG` + f2=`echo $f | perl -pe 's/\.[^\.]+$//;'` + echo "$f" >> $listfile if ! ./newer $dest/$f.html $F; then echo "creating $dest/$f.html" - nroff -man $F | $man2html -nodepage | \ + nroff -man$macro $F | $man2html -nodepage | \ perl -p -e \ 's//GNO: '"$f2($section)"'<\/title><body bgcolor=\#ffffff>/;'\ > $dest/$f.html diff --git a/doc/refs/oldrefs.html b/doc/refs/oldrefs.html new file mode 100644 index 0000000..2ba1429 --- /dev/null +++ b/doc/refs/oldrefs.html @@ -0,0 +1,71 @@ +<h1>Old GNO Documentation</H1> + +<H3>Reference Manuals (August 1996 Revision)</H3> +These are the reference manuals that shipped with GNO v2.0.4, translated +into html source. +<p> + +<ul> +<li><A HREF="%%HTML_ROOT%%/docs.Aug96/install.html"> + Introduction and Installation</A> +<li><A HREF="%%HTML_ROOT%%/docs.Aug96/kernel.html"> + GNO Kernel Reference Manual</A> +<li>GNO Shell User's Manual, <A HREF="%%HTML_ROOT%%/docs.Aug96/gsh-12.html"> + Chapters 1 and 2</A> +<li>GNO Shell User's Manual, <A HREF="%%HTML_ROOT%%/docs.Aug96/gsh-3.html"> + Chapter 3</A> +<li>GNO Shell User's Manual, <A HREF="%%HTML_ROOT%%/docs.Aug96/gsh-4.html"> + Chapter 4</A> +<li>GNO Shell User's Manual, <A HREF="%%HTML_ROOT%%/docs.Aug96/gsh-5.html"> + Chapter 5 and Appendices</A> +</ul> +<p> + +The original MS-Word versions of these documents are also available for +download via ftp: +<ul> +<li>Introduction and Installation: + <A HREF="%%FTP_ROOT%%/doc/refs/aug96/install.zip"> + %%FTP_ROOT%%/doc/refs/aug96/install.zip</A> +<li>Kernel Reference Manual: + <A HREF="%%FTP_ROOT%%/doc/refs/aug96/kernel.zip"> + %%FTP_ROOT%%/doc/refs/aug96/kernel.zip</A> +<li>GNO Shell Reference Manual: + <A HREF="%%FTP_ROOT%%/doc/refs/aug96/gsh.zip"> + %%FTP_ROOT%%/doc/refs/aug96/gsh.zip</A> +</ul> + +<H3>Manual Pages (August 1996 Revision)</H3> +There are also selected manual pages available. (Be sure to check the ones +installed on your system as well.) Unfortunately, this set of manual +pages is not divided along chapter boundries. +<p> + +<ul> +<li><A HREF="%%HTML_ROOT%%/docs.Aug96/man1.html">Part 1</A> + Chapter 1: Commands and Applications + (<b>intro</b>(1) and <b>binprint</b>(1) to <b>sum</b>(1)) +<li><A HREF="%%HTML_ROOT%%/docs.Aug96/man2.html">Part 2</A> + Chapter 1: Commands and Applications + (<b>sz</b>(1) to <b>tar</b>(1)) +<li><A HREF="%%HTML_ROOT%%/docs.Aug96/man3.html">Part 3</A> + <ul> + <li>Chapter 1: Commands and Applications + (<b>tee</b>(1) to <b>yes</b>(1)) + <li>Chapter 2: System Calls + (<b>alarm</b>(2) to <b>statfs</b>(2)) + </ul> +<li><A HREF="%%HTML_ROOT%%/docs.Aug96/man4.html">Part 4</A> + <ul> + <li>Chapter 2: System Calls + (<b>truncate</b>(2) to <b>wait</b>(2)) + <li>Chapter 3: Library Routines + <li>Chapter 4: Devices + </ul> +</ul> +<p> + +The original MS-Word versions of these manual pages are also available for +download via ftp at +<A HREF="%%FTP_ROOT%%/doc/refs/aug96/manpages.zip"> +%%FTP_ROOT%%/doc/refs/aug96/manpages.zip</A> diff --git a/doc/refs/refs.html b/doc/refs/refs.html new file mode 100644 index 0000000..9c9f53c --- /dev/null +++ b/doc/refs/refs.html @@ -0,0 +1,88 @@ +<H1>GNO Reference Manuals</H1> + +These are based on Procyon's August 1996 v2.0.4 documents, but have +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>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 +"build" 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> + + diff --git a/doc/refs/related.html b/doc/refs/related.html new file mode 100644 index 0000000..d70beea --- /dev/null +++ b/doc/refs/related.html @@ -0,0 +1,41 @@ +<H1>GNO-Related Web Links</H1> + +The following links are also likely to be of interest to GNO users +and programmers. + +<ul> +<li>The <A HREF="http://www.gno.org/gno/describe"> + Describe Database</A> Page. This is a database containing information + on current GNO and ORCA/Shell utilities, including version numbers + and from where they can be obtained. +<li><A HREF="http://www.hypermall.com/companies/procyon"> + Procyon Enterprises Inc</A> +<li>Soenke Behrens' <A HREF="http://www.arrowweb.com/sbehrens/obugs.htm"> + ORCA/C Bug List</A> +<li>Leslie Barstow's + <A HREF="http://www.servtech.com/public/phoenix/computers/gno/index.html"> + GNO Utilities Page.</A> + (This is an sorted version of the <b>describe</b>(1) database.) +<li><A HREF="http://www.freebsd.org/handbook/handbook298.html"> + FreeBSD ftp site list</A> +<li><A HREF="http://www.Geeks.ORG/~taubert/gstcp/index.html"> + GS/TCP</A> +<li><A HREF="http://www.zip.com.au/~kashum/marinetti"> + Marinetti</A> +<li><A HREF="http://www.members.home.com/sheppy/ToolboxGS"> + Eric Shepherd's ToolBox Reference</A> +</ul> +<p> + +The following links have a less direct relevence to GNO, but may still +be useful: +<ul> +<li>The <A HREF="http://www.pathname.com/fhs">File System Hierarchy</A> + "standard". This is not a true standard in the ANSI/ISO + sense, but still contains a lot of useful information. + <b>NOTE:</b> <em>GNO is based on 4.4BSD which does not, at this + time, completely follow the suggested hierarchy. GNO sites + should use the hierarchy specified in the + <A HREF="%%FAQ%%">FAQ</A>. </em> +</ul> + diff --git a/doc/refs/tail.html b/doc/refs/tail.html new file mode 100644 index 0000000..525be28 --- /dev/null +++ b/doc/refs/tail.html @@ -0,0 +1,12 @@ +<hr> + +<A HREF="http://www.visi.com/~nathan/a2/a2viewable.html"> +<img alt="Apple II Viewable Page" height=31 width=88 border="0" +src="%%GIFDIR%%/a2viewable.gif" align=right></A> +Devin Reade +<br> +<A HREF="mailto:gdr@trenco.gno.org">gdr@trenco.gno.org</A> +<p> + +</body> +</html> diff --git a/doc/refs/unaval.html b/doc/refs/unaval.html index 925820f..7a65cd7 100644 --- a/doc/refs/unaval.html +++ b/doc/refs/unaval.html @@ -1,8 +1,3 @@ -<html> -<head> -<title>Unpublished Document - -

GNO Online Documentation

@@ -10,6 +5,3 @@ The document you requested has not yet been released. Please be patient; updating the GNO documentation takes time.

-

-Devin Reade -<gdr@trenco.gno.org>.