From 999f6066fbc51fa329b7e4cc42902cb367dfe912 Mon Sep 17 00:00:00 2001 From: gdr-ftp Date: Fri, 12 Jun 1998 14:47:44 +0000 Subject: [PATCH] index.html: added links for status lists intro.tex: added installation chapter for GNO v2.0.6. This isn't finished yet, but it's a start. kern.tex: fixed typo for listen(2) related.html: fixed html link. ignored.pages: added some ... deleted some --- doc/refs/ignored.pages | 17 ++++- doc/refs/index.html | 6 ++ doc/refs/intro.tex | 168 ++++++++++++++++++++++++++++++++++++++++- doc/refs/kern.tex | 4 +- doc/refs/related.html | 2 +- 5 files changed, 188 insertions(+), 9 deletions(-) diff --git a/doc/refs/ignored.pages b/doc/refs/ignored.pages index 48da0c3..02ffb6c 100644 --- a/doc/refs/ignored.pages +++ b/doc/refs/ignored.pages @@ -2,13 +2,24 @@ # It is critical that there be no whitespace either preceeding nor # following these file names. # -# $Id: ignored.pages,v 1.1 1998/02/19 03:03:53 gdr-ftp Exp $ +# $Id: ignored.pages,v 1.2 1998/06/12 14:47:30 gdr-ftp Exp $ # 00.DUMMY -../../usr.man/man4/tty.4 -../../bin/gsh/updates1.1 +../../usr.bin/awk/tests/addr.1 +../../usr.bin/awk/tests/out/out.1.2 +../../usr.bin/awk/tests/out/out.1.4 +../../usr.bin/awk/tests/out/out.2.1 +../../usr.bin/awk/tests/out/out.2.2 +../../usr.bin/awk/tests/out/out.2.3 +../../usr.bin/awk/tests/out/out.2.4 +../../usr.bin/awk/tests/out/out.3.1 +../../usr.bin/awk/tests/out/out.8.1 +../../usr.bin/dirname/dirname.1 ../../sbin/reboot/boot.hp300.8 ../../sbin/reboot/boot.i386.8 ../../sbin/reboot/boot.sparc.8 ../../sbin/reboot/boot.tahoe.8 ../../sbin/reboot/boot.vax.8 +../../usr.man/man3/getcap.3 +../../usr.sbin/cron/cron.8 +../../usr.sbin/inetd/inetd.8 diff --git a/doc/refs/index.html b/doc/refs/index.html index 859d8b9..bebd89a 100644 --- a/doc/refs/index.html +++ b/doc/refs/index.html @@ -23,6 +23,12 @@ It consists of the following sections:
  • Reference Manuals
  • Manual Pages
  • Bug Reports +
  • Status Lists for Work Under Development: +
  • GNO-Related Web Links
  • Old Documentation (August 1996 Revision for GNO v2.0.4) diff --git a/doc/refs/intro.tex b/doc/refs/intro.tex index a4e7995..38d40e5 100644 --- a/doc/refs/intro.tex +++ b/doc/refs/intro.tex @@ -1,7 +1,7 @@ % % GNO Overview % -% $Id: intro.tex,v 1.4 1998/01/26 07:13:09 gdr-ftp Exp $ +% $Id: intro.tex,v 1.5 1998/06/12 14:47:33 gdr-ftp Exp $ % \documentclass{report} @@ -14,8 +14,8 @@ \begin{document} \title{GNO Overview and Installation} -\author{Jawaid Bazyar \\ Tim Meekins} -\date{28 November 1997} +\author{Jawaid Bazyar \\ Tim Meekins \\ Devin Reade} +\date{11 June 1998} \maketitle \bibliographystyle{plain} @@ -852,6 +852,168 @@ directories. Here is a brief rundown of thier contents: \end{rawhtml} +\chapter{Installation for GNO v2.0.6} + +\em GNO v2.0.6 is not yet available. These installation instructions +have been included both for the benefit of the development team and as +draft instructions for when the update is released. Please don't ask +when v2.0.6 will be ready; we'll get it to you as soon as possible.\rm + +\em These instructions should be considered as draft quality. If you +have suggestions on or corrections to these instructions, please forward +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 +time beyond the scope of this document. + +At this time, unfortunately, installing GNO is fairly cumbersome. +Gsh's scripting abilities are crude at best, and for various reasons +the Apple Installer program is not sufficient, +When sh (the Bourne Shell) is finished for GNO, installation should be easier. + +Information in this chapter may change +significantly from release to release, so even if you have previously +installed a version newer than v2.0.4, you should review this chapter +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). +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 \\ +binary distribution (extracted) & 12.1 MB \\ +complete GNO source & 15.0 MB \\ +\end{tabular} + + +\section{Downloading and Extracting the Archive Files} + +Your first step is of course to download the distribution. You should +have the following NuFX archives: + +\begin{itemize} + +\item{\bf gnoboot.shk\rm} +This is the GNO installation bootstrap disk. It should be extracted to +a ProDOS-formatted 800k floppy disk named ``/gno.boot'' (the name is +critical). It does not include a copy of GS/OS and is +therefore not bootable; you will have to boot your system in the normal +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. + +\item{\bf gnohfs.shk\rm} +This archive consists of files that do not conform to ProDOS naming +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. + +\end{itemize} + +You should now do the following steps: + +\begin{comment} + +If your volumes are named something else, replace the names in the cd commands +below with the appropriate name. + +\end{comment} + + +\begin{enumerate} + +\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: + +\begin{verbatim} + setenv DOWNLOAD_DIR /download +\end{verbatim} + +\item +Assuming your distribution is to be installed onto the /gno partition, +issue the commands: + +\begin{verbatim} + cd /gno + /gno.boot/installboot1 +\end{verbatim} + +This will install the majority of the GNO binaries. + +\item +There are a small number of recommended files that do not follow ProDOS +naming conventions. To install these files, issue the commands: + +\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. + +\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. + +You may want to put /usr onto a different partition; it will +get fairly large over time. + +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. + +\item +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: + +\begin{verbatim} + cd /gno/usr/man + mkso -v -H /gno-hfs/man 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 +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. + +\end{enumerate} + +\section{Custom Configuration} + + + \chapter{Desk Accessories} The following is a description of the desk diff --git a/doc/refs/kern.tex b/doc/refs/kern.tex index 911f4a5..ea78205 100644 --- a/doc/refs/kern.tex +++ b/doc/refs/kern.tex @@ -1,7 +1,7 @@ % % GNO Kernel Reference Manual % -% $Id: kern.tex,v 1.4 1998/02/19 03:03:56 gdr-ftp Exp $ +% $Id: kern.tex,v 1.5 1998/06/12 14:47:37 gdr-ftp Exp $ % \documentclass{report} @@ -2348,7 +2348,7 @@ The following system calls are new to GNO v2.0.6: socket & \$4503 & bind & \$4603 \\ connect & \$4703 & - listen & \$4703 \\ + listen & \$4803 \\ accept & \$4903 & recvfrom & \$4A03 \\ sendto & \$4B03 & diff --git a/doc/refs/related.html b/doc/refs/related.html index 4c4328b..25a3626 100644 --- a/doc/refs/related.html +++ b/doc/refs/related.html @@ -4,7 +4,7 @@ The following links are also likely to be of interest to GNO users and programmers.