mirror of
https://github.com/GnoConsortium/gno-docs.git
synced 2024-12-14 04:31:18 +00:00
added pages for bug reporting, downloads, and related links
This commit is contained in:
Devin Reade
parent
d66eeac100
commit
3e6bac2857
@ -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
83
bugs.html
Normal 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 "current"</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
77
download.html
Normal 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" -->
|
||||
35
index.html
35
index.html
@ -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
42
related.html
Normal 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>
|
||||
"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>
|
||||
|
||||
<!-- ################################################### -->
|
||||
<!--#include virtual="/gno2/tail.html" -->
|
||||
Loading…
Reference in New Issue
Block a user