NextAnswers@next.com (04/01/91)
Archive-name: sys/next/nextstep-concepts/1991-03-29
Archive: sonata.cc.purdue.edu:/pub/next/docs/NextStep_Concepts.tar.Z [128.210.15.30]
Original-posting-by: NextAnswers@next.com
Original-subject: Concepts chapters on archive servers
Reposted-by: emv@msen.com (Edward Vielmetti, MSEN)
The hard-copy technical documentation that is now being shipped
includes the "NeXTstep Concepts" and "Sound, Music, and Signal
Processing Concepts" manuals, which were not distributed on-line as
part of the 2.0 or 2.1 software releases. Because the "Concepts"
chapters are very useful for learning about programming NeXT
computers, users of the 2.0 Extended or 2.1 Extended software
releases may wish to add them to their on-line documentation. The
"Concepts" chapters can now be obtained from the Internet archive
servers. They are not available in electronic form directly from
NeXT.
The "NeXTstep Concepts" chapters are based on Release 1.0; be sure to
read the file Intro.rtf for details. The "Sound, Music, and Signal
Processing Concepts" chapters are based on Release 2.0.
You can obtain the "Concepts" chapters by anonymous ftp (file
transfer protocol) from one of the following Internet archive
servers:
________________________________________________________
hostname IP address directory
________________________________________________________
cs.orst.edu 128.193.32.1 pub/next/documents/NeXT
sonata.cc.purdue.edu 128.210.15.30 pub/next/docs
Purdue also maintains an email-based archive server, for those
without ftp access. Send a message consisting of "help" to
archive-server@cc.purdue.edu. If the "From:" line in your message
header will not be in Internet format (e.g., name@site.edu), include
a line in your message like "path name@site.edu" or "path
wellknownsite!yoursite!yourname@uunet.uu.net". Note that neither
name@site.bitnet nor name@site.UUCP will work.
NextStep_Concepts.tar.Z occupies 1.56 Megabytes. When unarchived,
it's 6.66 Megabytes. SndMusicDSP_Concepts.tar.Z occupies 421
Kilobytes; unarchived, it's 1.25 Megabytes. Indexing will add 200
Kilobytes. Thus you'll need to have more than ten Megabytes free on
your disk before installation. (Two of these ten Megabytes will be
retrieved by deleting the archive files after unarchiving them.)
We recommend installing the NextStep and SndMusicDSP Concepts
directories in /NextLibrary/Documentation/NextDev/NextStep and
/NextLibrary/Documentation/NextDev/SndMusicDSP, respectively. This
will place the Concepts directories alongside the corresponding
Reference directories that were shipped with the 2.0 release, making
the directory structure consistent with the way the documentation was
organized in Release 1.0.
If these documentation directories are write-protected, you'll need
to remove the write protection to install the Concepts chapters
there. Check the protection by using the Workspace Manager's
Inspector panel, or by typing the following Unix command in a
Terminal window:
ls -l /NextLibrary/Documentation/NextDev
(If the lines for NextStep and SndMusicDSP start with something like
"drwxr-xr-x 3 root", you don't have write permission.)
If you don't have write permission, you'll probably need to have root
access to change the protection. These commands (and all and
subsequent ones) should be typed in a Terminal window:
su
[if it says "You do not have permission to su root", see your system
administrator]
password: [type password for root access]
# cd /NextLibrary/Documentation/NextDev
# chmod a+w NextStep
# chmod a+w SndMusicDSP
# chmod -R a+w .index
[control-D]
Here are instructions for ftp'ing the files into the documentation
directory and unarchiving them:
ftp hostname [replace "hostname" with a choice from the table above]
login: anonymous
password: [type your login name as password]
ftp> cd directory [see table above for the appropriate replacement
for "directory"]
ftp> lcd /NextLibrary/Documentation/NextDev/NextStep
ftp> binary
ftp> get NextStep_Concepts.tar.Z
ftp> lcd ../SndMusicDSP
ftp> get SndMusicDSP_Concepts.tar.Z
ftp> quit
cd /NextLibrary/Documentation/NextDev/NextStep
zcat NextStep_Concepts.tar.Z | tar xvf -
cd ../SndMusicDSP
zcat SndMusicDSP_Concepts.tar.Z | tar xvf -
This will create Concepts subdirectories in both the NextStep and the
SndMusicDSP directories, along with corresponding README files.
Next, update the NextDev index:
cd /NextLibrary/Documentation/NextDev
ixBuild -CV -NReleaseNotes
Indexing will take a number of minutes to complete; you'll see the
filenames printed out as they're indexed. When it's done, try a few
searches using the "Next Developer" target in Digital Librarian to
verify that the installation and indexing were successful. Then
remove the archive files:
rm NextStep/NextStep_Concepts.tar.Z
[if it asks for confirmation, type "y"]
rm SndMusicDSP/SndMusicDSP_Concepts.tar.Z
[if it asks for confirmation, type "y"]
You'll probably want to write-protect the directories again, if you
had previously made them unprotected:
su
password: [type password for root access]
# chmod a-w NextStep
# chmod a-w SndMusicDSP
# chmod -R a-w .index
[control-D]