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]