mirror of
https://github.com/GnoConsortium/gno.git
synced 2024-10-31 11:07:44 +00:00
32a9a4f966
- more changes mirrored from intro.tex
105 lines
4.5 KiB
Plaintext
105 lines
4.5 KiB
Plaintext
$Id: README.install,v 1.5 1999/01/29 07:13:09 gdr-ftp Exp $
|
|
|
|
The install scripts assumes that your _new_ distribution will be installed
|
|
on to the two volumes /gno (ProDOS) and /gno-hfs (HFS). It also assumes
|
|
these volumes already exist and are _empty_. You may use other volume names,
|
|
but you will have to edit certain files before you run your distribution.
|
|
If your volumes are named something else, replace the names in the cd commands
|
|
below with the appropriate name.
|
|
|
|
You should now do the following steps:
|
|
1. Set your DOWNLOAD_DIR environment variable to the directory
|
|
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:
|
|
|
|
setenv DOWNLOAD_DIR /download
|
|
|
|
Ensure that you use slashes ("/") rather than colons (":") as the
|
|
pathname delimiter. Do not use a trailing slash.
|
|
|
|
2. Install the majority of the GNO base distribution files by
|
|
changing directory into your destination directory and running
|
|
the installboot1 script. Assuming that you will be installing
|
|
to the partition /gno, the commands would be:
|
|
|
|
cd /gno
|
|
/gno.boot/installboot1
|
|
|
|
This step takes quite a while, even with an accelerated IIgs.
|
|
Have patience.
|
|
|
|
3. There are a small number of recommended files that do not follow
|
|
ProDOS naming conventions. If you wish to install these files,
|
|
make sure that you have an HFS or Appleshare disk online. Change
|
|
directories to that disk (or subdirectory) and run installboot2.
|
|
Assuming that the HFS disk is /gno-hfs, the commands are:
|
|
|
|
cd /gno-hfs
|
|
/gno.boot/installboot2
|
|
|
|
This step is optional. It is possible to use the GNO binary
|
|
distribution without an HFS partition, but some information
|
|
will be missing.
|
|
|
|
4. You should now edit the file /gno/etc/namespace. If your
|
|
files were extracted onto a volume other than /gno, you will
|
|
have to replace all the ":gno:" strings with the appropriate
|
|
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. Note that you cannot
|
|
currently use pathnames in the namespace file that contain spaces.
|
|
|
|
The gno.boot disk includes the vi utility to do these edits.
|
|
You can also edit the namespace file with any other text editor
|
|
of your choosing, as long as it is done before you try to run
|
|
your new GNO distribution.
|
|
|
|
A vi tutorial and quick reference guide may be found at
|
|
http://www.jaws.umn.edu/~tobkin/vi.
|
|
|
|
See the kernel reference manual for a description of the
|
|
namespace file.
|
|
|
|
5. During the extraction process, the following files were placed
|
|
into the /gno/System directory:
|
|
|
|
/gno/System/Desk.Accs/GNOSnooperII
|
|
/gno/System/Desk.Accs/SuspDA
|
|
/gno/System/Drivers/FilePort
|
|
/gno/System/Drivers/FilePort.Data
|
|
/gno/System/Drivers/NullPort
|
|
/gno/System/System.Setup/GNOBug
|
|
/gno/System/System.Setup/SIM
|
|
|
|
It is recommended that these files be copied into the relevent
|
|
directories in the System folder of your boot partition. The
|
|
GNOBug PIF is only required if you have GSBug installed. If
|
|
you install GNOBug you should afterward sort the System.Setup
|
|
directory so that GNOBug appears before GSBug (the latter of
|
|
which is commonly called "debug.init").
|
|
|
|
6. If you are not short of disk space, you should create .so links
|
|
for your manual pages. (See the mkso(8) man page for an
|
|
explanation.) You can do this by executing the following
|
|
commands:
|
|
|
|
cd /gno/usr/man
|
|
mkso -v -H /gno-hfs/man mkso.data
|
|
|
|
If you installed GNO somewhere other than /gno and /gno-hfs, then
|
|
edit the above lines accordingly. If you did not install files
|
|
onto an HFS (or Appleshare) partition at all, then execute the
|
|
following commands instead:
|
|
|
|
cd /gno/usr/man
|
|
mkso -v mkso.data
|
|
|
|
7. You can now return to your program launcher (the Finder,
|
|
ProSEL-16, or whatever you used to start /gno.boot/kern) by
|
|
typing "exit" at the prompt. To startup up your new version
|
|
of GNO, you should then launch /gno/kern. You will then see
|
|
a "login:" prompt. Enter "root" as the user name; you will
|
|
not yet need a password.
|
|
|