Apple-2gs-SW/gno
1
0
Fork 0
mirror of https://github.com/GnoConsortium/gno.git synced 2025-02-01 07:31:11 +00:00
Code Issues Projects Releases Wiki Activity

Makefile, intro.tex, mknotes:

Browse Source 
The file ../../verbatim/boot/README.install is now partially
	generated from intro.tex via the mknotes script.

intro.tex:
	- expanded and corrected v2.0.6 installation notes
	- translated " --> '' (TeX style)

mkhtmlman:
	Don't try to create man pages from resource forks (which would
	have been created by either CAP or Netatalk).
This commit is contained in:
gdr-ftp 1999-01-18 01:46:07 +00:00
parent 36c45596c9
commit 1f8c740278
4 changed files with 209 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
doc/refs/Makefile
View File

@ -7,7 +7,7 @@
#
# Devin Reade, 1997.
#
# $Id: Makefile,v 1.10 1998/10/14 03:14:01 gdr-ftp Exp $
# $Id: Makefile,v 1.11 1999/01/18 01:46:06 gdr-ftp Exp $
#
# Set this to 'true' (without the quotes) for local links (used
@ -107,7 +107,7 @@ UPLOADS = \
#
# targets
#
all: dvi ps h man
all: dvi ps h man notes
dvi: $(DVI)
ps: ps_ltr ps_a4
ps_ltr: $(PS_LTR)
@ -128,6 +128,9 @@ intro.bbl: gno.bib
upload: all $(UPLOADS)
# keeps intro.tex in sync with ../../verbatim/boot/README.install
notes:; ./mknotes
htmld.tar.gz: h
tar -cf - $(HTMLD) | gzip --best > $@

129
doc/refs/intro.tex
View File

@ -1,7 +1,7 @@
%
% GNO Overview
%
% $Id: intro.tex,v 1.8 1998/10/31 20:23:29 gdr-ftp Exp $
% $Id: intro.tex,v 1.9 1999/01/18 01:46:06 gdr-ftp Exp $
%
\documentclass{report}
@ -998,12 +998,12 @@ 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).
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.
\begin{tabular}{ll}
boot disk (used only for installation) & 800k \\
binary distribution (shk files) & 4.6 MB \\
@ -1011,11 +1011,26 @@ binary distribution (extracted) & 12.1 MB \\
complete GNO source & 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
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
\hturl{http://www.jaws.umn.edu/~tobkin/vi}
for a good tutorial and quick reference guide.
\section{Downloading and Extracting the Binary Distribution}
Your first step is of course to download the distribution. You should
have the following NuFX archives:
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}.
You should have the following NuFX archives:
\begin{itemize}
@ -1029,8 +1044,8 @@ fashion.
\item{\bf gno.01.shk\rm, \bf gno.02.shk\rm, ... \bf gno.16.shk\rm}
These disk archives contain the main portion of the GNO distribution.
They must be placed in a single temporary subdirectory on a hard drive,
Zip disk, or other large capacity storage device. They should not yet be
extracted.
Zip disk, Appleshare volume, or other large capacity storage device.
They should not yet be extracted.
\item{\bf gnohfs.shk\rm}
This archive consists of files that do not conform to ProDOS naming
@ -1038,9 +1053,22 @@ conventions. While it is possible to run GNO without any HFS partitions
at all, it is recommended that you have available to GNO a small amount
of space on an HFS partition. If you use the \bf namespace\rm(5) facility,
it is unnecessary to dedicate an entire HFS partition to GNO.
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
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
running it.
It should also be possible to use a RAM disk for \bf gno.boot\rm, but
this has not been verified. If you have successfully installed from a
RAM disk, please let Devin Reade know, along with any observations
you may have.
You should now do the following steps:
\begin{comment}
@ -1053,49 +1081,84 @@ below with the appropriate name.
\begin{enumerate}
\item
From your program launcher (typically the Finder), run the program
\bf /gno.boot/kern\rm. This is the GNO kernel. It will come up in
single user mode and you will be logged in as root running a \bf gsh\rm
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
kernel.
\item
As per the instructions shown on the boot screen, you should now read the
file /gno.boot/README.install. The contents of that file, however, are
identical to the numerated instructions below; you need only read one or
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 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:
\begin{verbatim}
setenv DOWNLOAD_DIR /download
\end{verbatim}
Ensure that you use slashes (\bf/\rm) rather than colons (\bf:\rm) as the
pathname delimiter. Do not use a trailing slash.
\item
Assuming your distribution is to be installed onto the /gno partition,
issue the commands:
Install the majority of the GNO base distribution files by
changing directory into your destination directory and running
the \bf installboot1\rm script. Assuming that you will be installing
to the partition \bf/gno\rm, the commands would be:
\begin{verbatim}
cd /gno
/gno.boot/installboot1
\end{verbatim}
This will install the majority of the GNO binaries.
This step takes quite a while, even with an accelerated IIgs.
Have patience.
\item
There are a small number of recommended files that do not follow ProDOS
naming conventions. To install these files, issue the commands:
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 \bf installboot2\rm.
Assuming that the HFS disk is \bf/gno-hfs\rm, the commands are:
\begin{verbatim}
cd /gno-hfs
/gno.boot/installboot2
\end{verbatim}
This assumes that /gno-hfs is an HFS partition. If you would like to
use on your HFS partition a single subdirectory for GNO, then you could
create and cd into /some-partition/gno-hfs instead.
This step is optional. It is possible to use the GNO binary distribution
without an HFS partition, but some information will be missing.
This step is optional. It is possible to use the GNO binary
distribution without an HFS partition, but some information
will be missing.
\item
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.
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 \bf installboot2\rm script.
The \bf gno.boot\rm disk includes the \bf vi\rm 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
\hturl{http://www.jaws.umn.edu/~tobkin/vi}.
\begin{comment}
You may want to put /usr onto a different partition; it will
get fairly large over time.
@ -1103,7 +1166,9 @@ If you have a RAM disk, you should consider having it renamed
to /tmp using renram5(8) or mktmp(8), in which case its entry
should be removed from the namespace file.
See the kernel reference manual for a description of this file.
\end{comment}
See the kernel reference manual for a description of the
namespace file.
\item
If you are not short of disk space, you should create .so links
@ -1116,14 +1181,26 @@ commands:
mkso -v -H /gno-hfs/man mkso.data
\end{verbatim}
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:
\begin{verbatim}
cd /gno/usr/man
mkso -v mkso.data
\end{verbatim}
\item
You should 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
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
a ``login:'' prompt. Enter ``root'' as the user name; you will
not yet need a password.
%% README.install-end
\end{enumerate}
\section{Custom Configuration}

5
doc/refs/mkhtmlman
View File

@ -2,7 +2,7 @@
#
# Devin Reade, November 1997.
#
# $Id: mkhtmlman,v 1.7 1998/02/19 03:04:05 gdr-ftp Exp $
# $Id: mkhtmlman,v 1.8 1999/01/18 01:46:07 gdr-ftp Exp $
man2html=/usr/local/bin/man2html
TMPDIR=${TMPDIR:-/tmp}
@ -43,6 +43,9 @@ for section in 1 2 3 4 5 6 7 8; do
[ -d $dest ] || mkdir -p $dest
for F in 00.DUMMY `find $MANDIRS -type f -name '*.'$section -print \
| grep -v .AppleDouble \
| grep -v .finderinfo \
| grep -v .resource \
| grep -v libcurses/PSD.doc \
| grep -v bin/gsh/updates1.1 \
| grep -v sed/tests` ; do

93
doc/refs/mknotes Executable file
View File

@ -0,0 +1,93 @@
#! /usr/bin/perl
#
# This script creates the README.install notes for the gno.boot disk
# from the relevent information in the file ./intro.tex. It also reads
# in the file ../../verbatim/boot/README.install, and writes its results
# out to the same file.
#
# $Id: mknotes,v 1.1 1999/01/18 01:46:07 gdr-ftp Exp $
#
$texfile = "./intro.tex";
$notes = "../../verbatim/boot/README.install";
#
# First read in the beginning of the README.install file. This part we
# leave as is.
#
open (fp, "< $notes") || die("couldn't read $notes: $!");
while (<fp>) {
$output .= $_;
if (m,\s*You should now do the following steps:\s*,) {
last;
}
}
close(fp);
$started = 0;
$itemcount = 1;
open (fp, "< $texfile") || die("couldn't read $texfile: $!");
while (<fp>) {
# handle the beginning and end of our install notes section
if ($started == 0) {
if (m,^\s*%%\s+README.install-start\s*$,) {
$started = 1;
}
next;
}
if (m,^\s*%%\s+README.install-end\s*$,) {
last;
}
# don't print TeX comments.
if (m,^\s*\\begin\{comment\}\s*,) {
$incomment = 1;
next;
}
if (m,^\s*\\end\{comment\}\s*,) {
$incomment = 0;
next;
}
if ($incomment) {
next;
}
# handle the paragraphs of our notes
if (m,^\s*\\item\s*$,) {
$firstline=1;
next;
}
if (m,^\s*\\begin\{verbatim\}\s*$,) {
$verbatim=1;
next;
}
if (m,^\s*\\end\{verbatim\}\s*$,) {
$verbatim=0;
next;
}
if ($verbatim) {
$output .= "\t"; # indent verbatim sections
}
if ($firstline) {
$firstline = 0;
$buffer = sprintf("\t%2d. ", $itemcount++);
$output .= $buffer;
} else {
$output .= "\t ";
}
s,\\htlink\{([^\}]+)\},$1,g; # show URLs as plain text
s,\s*\\bf\s*, ,g; # strip formatting commands
s,\\rm,,g;
s,\\,,g; # strip '\' from "\_"
s,\`\`,\",g; # translate TeX-style quotes
s,\'\',\",g;
$output .= $_;
}
close(fp);
# write out the results
open (fp, "> $notes") || die("couldn't read $notes: $!");
print fp $output;
close(fp);