mirror of
https://github.com/GnoConsortium/gno.git
synced 2024-06-11 09:29:27 +00:00
intro.tex:
- correct name of GS-ShrinkIt - mention that spaces cannot be used in pathnames in the /etc/namespace file - fixed some formatting problems where words were run together when switching from boldface or italic back to roman type - updated disk space requirements for v2.0.6 - be more explicit in "extracting and installing [v2.0.6]" about the destination volume names and requirements - some changes of awkward text
This commit is contained in:
parent
5c5d7e8ed2
commit
f2f24b8623
|
@ -1,7 +1,7 @@
|
||||||
%
|
%
|
||||||
% GNO Overview
|
% GNO Overview
|
||||||
%
|
%
|
||||||
% $Id: intro.tex,v 1.10 1999/01/26 07:30:14 gdr-ftp Exp $
|
% $Id: intro.tex,v 1.11 1999/01/27 06:35:42 gdr-ftp Exp $
|
||||||
%
|
%
|
||||||
|
|
||||||
\documentclass{report}
|
\documentclass{report}
|
||||||
|
@ -263,7 +263,7 @@ to choose files by ``wildcard'' has been around for a while, but
|
||||||
the GNO Shell takes this to a new level with ``regular
|
the GNO Shell takes this to a new level with ``regular
|
||||||
expressions'', a very powerful yet simple programming language.
|
expressions'', a very powerful yet simple programming language.
|
||||||
Other benefits of the GNO shell are too numerous to mention. (see
|
Other benefits of the GNO shell are too numerous to mention. (see
|
||||||
the \bf GNO Shell User's Manual \rm for details).
|
the \bf GNO Shell User's Manual \rm for details).
|
||||||
|
|
||||||
In addition to being compatible with the
|
In addition to being compatible with the
|
||||||
ORCA system, GNO/ME is a very powerful programming environment.
|
ORCA system, GNO/ME is a very powerful programming environment.
|
||||||
|
@ -331,7 +331,7 @@ the kernel, which is the heart of GNO. It is intended mainly for programmers.
|
||||||
|
|
||||||
The ``Manual Pages'' are the traditional form of UNIX documentation.
|
The ``Manual Pages'' are the traditional form of UNIX documentation.
|
||||||
They are normally viewed on your GS by typing ``man \it subject\rm'',
|
They are normally viewed on your GS by typing ``man \it subject\rm'',
|
||||||
where \it subject \rm is the name of the command, library routine, file
|
where \it subject \rm is the name of the command, library routine, file
|
||||||
(and so forth) for which you are trying to obtain information.
|
(and so forth) for which you are trying to obtain information.
|
||||||
Man pages are provided for the \manpages{base distribution}, and are
|
Man pages are provided for the \manpages{base distribution}, and are
|
||||||
usually provided by authors of third-party programs. Type ``man man''
|
usually provided by authors of third-party programs. Type ``man man''
|
||||||
|
@ -356,7 +356,7 @@ memory and a hard drive.
|
||||||
You should have at least 5 MegaBytes of hard disk space free for GNO
|
You should have at least 5 MegaBytes of hard disk space free for GNO
|
||||||
v2.0.4.
|
v2.0.4.
|
||||||
|
|
||||||
GNO version 2.0.6 is \em much \rm larger than previous versions.
|
GNO version 2.0.6 is \em much \rm larger than previous versions.
|
||||||
Even if you are only installing v2.0.4 at this time, it is recommended
|
Even if you are only installing v2.0.4 at this time, it is recommended
|
||||||
that you reserve at least one 32-megabyte ProDOS partition for
|
that you reserve at least one 32-megabyte ProDOS partition for
|
||||||
GNO-specific files.
|
GNO-specific files.
|
||||||
|
@ -529,7 +529,7 @@ many man-years of effort, huge amounts of money, and a lot of grief on the
|
||||||
part of the developers.
|
part of the developers.
|
||||||
For example, the Byte Works' ORCA languages and development
|
For example, the Byte Works' ORCA languages and development
|
||||||
environment (as of November 1997) consists of over 220,000 lines
|
environment (as of November 1997) consists of over 220,000 lines
|
||||||
of source code, \em not \rm including the libraries, tool
|
of source code, \em not \rm including the libraries, tool
|
||||||
interface files, test programs, samples, or the 5 800k disks
|
interface files, test programs, samples, or the 5 800k disks
|
||||||
of source in the courses for each language. This work represents
|
of source in the courses for each language. This work represents
|
||||||
approximately 17 man-years of development, support, marketing,
|
approximately 17 man-years of development, support, marketing,
|
||||||
|
@ -859,7 +859,7 @@ same partition \texttt{GNO.Disk1} is on.
|
||||||
GNO versions 2.0.2 through 2.0.4 were distributed as sequential
|
GNO versions 2.0.2 through 2.0.4 were distributed as sequential
|
||||||
updates to version 2.0.1, rather than as complete distributions.
|
updates to version 2.0.1, rather than as complete distributions.
|
||||||
Consequently, you should install each of the version 2.0.2,
|
Consequently, you should install each of the version 2.0.2,
|
||||||
2.0.3, and 2.0.4 distributions, \em in sequence, \rm over top of your
|
2.0.3, and 2.0.4 distributions, \em in sequence, \rm over top of your
|
||||||
version 2.0.1 distribution.
|
version 2.0.1 distribution.
|
||||||
|
|
||||||
You should also obtain and install the Multi-User Update.
|
You should also obtain and install the Multi-User Update.
|
||||||
|
@ -980,8 +980,8 @@ them to Devin Reade.\rm
|
||||||
|
|
||||||
This chapter contains information on how to install the newest version
|
This chapter contains information on how to install the newest version
|
||||||
of GNO, which is version 2.0.6 or later. It explains how to install
|
of GNO, which is version 2.0.6 or later. It explains how to install
|
||||||
the base \em binary\rm distribution. Installation of GNO sources such that
|
the base \em binary\rm distribution. Installation of GNO sources such that
|
||||||
you are able to \em build \rm the base distribution itself are at this
|
you are able to \em build \rm the base distribution itself are at this
|
||||||
time beyond the scope of this document.
|
time beyond the scope of this document.
|
||||||
|
|
||||||
At this time, unfortunately, installing GNO is fairly cumbersome.
|
At this time, unfortunately, installing GNO is fairly cumbersome.
|
||||||
|
@ -996,36 +996,43 @@ prior to doing a new installation.
|
||||||
|
|
||||||
\section{Planning Your System}
|
\section{Planning Your System}
|
||||||
|
|
||||||
The install scripts assumes that your \em new\rm distribution will be installed
|
The install scripts assumes that your \em new\rm distribution will be
|
||||||
on to the two volumes \bf /gno \rm (ProDOS) and \bf /gno-hfs \rm (HFS
|
installed on to the two volumes \bf /gno \rm (ProDOS) and \bf /gno-hfs \rm
|
||||||
or AppleShare).
|
(HFS or AppleShare).
|
||||||
It also assumes these volumes already exist and are \em empty\rm.
|
It also assumes these volumes already exist and are \em empty\rm.
|
||||||
You may use other volume names,
|
You may use other volume names,
|
||||||
but you will have to edit certain files before you run your distribution.
|
but you will have to edit certain files before you run your distribution.
|
||||||
|
|
||||||
|
You will need \it at least\rm the following amount of disk space.
|
||||||
|
It is recommended that you dedicate an entire 32Meg ProDOS partition to
|
||||||
|
GNO.
|
||||||
|
|
||||||
\begin{tabular}{ll}
|
\begin{tabular}{ll}
|
||||||
boot disk (used only for installation) & 800k \\
|
boot disk (used only for installation) & 800k \\
|
||||||
binary distribution (shk files) & 4.6 MB \\
|
binary distribution (shk files) & 5.3 MB \\
|
||||||
binary distribution (extracted) & 12.1 MB \\
|
binary distribution (extracted) & 12.0 MB \\
|
||||||
complete GNO source & 15.0 MB \\
|
complete GNO source (optional) & 15.0 MB \\
|
||||||
\end{tabular}
|
\end{tabular}
|
||||||
|
|
||||||
Before you start, you should also ensure that your system meets the
|
Before you start, you should also ensure that your system meets the
|
||||||
minimum hardware requirements, as documented in \bf Overview\rm.
|
minimum hardware requirements, as documented in \bf Overview\rm.
|
||||||
|
|
||||||
In order to install GNO, you will need some way to download the NuFX
|
In order to install GNO, you will need some way to download the NuFX
|
||||||
archive files to your GS. You will also need GShrinkIt, which is available
|
archive files to your GS. You will also need GS-ShrinkIt, which is available
|
||||||
from
|
from
|
||||||
\hturl{ftp://ftp.gno.org/pub/apple2/gs.specific/archivers/gshk11.bsc}.
|
\hturl{ftp://ftp.gno.org/pub/apple2/gs.specific/archivers/gshk11.bsc}.
|
||||||
|
|
||||||
Part of the GNO installation still requires use of a text editor. The
|
Part of the GNO installation still requires use of a text editor. The
|
||||||
GNO boot disk ships with \bf vi\rm installed;
|
GNO boot disk ships with \bf vi\rm installed;
|
||||||
if you do not know how to use \bf vi\rm (or you need a refresher), see
|
if you do not know how to use \bf vi\rm (or you need a refresher), see
|
||||||
\hturl{http://www.jaws.umn.edu/~tobkin/vi}
|
\hturl{http://www.jaws.umn.edu/~tobkin/vi}
|
||||||
for a good tutorial and quick reference guide.
|
for a good tutorial and quick reference guide.
|
||||||
|
|
||||||
\section{Downloading and Extracting the Binary Distribution}
|
\section{Downloading and Extracting the Binary Distribution}
|
||||||
|
|
||||||
|
If you have not yet read the section on \it Planning Your System\rm,
|
||||||
|
please do so now.
|
||||||
|
|
||||||
Your first step is of course to download the distribution.
|
Your first step is of course to download the distribution.
|
||||||
The distribution is available from
|
The distribution is available from
|
||||||
\hturl{ftp://ftp.gno.org/pub/apple2/gs.specific/gno/base}.
|
\hturl{ftp://ftp.gno.org/pub/apple2/gs.specific/gno/base}.
|
||||||
|
@ -1056,11 +1063,20 @@ Note that Appleshare volumes may be used in lieu of HFS volumes.
|
||||||
|
|
||||||
\end{itemize}
|
\end{itemize}
|
||||||
|
|
||||||
Next, using GShrinkIt or a similar program, extract the contents of the
|
Using the Finder or a similar program, ensure that you have an empty ProDOS
|
||||||
|
partition \bf /gno \rm, and an HFS or AppleShare partition online. The
|
||||||
|
former \em may \rm be named something else, but note the instructions
|
||||||
|
below for handling this situation. The latter is assumed to be called
|
||||||
|
\bf /gno-hfs \rm (modify the following instructions accordingly), and
|
||||||
|
need not be otherwise empty. The two subdirectories \bf HFSinclude \rm
|
||||||
|
and \bf man \rm will be created on \bf /gno-hfs \rm during the installation
|
||||||
|
process.
|
||||||
|
|
||||||
|
Next, using GS-ShrinkIt or a similar program, extract the contents of the
|
||||||
file gnoboot.shk onto an 800k floppy named \bf gno.boot\rm.
|
file gnoboot.shk onto an 800k floppy named \bf gno.boot\rm.
|
||||||
The name of the floppy is critical. While you may use a hard drive
|
The name of the floppy is critical. While you may use a hard drive
|
||||||
partition for \bf gno.boot\rm, this is likely a waste of hard drive space
|
partition for \bf gno.boot\rm, this is likely a waste of hard drive space
|
||||||
since \bf gno.boot\rm will only be used while installing GNO, not while
|
since \bf gno.boot\rm will only be used while installing GNO, not while
|
||||||
running it.
|
running it.
|
||||||
|
|
||||||
It should also be possible to use a RAM disk for \bf gno.boot\rm, but
|
It should also be possible to use a RAM disk for \bf gno.boot\rm, but
|
||||||
|
@ -1095,7 +1111,7 @@ shell session.
|
||||||
|
|
||||||
Note that the boot disk currently uses the version 2.0.4 GNO kernel; this
|
Note that the boot disk currently uses the version 2.0.4 GNO kernel; this
|
||||||
is a temporary measure due to a bug with using newer kernels in single user
|
is a temporary measure due to a bug with using newer kernels in single user
|
||||||
mode. When GNO gets installed to your hard drive, you will have a newer
|
mode. When GNO is installed on your hard drive, you will have a newer
|
||||||
kernel.
|
kernel.
|
||||||
|
|
||||||
\item
|
\item
|
||||||
|
@ -1107,9 +1123,9 @@ the other set.
|
||||||
%% README.install-start
|
%% README.install-start
|
||||||
\item
|
\item
|
||||||
Set your DOWNLOAD\_DIR environment variable to the directory
|
Set your DOWNLOAD\_DIR environment variable to the directory
|
||||||
into which you placed the above NuFX (*.shk) files. For example,
|
into which you placed the base distribution NuFX archive files
|
||||||
if the files gnohfs.shk, gno.01.shk, gno.02.shk (and so forth)
|
(gnoboot.shk, gnohfs.shk, gno.01.shk, and so forth).
|
||||||
were in /download, you would type:
|
For example, if the NuFX files were in /download, you would type:
|
||||||
|
|
||||||
\begin{verbatim}
|
\begin{verbatim}
|
||||||
setenv DOWNLOAD_DIR /download
|
setenv DOWNLOAD_DIR /download
|
||||||
|
@ -1162,7 +1178,9 @@ path. Similarily, you will have to replace ``:gno-hfs:'' if
|
||||||
that is not the name of your HFS (or Appleshare) partition
|
that is not the name of your HFS (or Appleshare) partition
|
||||||
where you ran the
|
where you ran the
|
||||||
installboot2
|
installboot2
|
||||||
script.
|
script. Note that you cannot currently use pathnames in the
|
||||||
|
namespace
|
||||||
|
file that contain spaces.
|
||||||
|
|
||||||
The
|
The
|
||||||
gno.boot
|
gno.boot
|
||||||
|
|
Loading…
Reference in New Issue
Block a user