added pages for bug reporting, downloads, and related links

This commit is contained in:
Devin Reade 2012-09-08 22:30:02 -06:00
parent d66eeac100
commit 3e6bac2857
5 changed files with 239 additions and 1 deletions

View File

@ -11,6 +11,9 @@ DYNAMIC_TARGETS = $(WEB_HOME)/head.html \
$(WEB_HOME)/refs.html \
$(WEB_HOME)/manindex.html \
$(WEB_HOME)/faqindex.html \
$(WEB_HOME)/related.html \
$(WEB_HOME)/bugs.html \
$(WEB_HOME)/download.html \
$(WEB_HOME)/oldnews.html
STATIC_TARGETS =

83
bugs.html Normal file
View File

@ -0,0 +1,83 @@
<!--#include virtual="/gno2/head.html" -->
<!-- ################################################### -->
<h2>GNO Bug Reports</h2>
<p>
If you wish to report a defect or suggest an enhancement, please
use the
<a href="https://bugzilla.gno.org">GNO Bugzilla</a>.
</p>
<p>
Before you file a bug report, please ensure that it is actually
a defect in GNO. The bug tracker is <em>NOT</em> a general support
mechanism, such as if you're having problems trying to figure out
how to do a particular task.
</p>
<p>
Second, having concluded that what you have is actually a bug (or
enhancement request), please
<a href="https://bugzilla.gno.org">search bugzilla</a>
to ensure that it has not already been reported (or suggested).
Note that <em>there is more than one product supported by
<b>bugzilla.gno.org</b></em>. Ensure that you are filing
bugs under GNO itself and not one of the other products hosted
by the GNO Consortium.
</p>
<p>
Be aware that the GNO Bugzilla uses self signed certificates.
If you're getting warnings from your browser about the certificates,
<a href="http://lists.gno.org/self-signed.html">help is available</a>
(just note that the site name is for <b>https://bugzilla.gno.org</b>
as opposed to <b>https://lists.gno.org</b>).
</p>
<h3>Writing an Effective Bug Report</h3>
<p>
For an excellent article on submitting bug or defect reports in
general (that is, for any software product), please see Simon
Tatham's
<a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">
How to Report Bugs Effectively</a>.
</p>
<p>
For GNO in particular, please ensure that for bug reports you're
reporting at least the following information:
<ul>
<li>A summary of the problem.</li>
<li>A detailed description of the problem.</li>
<li>Instructions on how to produce the problem.</li>
<li>With which distribution did you observe the problem? If it is a released
version, report the GNO version (eg: v2.0.6). If it is with something
that is based on current code you built from the source repository,
report the version as &quot;current&quot;</li>
<li>Which component is affected? The actual list is configured in
bugzilla, however it will be something like the following:
<ul>
<li>Documentation
<li>Utilities
<li>The GNO Shell
<li>The Kernel
<li>Libraries and Header Files
</ul>
</li>
<li>If you are reporting a problem with a utility or library routine,
include the name of the utility (or routine). If it's available,
also quote the version. This is often given as an rVersion
resource on programs and libraries.</li>
<li>If your problem is with a library routine, give a <em>short</em>
program which exhibits the problem.</li>
<li>You can attach supporting documents, source files, etc as attachments
in bugzilla.</li>
</ul>
</p>
<!-- ################################################### -->
<!--#include virtual="/gno2/tail.html" -->

77
download.html Normal file
View File

@ -0,0 +1,77 @@
<!--#include virtual="/gno2/head.html" -->
<!-- ################################################### -->
<h2>Obtaining GNO/ME</h2>
<h3>Canonical Image Download</h3>
<p>
GNO is available at
<a href="ftp://ftp.gno.org/pub/apple2/gs.specific/gno/base/">
ftp://ftp.gno.org/pub/apple2/gs.specific/gno/base/</a>
</p>
<p>
The current release of GNO/ME is version 2.0.6.
It does not include networking support.
Installation instructions for these images is available in the
<a href="refs.html#install">Overview and Installation</a> manual.
</p>
<h3>Source</h3>
<p>
GNO source is now available on
<a href="https://github.com">GitHub</a> under the
<a href="https://github.com/organizations/GnoConsortium">
GNO Consortium</a>
organization. The currently available repositories related
to GNO/ME proper (as opposed to other projects) are:
<dl>
<dt><a href="https://github.com/GnoConsortium/gno">GNO Core</a></dt>
<dd>
<p>
This is the repository from which GNO/ME itself is built on an
Apple IIgs. You only need this if you're planning on building
GNO from source, not merely using it.
</p>
<p>
The build requirements are somewhat complex (including
a related support infrastructure). You will also need licensed
versions of both Byteworks' ORCA/C and ORCA/M, available from
<a href="http://syndicomm.com/apple2/">Syndicomm</a>.
</p>
<p>
Detailed build instructions are in the process of being written,
as of 03 Sep 2012.
</p>
</dd>
<dt><a href="https://github.com/GnoConsortium/gno-docs">GNO Documentation</a></dt>
<dd>
<p>
This repository contains GNO-related documentation such as references
manuals, the FAQ, etc.
</p>
<p>
The source in this repository does not build
on the IIgs; it is intended to build on a UNIX or UNIX-like environment
as described in the
<a href="https://github.com/GnoConsortium/gno-docs/blob/master/README.build">README.build</a>
file.
</p>
</dd>
</dl>
</p>
<p>
If you would like to receive email whenever commits occur for
GNO/ME-related sources, you can subscribe to
<a href="https://lists.gno.org/mailman/listinfo/gno-commits">gno-commits</a>.
(That site uses self-signed certificates. If you don't know how to deal
with your browser warnings from self-signed certificates,
<a href="http://lists.gno.org/self-signed.html">help is available</a>).
</p>
<!-- ################################################### -->
<!--#include virtual="/gno2/tail.html" -->

View File

@ -5,11 +5,44 @@
<h2 align="center">The GNO Multitasking Environment</h2>
<p align="center">
GNO is a UNIX-like software package for the Apple IIgs, which
GNO is a UNIX-like environment for the Apple IIgs, which
runs on top of the native operating system, GS/OS.
</p>
<h2>Getting GNO</h2>
<p>
GNO is available as a set of installation files or as source
as described on the
<a href="download.html">download page</a>.
If you are new to GNO, it is strongly recommended that you
install from the images.
</p>
<h2>Getting Help</h2>
<p>
The GNO documentation is available on this site as
<a href="refs.html">Reference Manuals</a>,
<a href="manindex.html">Manual Pages</a>,
and the
<a href="faqindex.html">FAQ</a>.
</p>
<p>
The
<a href="https://lists.gno.org/mailman/listinfo/gno-devel">gno-devel</a>
mailing list is available for discussions around developing software
to run under GNO and development of GNO itself.
</p>
<p>
There is also a list of
<a href="related.html">related web pages</a>
(off-site).
</p>
<hr/>
<h2>News</h2>

42
related.html Normal file
View File

@ -0,0 +1,42 @@
<!--#include virtual="/gno2/head.html" -->
<!-- ################################################### -->
<h2>GNO-Related Web Links</h2>
The following links are also likely to be of interest to GNO users
and programmers.
<ul>
<li>The <A HREF="/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><A HREF="http://www.byteworks.us">The Byte Works</A>,
creators of ORCA/C, ORCA/M, and other programming tools.
(See their <a href="http://www.byteworks.us/Byte_Works/Morgue.html">
morgue</a> for the Apple II related things.)
<li>Soenke Behrens' <A HREF="http://warshaft.com/obugs.htm">
ORCA/C Bug List</A>
<li><A HREF="http://www.geeks.org/~taubert/gstcp/index.html">
GS/TCP</A>
<li><A HREF="http://www.apple2.org/marinetti/">Marinetti</A>
</ul>
<p>
The following links have a less direct relevance 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>
<!-- ################################################### -->
<!--#include virtual="/gno2/tail.html" -->