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:
gdr-ftp 1999-01-27 06:35:42 +00:00
parent 5c5d7e8ed2
commit f2f24b8623
1 changed files with 42 additions and 24 deletions

View File

@ -1,7 +1,7 @@
%
% 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}
@ -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
expressions'', a very powerful yet simple programming language.
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
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.
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.
Man pages are provided for the \manpages{base distribution}, and are
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
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
that you reserve at least one 32-megabyte ProDOS partition for
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.
For example, the Byte Works' ORCA languages and development
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
of source in the courses for each language. This work represents
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
updates to version 2.0.1, rather than as complete distributions.
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.
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
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
you are able to \em build \rm the base distribution itself are at this
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
time beyond the scope of this document.
At this time, unfortunately, installing GNO is fairly cumbersome.
@ -996,36 +996,43 @@ prior to doing a new installation.
\section{Planning Your System}
The install scripts assumes that your \em new\rm distribution will be installed
on to the two volumes \bf /gno \rm (ProDOS) and \bf /gno-hfs \rm (HFS
or AppleShare).
The install scripts assumes that your \em new\rm distribution will be
installed on to the two volumes \bf /gno \rm (ProDOS) and \bf /gno-hfs \rm
(HFS or AppleShare).
It also assumes these volumes already exist and are \em empty\rm.
You may use other volume names,
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}
boot disk (used only for installation) & 800k \\
binary distribution (shk files) & 4.6 MB \\
binary distribution (extracted) & 12.1 MB \\
complete GNO source & 15.0 MB \\
binary distribution (shk files) & 5.3 MB \\
binary distribution (extracted) & 12.0 MB \\
complete GNO source (optional) & 15.0 MB \\
\end{tabular}
Before you start, you should also ensure that your system meets the
minimum hardware requirements, as documented in \bf Overview\rm.
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
\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
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
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
\hturl{http://www.jaws.umn.edu/~tobkin/vi}
for a good tutorial and quick reference guide.
\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.
The distribution is available from
\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}
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.
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
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.
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
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.
\item
@ -1107,9 +1123,9 @@ the other set.
%% README.install-start
\item
Set your DOWNLOAD\_DIR environment variable to the directory
into which you placed the above NuFX (*.shk) files. For example,
if the files gnohfs.shk, gno.01.shk, gno.02.shk (and so forth)
were in /download, you would type:
into which you placed the base distribution NuFX archive files
(gnoboot.shk, gnohfs.shk, gno.01.shk, and so forth).
For example, if the NuFX files were in /download, you would type:
\begin{verbatim}
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
where you ran the
installboot2
script.
script. Note that you cannot currently use pathnames in the
namespace
file that contain spaces.
The
gno.boot