mirror of
https://github.com/GnoConsortium/gno.git
synced 2024-12-21 23:29:16 +00:00
4f4a589bf7
- changed occurances from trenco.myrias.com to either ftp.gno.org or www.gno.org, as appropriate index.html: - make reference to post-v2.0.4 patches avail from ftp.gno.org - deleted reference to Soenke's describe database (obsolete), replaced it with ref to the hosted by www.gno.org mkhtmlman: - fixed bug where a non-man-page file was picked up by this script out of the gsh source directory. - man pages may appear now as both name.n and name.nG, where the "n" is the section number. If both files appear, then the former is BSD-formatted source and the latter is GNO-formatted source. Make sure we're only picking up the latter.
343 lines
11 KiB
HTML
343 lines
11 KiB
HTML
<html>
|
|
<head>
|
|
<title>GNO 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>NEW!</b>
|
|
A set of updated libraries, header files, and manual pages are available
|
|
for anyone who is trying to use ORCA/C v2.1.x with either GNO v2.0.4.
|
|
See
|
|
<A HREF="http://www.gno.org/pub/apple2/gs.specific/gno/base206">
|
|
http://www.gno.org/pub/apple2/gs.specific/gno/base206</A>
|
|
for details, or the same directory via anonymous ftp from
|
|
<b>ftp.gno.org</b>. Ensure you read the README file. There may be
|
|
more than one update in that directory, so ensure you read the index
|
|
files for that directory.
|
|
<p>
|
|
|
|
<b>Remember</b>:
|
|
<br>
|
|
If someone comes up to you on the street and offers you some
|
|
Windows (95, NT) ... <em>Just say 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
|
|
"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>
|
|
<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>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>
|
|
<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@trenco.gno.org">gdr@trenco.gno.org</A>
|
|
<p>
|
|
|
|
<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"></A>
|
|
<br>
|
|
|
|
|
|
|
|
</body>
|
|
</html>
|