gno/doc/refs/index.html

328 lines
10 KiB
HTML

<html>
<head>
<title>GNO Master Documentation Page</title>
</head>
<body bgcolor=#ffffff>
<H1>The GNO Multitasking Environment</H1>
GNO is a UNIX-like software package for the Apple IIgs, which
runs on top of the native operating system, GS/OS.
<p>
This is master documentation site for GNO.
It consists of the following sections:
<ol>
<li><A HREF="#faq">Frequently Asked Questions</A>
<li><A HREF="#refs">Reference Manuals</A>
<li><A HREF="#man">Manual Pages</A>
<li><A HREF="#related">GNO-Related Web Links</A>
<li><A HREF="#old">Old Documentation (August 1996 Revision for GNO v2.0.4)</A>
</ol>
<p>
<b>Remember</b>:
<br>
If someone comes up to you on the street and offers you some
Windows&nbsp;(95,&nbsp;NT) ... <em>Just&nbsp;say&nbsp;GNO!</em>
<p>
<hr>
<A NAME="faq">
<H2>Frequently Asked Questions (and Answers)</H2>
</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>
<A NAME="refs">
<H2>Reference Manuals</H2>
</A>
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
&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>
<A NAME="man">
<H2>Manual Pages</H2>
</A>
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".
<em>Note that these are for GNO v2.0.6, are under active development, and
are subject to change.</em>
Some of the documented functions, programs, and files are not available
for GNO v2.0.4.
<p>
Each of the chapters has an introductory page, titled <b>intro</b>.
For a brief introduction to the manual pages in general, see the
<A HREF="%%HTML_ROOT%%/man/man1/intro.1.html">Introduction to Chapter 1</A>.
<p>
<ul>
<li><A HREF="%%HTML_ROOT%%/man/man1/00.index.html">Chapter 1</A>
Commands and Applications
<li><A HREF="%%HTML_ROOT%%/man/man2/00.index.html">Chapter 2</A> System Calls
<li><A HREF="%%HTML_ROOT%%/man/man3/00.index.html">Chapter 3</A>
Library Routines
<li><A HREF="%%HTML_ROOT%%/man/man4/00.index.html">Chapter 4</A> Devices
<li><A HREF="%%HTML_ROOT%%/man/man5/00.index.html">Chapter 5</A> File Formats
<li><A HREF="%%HTML_ROOT%%/man/man6/00.index.html">Chapter 6</A> Games
<li><A HREF="%%HTML_ROOT%%/man/man7/00.index.html">Chapter 7</A> Miscellaneous
<li><A HREF="%%HTML_ROOT%%/man/man8/00.index.html">Chapter 8</A>
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">
<H2>GNO-Related Web Links</H2>
</A>
The following links are also likely to be of interest to GNO users
and programmers.
<ul>
<li><A HREF="http://www.hypermall.com/companies/procyon">
Procyon Enterprises Inc</A>
<li><A HREF="http://www.arrowweb.com/sbehrens/obugs.htm">
Soenke Behrens' ORCA/C Bug List</A>
<li><A HREF="http://www.arrowweb.com/sbehrens/describe.htm">
Soenke Behrens' online describe(1) database</A>
<li><A HREF="http://www.servtech.com/public/phoenix/computers/gno/index.html">
Leslie Barstow's 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>
&quot;standard&quot;. 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>
<hr>
<A NAME="old">
<h2>Old Documentation</H2></A>
<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>
<hr>
Devin Reade
<A HREF="mailto:gdr@eddore.myrias.com">gdr@eddore.myrias.com</A>
<p>
<A HREF="http://www.visi.com/~nathan/a2/a2viewable.html">
<img alt="Apple II viewable page" height=31 width=88
src="%%GIFDIR%%/a2viewable.gif"></A>
<br>
</body>
</html>