home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / textinfo / npdsa.arj / NPDSA.TXT < prev    next >
Encoding:
Text File  |  1991-01-28  |  20.0 KB  |  476 lines
  1.  
  2.         National Public Domain Software Archive, Lancaster University.
  3.  
  4.  
  5. Useful Commands To Get You Started                                             
  6. ----------------------------------                                             
  7. ?                             Lists the commands you can use                   
  8. help                          Enters interactive help system                   
  9. news micros or news kermit    Latest news on micro or kermit software topics   
  10.                                                                                
  11. Indexes                                                                        
  12. -------                                                                        
  13. micros/amiga/index  Commodore Amiga       micros/atari/index  Atari ST         
  14. micros/bbc/index    BBC Micro             micros/ibmpc/index  IBM PC           
  15. micros/mac/index    Apple Macintosh       micros/misc/index   Miscellaneous    
  16. kermit/index.pfx    Kermit                tools/index         Mainframe tools  
  17.                                                                                
  18. PEEK command change                                                            
  19. -------------------                                                            
  20. See the file ~/shell_features for details of the change. Also tools/y007 now   
  21. contains the latest release of the peek package for UNIX systems.              
  22.                                                                                
  23. Downtimes                                                                      
  24. ---------                                                                      
  25. The NPDSA service will be unavailable on Tuesday January 0900-1000 hours, to   
  26. allow us to install a new version of the Operating System kernel.              
  27.                                                                                
  28.                     BOO utility
  29. Sources for the deboo and makeboo utilities are now available in tools/y008.
  30.  
  31. ?               Lists available commands
  32. cat             Displays files
  33. cd              Changes the directory you are working in
  34. dir             Shows you what is in a directory
  35. grep            Searches files for a string
  36. help            Invokes the interactive help system
  37. kermit          Starts the Kermit program
  38. logout          Ends your session
  39. ls              Shows you what is in a directory
  40. more            Displays files in paged mode
  41. news            Displays one of the news-of-the-day files
  42. peek            Listing of encoded packed file
  43. pwd             Shows the name of the current directory
  44. search          Searches files for a string
  45. terminal        Establishes the terminal type
  46. type            Displays files
  47. xmodem          Download file(s) using X/Y modem protocols
  48. ymodem          Download file(s) using Y modem protocol
  49.  
  50. You may abbreviate commands to any degree provided that what you type can be
  51. unambiguously identified
  52.  
  53. -> cd micros/ibmpc
  54. Current directory is 'micros/ibmpc'
  55.  
  56.  
  57.                            ---------******---------
  58.  
  59.  
  60.  
  61. -> help
  62. Updating help indexes; please wait a moment
  63. THE INTERACTIVE HELP SYSTEM
  64.  
  65. This is the interactive help system, which hopefully will contain answers to
  66. any of the questions you're likely to ask about using the software archive.
  67.  
  68. If you type just the command "help", you'll see this section as the first
  69. display. At the end of the text, the help system will give you a list of
  70. sub-topics, and invite you to choose one. Type in the name of the topic and
  71. press return, and you'll move down to the next level. This may also have
  72. sub-topics which you can visit, and so on.
  73.  
  74. As well as giving the name of a sub-topic to go down to a lower level, you can
  75. also move back up to where you were before: you do this by pressing only RETURN
  76. in answer to the prompt.  You'll then be reminded of what other sub-topics
  77. there are to choose.
  78.  
  79. You can also quit at any time by replying "q" to the prompt and pressing
  80. RETURN.
  81.  
  82. You can always enter the help system in this way, and you can navigate up and
  83. down the system to the bit you want. After a while you might find this a bit
  84. tiresome, so the system lets you go directly to a sub-topic if you wish.
  85.  
  86. You do this by naming the sub-topics on the way to where you want to go. As an
  87. example, suppose you want to look up the page on the "dir" command. If you were
  88. navigating one stage at a time, you'ld go from this current topic to the
  89. "commands" sub-topic, and from there to the "dir" sub-topic. To get there
  90. directly, you would type
  91.  
  92.                help commands dir
  93.  
  94. in the command line.
  95.  
  96. To help you work out these "route maps", the top line of every display gives
  97. you the command you would type to get directly to the topic. Thus, if the top
  98. line shows
  99.  
  100.               help basics where indexes
  101.  
  102. then that's the exact command you type to get directly to that information.
  103.  
  104. You can if you wish abbreviate the topics you name to any degree, provided that
  105. what you give can be unambiguously identified; thus you could write the above
  106. command as
  107.  
  108.               help b whe i
  109.  
  110. Hopefully you'll find the system easy to use, as each sub-topic in a list has
  111. some text to say what it's about. For newcomers to the system, we suggest you
  112. go next to the "basics" sub-topic of this page, which will start you off with
  113. essential information. If what you need is an idea of the commands you can use
  114. here, go to the "commands" sub-topic.
  115.  
  116. If you want to acquire the help information by FTP, you'll find it provided in
  117. human-readable form in a number of files in directory "help". For an up-to-date
  118. list of what's available, FTP the file "help/00contents".
  119.  
  120. help  : sub-topics are :
  121.  
  122.   basics                Where things are, what to do, etc
  123.   commands              The commands you can use
  124.   e-mail                Contacting us by Electronic Mail
  125.   ftp                   How to get files by FTP
  126.   kermit                Information specific to Kermit software
  127.   micros                Information specific to microcomputer software
  128.   newsletters           Electronic Mail newsletters
  129.   server                The mail server interface to the NPDSA
  130.   terminals             Online access to our system
  131.  
  132. *** Next topic (? for help) : -> basics
  133.  
  134. -> help basics
  135. THE BASICS - WHERE THINGS ARE, WHAT TO DO
  136.  
  137. If this is the first time you've used NPDSA, then welcome, and we hope you will
  138. find things here to make it worthwhile.  You've obviously managed to connect a
  139. terminal to our machine and log in successfully; now you're here we can give
  140. you a brief guide on what's available and what you do to get it. 
  141.  
  142. The sub-topics of this item will give you a quick guide to the system. Remember
  143. that you can always type "?" at the command prompt to get a list of available
  144. commands; and you can always type "help" to enter the help system.
  145.  
  146. help basics  : sub-topics are :
  147.  
  148.   how                   How you can get hold of it
  149.   what                  What's available
  150.   where                 Where we keep it
  151.  
  152. *** Next topic (? for help) : what
  153. WHAT'S AVAILABLE
  154.  
  155. What's available is a very large collection of software, which we currently
  156. break down into two major collections.  The first collection is the Kermit
  157. file-transfer package; you'll find just about every known version of Kermit
  158. stored here, for more than 250 different micros, minis and mainframes.  We keep
  159. the collection up-to-date with the world distribution centre at Columbia
  160. University in New York; if a version exists you'll almost certainly find it
  161. here. Also in the collection is a full set of Columbia University's Info-Kermit
  162. Digests, which contain much technical discussion on the subject.
  163.  
  164. The second collection covers software for microcomputers (other than Kermit). 
  165. We currently archive items for
  166.  
  167.                 Apple Macintosh
  168.                 Atari ST
  169.                 BBC micro (6502)
  170.                 Commodore Amiga
  171.                 IBM PC
  172.  
  173. We acquire software from any sources we can, and we currently archive all
  174. software broadcast on the UNIX Usenet network for these machines.  Also in this
  175. collection are complete (at the time of writing) archives of IBM-PC and
  176. compatible software from the SIG-COMPATIBLE, PC-BLUE and COMUG user groups. 
  177. These have been purchased on behalf of the UK Academic Community by CHEST
  178. (Combined Higher Education Software Team) based at Bath University, and is
  179. included here at their request.  In addition, we archive copies of the
  180. Info-IBMPC, Info-MAC, Info-Amiga and Info-Atari Digests, containing technical
  181. discussions on these machines and their software. 
  182.  
  183.  
  184. *** RETURN to continue or q to quit : help basics  : sub-topics are :
  185.  
  186.   how                   How you can get hold of it
  187.   what                  What's available
  188.   where                 Where we keep it
  189.  
  190. *** Next topic (? for help) : where
  191. WHERE WE KEEP IT
  192.  
  193. The software archive is kept on a computer running the UNIX Operating System.
  194. The commands you can type are not standard UNIX ones (so don't expect standard
  195. UNIX things to work); however the way we've laid out the filestore is what
  196. you'ld expect.
  197.  
  198. Everything is kept in various directories in a tree structure. Those of you
  199. familiar with UNIX, VAX/VMS, MS-DOS and similar systems will immediately get
  200. the idea; on an Apple Macintosh the analogy is with folders.
  201.  
  202. As you log in, your job is set to be in the "top level" directory. The "dir"
  203. command (type "help commands dir" for details) will show you what files it
  204. contains. This is your "current working directory", and every time you name a
  205. file the system assumes it's in this directory unless you say otherwise.
  206.  
  207. There aren't many files in the top level directory. What you will see, though,
  208. are more directories, two of which are called "kermit" and "micros". The Kermit
  209. software is held in the "kermit" directory, and the microcomputer software is
  210. held in the "micros" directory.
  211.  
  212. You can move to other directories with the "cd" command (type "help commands
  213. cd" for full details). If we assume you type
  214.  
  215.               cd micros
  216.  
  217. your current working directory changes to be the micros directory. Now if you
  218. use the "dir" command you'll see different files; and also a number of other
  219. directories, including ones called "ibmpc", "mac" and "atari".
  220.  
  221. The software for each specific machine is held in the directory with its name.
  222. So to get a bit nearer to some IBM PC software, you can now type
  223.  
  224.              cd ibmpc
  225.  
  226. The "dir" command again shows you some different files; there will be very few
  227. files, but a large number of directories, with names like "e01", "f23" and so
  228. on. These directories are where the actual software is held; so that finally
  229. you could type
  230.  
  231.               cd e01
  232.  
  233. and now "dir" will show you the actual files containing the software.
  234.  
  235. [The SIG-COMPATIBLE, PC-BLUE and COMUG archives are held under the micros/ibmpc
  236. directory]
  237.  
  238. help basics where  : sub-topics are :
  239.  
  240.   indexes               Where the indexes are
  241.  
  242. *** Next topic (? for help) : help basics  : sub-topics are :
  243.  
  244.   how                   How you can get hold of it
  245.   what                  What's available
  246.   where                 Where we keep it
  247.  
  248. *** Next topic (? for help) : how
  249. HOW YOU CAN GET HOLD OF IT
  250.  
  251. You can acquire files from the archive in two ways. If you are at a UK
  252. University or Polytechnic with a connection to the JANET network, the best way
  253. for both you and us is to use FTP. This involves you logging in to your local
  254. machine and issuing a command to fetch a copy of a file from the archive. Then
  255. when it's on your machine, you can download it to your micro or ship it to
  256. where it needs to go. Ypu can type "help ftp" for detailed information on this;
  257. your local Computer Centre will also be able to help you (and may already have
  258. a sizeable subset of our archive available).
  259.  
  260. If you can't use FTP, you can collect files from us in terminal sessions. For
  261. this you'll need to have a micro (such as an IBMPC) running as a terminal
  262. emulator, with some means of capturing data onto disc. You log in to our
  263. system, and either type the file out and store it on disc as it goes by, or,
  264. much better, use the Kermit file transfer program for an error-free download.
  265.  
  266. Type "help terminal" to see how you can get a terminal connection to us; "help
  267. kermit" tells you how to run our Kermit program.
  268.  
  269.  
  270. *** RETURN to continue or q to quit : 
  271. help basics  : sub-topics are :
  272.  
  273.   how                   How you can get hold of it
  274.   what                  What's available
  275.   where                 Where we keep it
  276.  
  277. *** Next topic (? for help) : 
  278. help  : sub-topics are :
  279.  
  280.   basics                Where things are, what to do, etc
  281.   commands              The commands you can use
  282.   e-mail                Contacting us by Electronic Mail
  283.   ftp                   How to get files by FTP
  284.   kermit                Information specific to Kermit software
  285.   micros                Information specific to microcomputer software
  286.   newsletters           Electronic Mail newsletters
  287.   server                The mail server interface to the NPDSA
  288.   terminals             Online access to our system
  289.  
  290. *** Next topic (? for help) : terminals
  291. ACCESSING US FROM A TERMINAL
  292.  
  293. The Archive can be accessed over dial-up through a modem; or via the the JANET
  294. or PSS networks.  Once you have logged in to the service, you can look at the
  295. collection of files, and you can download them to your own machine using either
  296. Kermit or a dumb-capture mechanism. 
  297.  
  298. The service runs 24 hours a day, 7 days a week.
  299.  
  300.  
  301.                            ---------******---------
  302.                                                    
  303.  
  304. -> pwd
  305. Current directory is 'micros/ibmpc'
  306. -> dir index
  307. Files matching pattern 'index' in directory '~/micros/ibmpc' :
  308.  
  309. IBM PC PROGRAMS                                                                
  310.                                                                                
  311. For IBM PC packages, we use two techniques: "BOO" encoding and "ARC" encoding. 
  312. BOO encoding is a simple translation of one binary file into one printable     
  313. file. ARC encoding is more complex: one ARC format file usually contains more  
  314. than one original file, and all are converted into printable form and compacted
  315. to take as little space as possible. Since ARC files are themselves binary,    
  316. they have to be processed into BOO encoding to be mounted on the archive.      
  317.                                                                                
  318. [NOTE: As we explain below, the ARC format used is that of the PKPAK/PKUNPAK   
  319. utility. These cannot usually be unpacked with the utility known as ARC, but   
  320. just to confuse things everyone still calls them "ARC" format files]           
  321.                                                                                
  322. Thus, actually getting a runnable package will usually involve three steps.    
  323.                                                                                
  324.   1. Download the files onto your IBM PC                                       
  325.                                                                                
  326.   2. Use the BOO converter utility to convert any BOO files back into their    
  327.      original form                                                             
  328.                                                                                
  329.   3. If any of the resulting files are ARC format files, use the ARC           
  330.      utility to convert these, after which you'll have a set of correctly      
  331.      formatted files, all with the correct names as needed by the package.     
  332.                     
  333. You will, of course, need to start by getting the BOO and ARC converters. These 
  334. are stored in the "tools" sub-area of the IBM-PC archive: the steps you need to 
  335. take are these (they look involved, but take heart: it's a once-only job)
  336.  
  337.   1. Use the cd command to move to the tools area
  338.  
  339.                     cd ~/micros/ibmpc/h99
  340.  
  341.   2. Use Kermit (or your favourite terminal emulator) to download the file
  342.  
  343.                     h99boo.bas
  344.  
  345.      This is a "de-BOO" program written in MS-BASIC : it's slow and 
  346.      inefficient, but you'll only need it once.
  347.  
  348.   3. Download the file
  349.  
  350.                     h99boo.boo
  351.  
  352.      This is a BOO-encoding of the real de-BOO utility.
  353.  
  354.   4. Run the BASIC program : at the end you'll have a file called DEBOO.EXE,
  355. which you can use from now on to de-BOO files.
  356.  
  357.   5. Download the file
  358.  
  359.                     h99pk.boo
  360.  
  361.      This is a BOO encoding of the archive utility PKPAK/PKUNPAK
  362.  
  363.   6. Type the command
  364.  
  365.                     DEBOO H99PK.BOO
  366.  
  367.      which will produce a file called PKnnn.EXE (where "nnn" is the version 
  368.      number)
  369.  
  370.   7. Issue the command
  371.  
  372.                     PKnnn
  373.  
  374.      (where "nn" is the version number, as in 6 above)
  375.  
  376.      This will produce a set of files for the utility. You'll find one
  377.      called PKUNPAK.EXE, which is the actual program that unpacks archives,
  378.      and also some documentation on the system.
  379.  
  380. Once you've done that, keep the files safely, and you should never need to go
  381. through this process again. 
  382.  
  383. [IMPORTANT NOTE: In earlier times, files were archived with a utility called
  384. ARC. This produced files that can be read without problems by PKUNPAK, so the
  385. methods described here will be correct. However, some packages, most noticeably
  386. those in the PC-BLUE, SIG-COMPATIBLE and COMUG archives, and much new stuff,
  387. will be archived using PKPAK. These files *cannot* be unpacked by ARC, so we
  388. recommend that you upgrade to PKUNPAK as soon as you can]
  389.  
  390.  
  391. *** RETURN to continue or q to quit : q
  392. -> cd ~/micros/ibmpc/h99
  393. Current directory is 'micros/ibmpc/h99'
  394. -> dir
  395. Files matching pattern '*' in directory '.' :
  396.  
  397. 00contents      h99.msg         h99arc.msg      h99boo.bas      h99boo.boo 
  398. h99boo.c        h99boo.msg      h99mkboo.boo    h99mkboo.c      h99mkboo.msg 
  399. h99pkpak.boo    h99pkpak.msg    h99pkzip.boo    h99pkzip.msg    h99zoo.boo 
  400. h99zoo.msg 
  401.  
  402. Directories matching pattern '*':
  403.  
  404. -> type h99.msg
  405. Archive Manipulation Tools for IBM PC
  406. -------------------------------------
  407.  
  408. Directory ibmpc/h99 contains a full set of the archive handling tools that
  409. you'll need to manipulate material held by NPDSA. To get files from us,
  410. you'll need the following tools:
  411.  
  412.    1. The utility that converts from .BOO format ASCII files into whatever
  413.       binary format the package is archived in
  414.    2. The appropriate archive handling program :
  415.           PKPAK/PKUNPAK   for files ending in .ARC
  416.           PKZIP/PKUNZIP   for files ending in .ZIP
  417.           ZOO             for files ending in .ZOO
  418.  
  419. The programs you need are in this directory, as follows:
  420.  
  421. h99boo.msg      Information about the BOO file converter
  422. h99boo.bas      A quick BOO file converter in MS-BASIC
  423. h99boo.boo      A BOO-encoded .EXE file of the real BOO converter
  424. h99boo.c        Source of the BOO file converter
  425. h99mkboo.c      Source of the program that generates BOO files
  426.  
  427. h99pkpak.msg    Information about PKPAK
  428. h99pkpak.boo    The PKPAK/PKUNPAK utility
  429.  
  430. h99pkzip.msg    Information about PKZIP
  431. h99pkzip.boo    The PKZIP/PKUNZIP utility
  432.  
  433. h99zoo.msg      Information about ZOO
  434. h99zoo.boo      The ZOO utility. You will need to have obtained PKPAK first
  435.                 in order to unpack this file
  436.  
  437.  
  438. Using the archive programs
  439. --------------------------
  440.  
  441. There's full documentation with each of the archive programs, and it's
  442. recommended that you do consult it to see the full range of options. For
  443. simple use, though, you can do the following:
  444.  
  445. PKUNPAK
  446.  
  447.    To unpack an ARC format file, do
  448.  
  449.                  pkunpak  filename
  450.  
  451.    To list the contents, do
  452.  
  453.                  pkunpak -v filename
  454.  
  455. PKUNZIP
  456.  
  457.    To unpack a ZIP format file, you should first look at the contents with
  458.  
  459.                  pkunzip -v filename
  460.  
  461.    If the names of the files in the archive don't contain directory components,
  462.    then you can unpack them with
  463.  
  464.                  pkunzip filename
  465.  
  466.    If they do contain directory components, extract them with
  467.  
  468.                  pkunzip -d filename
  469.  
  470.    which will create the necessary directory structure.
  471.  
  472.  
  473.                            ---------******---------
  474.  
  475.  
  476.