home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / answers / comp-lang-ada / public-ada-library < prev    next >
Internet Message Format  |  1993-11-25  |  40KB
  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!spool.mu.edu!uwm.edu!wupost!wuarchive.wustl.edu!conn
  2. From: conn@wuarchive.wustl.edu (Richard Conn)
  3. Newsgroups: comp.lang.ada,comp.answers,news.answers
  4. Subject: Public Ada Library FAQ
  5. Followup-To: poster
  6. Date: 26 Nov 1993 05:56:57 -0600
  7. Organization: Washington University in Saint Louis, MO
  8. Lines: 886
  9. Approved: news-answers-request@mit.edu
  10. Message-ID: <conn.754314965@wuarchive.wustl.edu>
  11. NNTP-Posting-Host: wuarchive.wustl.edu
  12. Summary: Public Ada Library (PAL) Frequently Asked Questions
  13. Keywords: Public Ada Library, FAQ, PAL
  14. Xref: senator-bedfellow.mit.edu comp.lang.ada:15314 comp.answers:2800 news.answers:15095
  15.  
  16. Archive-name: comp-lang-ada/public-ada-library
  17.  
  18. Date of this FAQ: Friday, November 26, 1993
  19. Public Ada Library (PAL) Frequently Asked Questions (FAQ)
  20. Posting Frequency: Monthly
  21.  
  22. The Public Ada Library is a library of Ada software, courseware, and
  23. documentation on the wuarchive.wustl.edu host computer.  This FAQ
  24. addresses the following questions:
  25.  
  26.  . What is the Public Ada Library (PAL)?
  27.  . What is WUARCHIVE?
  28.  . What is WUNET and How Does It Relate to WUARCHIVE?
  29.  . How Can I Find Out About the Status of WUARCHIVE?
  30.  . How Can I Receive Announcements of New Items, Changes, and other
  31.    Information about the Public Ada Library (PAL)?
  32.  . How Can I Interact with Ada Educators and Trainers through the PAL?
  33.  . What Documentation is Available to Help the PAL User?
  34.  . How is the PAL Like a Conventional Library?
  35.  . Is the Software in the PAL Free of Defects?
  36.  . How Do I Handle the Various Types of Files in the PAL?
  37.  . How Can I Get to the Items in the PAL?
  38.  . How Do I Work with ZIP Files and MAC Binary Files in the PAL from my MAC?
  39.  . How Can I Submit an Item to the PAL?
  40.  . What Copies and Mirrors of Repositories Exist in the PAL?
  41.  
  42. Questions about this FAQ?  Suggestions for improvement?  Gripes?
  43. Contact:
  44.   Richard Conn, Manager, Public Ada Library (PAL)
  45.   conn@wuarchive.wustl.edu
  46.  
  47. =======================================================
  48. What is the Public Ada Library?
  49. Last Update: November 25, 1993
  50.  
  51. The Public Ada Library (PAL) is a library of Ada software, courseware,
  52. and documentation on the Internet-based host computer named
  53. wuarchive.wustl.edu (WUARCHIVE).  PAL is located in the directories
  54. languages/ada and languages/vhdl if you access WUARCHIVE by FTP, archie,
  55. gopher, or FTPMAIL, or in the directories /archive/languages/ada and
  56. /archive/languages/vhdl if you access WUARCHIVE by NFS.  The PAL reached
  57. the Initial Operational Capability milestone in its evolution on June
  58. 21, 1993.
  59.  
  60. The purposes of the PAL are:
  61.  
  62.   . to help make Ada-oriented software, courseware, and documentation
  63.     that has been released for public distribution (as shareware,
  64.     freeware, GNU Copyleft, etc) readily available to the public
  65.  
  66.   . to support Ada educators by providing a convenient mechanism
  67.     for them to exchange material and ideas
  68.  
  69.   . to support the Ada user community in general by providing a
  70.     resource in support of their activities
  71.  
  72. The PAL, which is located in the directory trees languages/ada and
  73. languages/vhdl on WUARCHIVE, is actually four collections of material in
  74. one:
  75.  
  76.  1. the languages/ada/ajpo tree is a mirror of the public area of
  77.     the ajpo.sei.cmu.edu host computer; this collection is maintained
  78.     by the Ada Information Clearinghouse (AdaIC) under the direction of
  79.     the Ada Joint Program Office; as a mirror, whenever the AdaIC updates
  80.     its files on ajpo.sei.cmu.edu, the languages/ada/ajpo tree of the
  81.     PAL is automatically updated within 24 hours; documentation on the
  82.     languages/ada/ajpo tree is found scattered throughout the tree itself
  83.     and in the PAL Catalog
  84.  
  85.  2. the languages/ada/asr tree is the principal copy of the Ada Software
  86.     Repository (ASR) on wsmr-simtel20.army.mil; the ASR is no longer
  87.     actively maintained; documentation on the languages/ada/asr tree is
  88.     found in the languages/ada/asr/mindex directory as the Master Index
  89.     document (files are named *.ch, containing chapters of the document)
  90.     and in the PAL Catalog
  91.  
  92.  3. the languages/vhdl tree is a mirror of the VHDL Repository at the
  93.     University of Cincinnati, host uceng.uc.edu; this collection is
  94.     maintained by Dr. Harold Carter of the Department of Electrical
  95.     and Computer Engineering at the University of Cincinnati; as a
  96.     mirror, whenever the VHDL Repository is updated, the languages/vhdl
  97.     tree of the PAL is automatically updated within 24 hours; documentation
  98.     on the languages/vhdl tree is found scattered throughout the tree itself
  99.     and in the PAL Catalog
  100.  
  101.  4. the rest of the languages/ada tree is the part of the PAL maintained
  102.     by the manager of the PAL; documentation is found in the directory
  103.     languages/ada/userdocs/catalog, which contains the PAL Catalog,
  104.     PAL LOTUS-123 and dBase IV compatible database files, and other
  105.     forms of catalog information on the PAL
  106.  
  107. At the time of this writing, the size of the PAL is:
  108.  
  109.     Section             Size (M Bytes)
  110.     ===============     ==============
  111.     1. AJPO                 141.8
  112.     2. ASR                   80.8
  113.     3. VHDL                   3.8
  114.     4. PAL-maintained       238.2
  115.                            ======
  116.     PAL Total               464.6
  117.  
  118. WUARCHIVE is supported by the Office of the Network Coordinator,
  119. Washington University in Saint Louis.  The Manager of the PAL is working
  120. on a voluntary, unfunded basis.  Support for the PAL and its manager is
  121. in the form of unrestricted use of disk space on WUARCHIVE, technical
  122. consulting support, and general support as a user of WUARCHIVE.
  123.  
  124. Many organizations have developed cooperative relationships with the
  125. PAL, contributing time, effort, user support services, and artifacts to
  126. the PAL and its users either directly or indirectly.  These
  127. organizations include:
  128.   AdaNET
  129.   the Ada Joint Program Office
  130.   the Ada Information Clearinghouse
  131.   the Asset Source for Software Engineering Technology
  132.   the Central Archive for Reusable Defense Software
  133.   Conservatoire National des Arts et Metiers (CNAM) in Paris, France
  134.   the Software Engineering Institute
  135.   the Software Reuse Repository at the University of Maine
  136.   the VHDL Repository at the University of Cincinnati
  137.  
  138. To begin using the PAL, read the PAL.FAQ file (posted on USENET and
  139. available in the languages/ada/userdocs/faqfile subdirectory).  It is
  140. highly recommended that users obtain the current PAL Catalog (named
  141. PALCAT.DOC in the subdirectory languages/ada/userdocs/catalog) as well.
  142.  
  143. The PAL can be accessed by a wide variety of mechanisms.  These
  144. mechanisms include, but are not limited to, the following:
  145.  
  146.   . FTP to WUARCHIVE itself (up to 250 simultaneous FTP users)
  147.   . NFS mounts on WUARCHIVE
  148.   . archie email servers
  149.   . gopher email servers
  150.   . FTPMAIL email servers
  151.   . CDROM distributions
  152.   . AdaNET distributions and customer support (AdaNET is free to users)
  153.  
  154.  
  155.  
  156.  
  157.                           General Disclaimer
  158.                           ==================
  159.  
  160. All software, courseware, documentation, and other items of information
  161. in the PAL are provided "AS IS" without any expressed or implied
  162. warranties whatsoever unless their individual documentation states
  163. otherwise.  No warranties as to performance, merchantability, or fitness
  164. for a particular purpose exist.
  165.  
  166. Because of the diversity of conditions under which this software may be
  167. used, no warranty of fitness for a particular purpose is offered.  The
  168. user is advised to test the software and courseware thoroughly before
  169. relying on it.  The user must assume the entire risk and liability of
  170. using this software, courseware, and documentation.
  171.  
  172. In no event shall any person or organization be held responsible for any
  173. direct, indirect, consequential, or inconsequential damages or lost
  174. profits.
  175.  
  176. =======================================================
  177. What is WUARCHIVE?
  178. Last Update: November 14, 1993
  179.  
  180. The host computer named wuarchive.wustl.edu (WUARCHIVE) is a Digital
  181. Equipment Corporation (DEC) Alpha AXP 3000 Model 400.  It is equipped
  182. with 128M bytes of RAM and over 21G bytes of disk space, and it is able
  183. to support up to 250 simultaneous anonymous FTP session as well as many
  184. remote NFS mounts.
  185.  
  186. WUARCHIVE is owned by the Office of the Network Coordinator, Washington
  187. University in Saint Louis. It is supported out of the budget of the
  188. Office of the Network Coordinator and by a grant from the National
  189. Science Foundation.  The Office of the Network Coordinator and the
  190. National Science Foundation have jointly paid for the hardware of the
  191. machine and for the services of the support personnel at Washington
  192. University in Saint Louis.
  193.  
  194. The maintainers of the archives which originate on WUARCHIVE are
  195. volunteers, working on an unfunded basis.  The support personnel who
  196. maintain the operational support software, including the software
  197. which keeps the mirrors up to date, are funded by the Office of the
  198. Network Coordinator and the National Science Foundation grant.
  199.  
  200. We wish to express our gratitude to Digital Equipment Corporation for
  201. the sale of the DEC Alpha at a substantial discount and to the National
  202. Science Foundation for its grant in support of WUARCHIVE.
  203.  
  204. =======================================================
  205. What is WUNET and How Does It Relate to WUARCHIVE?
  206. Last Update: November 14, 1993
  207.  
  208. WUNET.WUSTL.EDU is the electronic mail list server for users of the
  209. Public Ada Library.  A separate computer from WUARCHIVE.WUSTL.EDU (on
  210. which the PAL is located), WUNET's purpose in life from the point of
  211. view of the PAL user is to manage the electronic mailing lists
  212. supporting him.
  213.  
  214. The List Server is a program on WUNET which manages Lists (Electronic
  215. Mailing Lists).  The user can send commands to the List Server, and it
  216. will respond by performing actions for him (such as adding him to a
  217. List, removing him from a List, and sending him a message naming all the
  218. lists supported by the List Server).  The user can send email messages
  219. to the List, and the subscribers to the List will receive these
  220. messages.
  221.  
  222. To find out what commands the List Server can respond to, send an email
  223. message to
  224.  
  225.   listserv@wunet.wustl.edu
  226.  
  227. which contains an empty subject line and one line in the body of the
  228. message (starting in the first column):
  229.  
  230.   help
  231.  
  232. Once subscribed, a user can send electronic mail to all subscribers of a
  233. List by sending email to the list's name at wunet.wustl.edu:
  234.  
  235.   ada-train@wunet.wustl.edu
  236.  
  237. This, of course, only works if the List is bidirectional.  The ANNOUNCE
  238. Lists are unidirectional (read-only from the point of view of the
  239. subscribers).  Subscribers cannot post email messages to the ANNOUNCE
  240. lists - only the moderator of the ANNOUNCE lists can post messages.
  241.  
  242. Other parts of the PAL FAQ and the first chapter of the PAL Catalog
  243. discuss the WUARCHIVE-ANNOUNCE, PAL-ANNOUNCE, and ADA-TRAIN Lists
  244. managed by the List Server.
  245.  
  246.   A partial list of lists available from the listserv@wunet.wustl.edu
  247.                    Last modified 6-AUG-1993 08:42:59
  248.  
  249. These lists are for the PAL user community.  For a more complete list of
  250. the mailing lists available to your site, send a mail message to
  251. listserv@wunet.wustl.edu which contains the command "DIR/LISTS". 
  252.  
  253.     Wuarchive-Announce - Notification of any planned downtime or service
  254.       changes for wuarchive.wustl.edu.  The only announcements from this
  255.       list will be from local staff or archivers.
  256.  
  257.     Pal-Announce - Announcements concerning the Public Ada Library
  258.       (PAL).  These include additions to, changes to and other
  259.       announcements concerning the PAL.  You can not post messages here.
  260.  
  261.     Ada-Train - This list is for the discussion of topics concerning Ada
  262.       training and education.  This is a general discussion list.
  263.  
  264.     EducationWG - This list is a bidirectional mailing list for those
  265.       people interested in participating in the Education Working group
  266.       of ACM/SIGAda.  It is used to exchange information about the
  267.       activities of the working group and coordinate those activities.
  268.  
  269.     Reuse - This list is a bidirectional mailing list for those people
  270.       interested in software reuse technology.  This includes, but is
  271.       not limited to, the fields of designing for reuse, object-oriented
  272.       reuse methods, reuse tools and environments, generic code
  273.       architectures, domain-specific kits, reuse education, technology
  274.       transfer, formal methods, certification of reusable components,
  275.       and management issues as they pertain to reuse.
  276.  
  277.     ReuseWG - This list is a bidirectional mailing list for those people
  278.       interested in participating in the Reuse Working Group of
  279.       ACM/SIGAda.  It is used to exchange information about the
  280.       activities of the working group and coordinate those activities.
  281.  
  282. =======================================================
  283. How Can I Find Out About the Status of WUARCHIVE?
  284. Last Update: June 21, 1993
  285.  
  286. Operational status changes (such as planned downtime and enhancements to
  287. service) for wuarchive.wustl.edu are announced over the
  288. wuarchive-announce mailing list.  You can sign up by sending an email
  289. message to:
  290.  
  291.   listserv@wunet.wustl.edu
  292.  
  293. which contains:
  294.  
  295.   help
  296.   subscribe wuarchive-announce
  297.  
  298. as the body (not subject) of the email message.
  299.  
  300. =======================================================
  301. Last Update: June 21, 1993
  302.  
  303. An announcement list (PAL-ANNOUNCE) for users of the Public Ada Library
  304. (PAL) has been set up on wunet.wustl.edu (note that this host is NOT
  305. wuarchive.wustl.edu).  The purpose of PAL-ANNOUNCE is to distribute
  306. information on additions to the PAL, changes to the PAL, and other
  307. announcements of interest to the users of the Public Ada Library.
  308. PAL-ANNOUNCE is an announcement-only list and will not accept general
  309. postings for redistribution.
  310.  
  311. If you wish to subscribe to PAL-ANNOUNCE, send an electronic mail
  312. message to:
  313.  
  314.   listserv@wunet.wustl.edu
  315.  
  316. Leave the subject line blank and place the following line into the body
  317. of this message:
  318.  
  319.   subscribe pal-announce
  320.  
  321. Begin this line in column 1.  Your return address will be used as the
  322. address to which announcements will be sent.
  323.  
  324. You will receive a message back from the listserv software, telling you
  325. of the success or failure of your request.
  326.  
  327. After you have subscribed, you may wish to send another message to the
  328. listserv address, placing the following line into the body of the
  329. message:
  330.  
  331.   help
  332.  
  333. This will result in instructions on the use of the listserv software
  334. being sent back to you.
  335.  
  336. =======================================================
  337. Last Update: June 24, 1993
  338.  
  339. An interactive discussion list (ADA-TRAIN) for Ada educators and
  340. trainers has been set up on wunet.wustl.edu (note that this host is NOT
  341. wuarchive.wustl.edu).  The purpose of ADA-TRAIN is to foster discussion
  342. about both Ada training and education.  This list was set up with
  343. college and university professors, corporate education and training
  344. services, commercial education and training services, government
  345. education and training services, and high school teachers in mind, but
  346. anyone in general is welcome to participate.  ADA-TRAIN is further
  347. supported by the Public Ada Library (PAL) on WUARCHIVE, and the PAL will
  348. act as a medium for file and general information exchange between the
  349. participants. Anyone may send electronic mail to ADA-TRAIN, and email
  350. received by ADA-TRAIN is automatically distributed to its subscribers.
  351.  
  352. If you wish to subscribe to ADA-TRAIN, send an electronic mail
  353. message to:
  354.  
  355.   listserv@wunet.wustl.edu
  356.  
  357. Leave the subject line blank and place the following line into the body
  358. of this message:
  359.  
  360.   subscribe ada-train
  361.  
  362. Begin this line in column 1.  Your return address will be used as the
  363. address to which announcements will be sent.
  364.  
  365. You will receive a message back from the listserv software, telling you
  366. of the success or failure of your request.
  367.  
  368. After you have subscribed, you may wish to send another message to the
  369. listserv address, placing the following line into the body of the
  370. message:
  371.  
  372.   help
  373.  
  374. This will result in instructions on the use of the listserv software
  375. being sent back to you.
  376.  
  377.  
  378. =======================================================
  379. What Documentation is Available to Help the PAL User?
  380. Last Update: June 21, 1993
  381.  
  382. The subdirectory userdocs in the PAL contains a number of documents of
  383. interest to the users of the PAL.  The key user documents in this
  384. subdirectory are:
  385.  
  386.   PAL.FAQ       -- the Frequently Asked Questions list
  387.   PALCAT.DOC    -- a softcopy catalog of the contents of the PAL
  388.   PALDB.DOC,    -- a Comma-Separated-Value (CSV) text file suitable
  389.     PALHDR.DOC     -- for reading by database managers and spreadsheets
  390.   PALTAX.DOC    -- a taxonomy of the PAL
  391.  
  392. Other files in the userdocs/catalog and userdocs/faqfile subdirectories
  393. are used to create these key files.  Additionally, the user is invited
  394. to look in the following directories for additional useful information:
  395.  
  396.   userdocs/alt_srcs    -- alternate sources to the items in the PAL
  397.   userdocs/internet    -- information on using the Internet
  398.  
  399. =======================================================
  400. How is PAL Like a Conventional Library?
  401. Last Update: June 21, 1993
  402.  
  403. Many similarities can be drawn between the Public Ada Library (PAL) on
  404. the WUARCHIVE.WUSTL.EDU host computer and a conventional library.  These
  405. similarities include:
  406.   . the way users browse through the libraries,
  407.   . the availability of a catalog of the contents of the libraries,
  408.   . the availability of reviews of the items in the libraries,
  409.   . the availability of bulletin boards to find out what is new, and
  410.   . the availability of support to help you use the libraries.
  411.  
  412. In a conventional library, you can walk into the library and walk
  413. amongst the books, picking them off the shelves as you wish.  In the
  414. PAL, you can FTP into it and move amongst the directories (via the CD
  415. command), copying files out of PAL as you wish.  You could also mount
  416. the disk containing PAL via NFS and access it like any read-only disk,
  417. again copying files out of PAL as you wish.  There is one significant
  418. drawback to this approach: by picking up an item "at random," you may
  419. miss other items which are prerequisites to the one you selected.  The
  420. catalog (a card catalog in a conventional library or the PAL catalog in
  421. the PAL) can help you avoid this problem.
  422.  
  423. In a conventional library, you can go up to the card catalog and look
  424. for what you are interested in by topic.  In the PAL, you can copy down
  425. the catalog file and browse through it at your convenience or you can
  426. copy down the online database files, load them into a database manager
  427. or spreadsheet of your choice, and browse through them in that fashion.
  428.  
  429. In a conventional library, there are books you can examine which are
  430. reviews of other books.  In the current PAL, the catalog includes REVIEW
  431. CODES to give you a brief review of an item.  CMM files are also
  432. available occasionally.  In phase 2 of the PAL, there will be review
  433. reports generated by automated tools.
  434.  
  435. In a conventional library, there are bulletin boards and other places
  436. where you can go to find out about the new releases.  In the PAL, there
  437. are release notices, currently being posted to comp.lang.ada.
  438.  
  439. Finally, in a conventional library, there is a reference librarian you
  440. can speak to if you have a question.  In the PAL, there is only me at
  441. this time, and I can be reached via electronic mail.  However, there are
  442. also the alternate sources of the PAL, particularly AdaNET.  I ask that
  443. you try to exhaust all the other possibilities before contacting me
  444. directly. Instead, please subscribe to a service like AdaNET (which is
  445. currently free to you).  They are providing a mirror of the PAL and they
  446. support their users via electronic mail and customer support telephone
  447. line, including an 800 telephone number.
  448.  
  449. =======================================================
  450. Is the Software in PAL Free of Defects?
  451. Last Update: June 21, 1993
  452.  
  453. The software in the PAL is an outstanding collection from all over the
  454. world, but it comes with a warning: like any such collection, there are
  455. outstanding items, good items, average items, and poor items.  This
  456. software contains items which are really useful, items which you cannot
  457. live without, and items which simply may not work in your environment. 
  458. So you, as a user, must not come into this thinking that everything is
  459. perfect.
  460.  
  461. So how do you know in advance what software is good and what is bad?
  462. Study.  This problem has come up over and over again with the Ada
  463. Software Repository (ASR), and I answered this by adding a REVIEW CODE
  464. field to all the items in the ASR Master Index.  Chapter 1 of the Master
  465. Index gives the keys for this field (e.g., CS means Compiled
  466. Successfully, ES means Executed Successfully, NR means Not Rated (I
  467. don't know if it is good or bad), etc.).  Every item in the Master Index
  468. book has an associated REVIEW CODE field.  Look at this when you
  469. consider using the item.  Also, look for Comment (CMM) files throughout
  470. the ASR.  They tell success/problem stories.  They are text files, so
  471. you can just read them.  Finally, if you find an item marked with a CS
  472. and ES, note the compilers/platforms noted with this mark (e.g., CS(DEC
  473. Ada), etc.). If a number of compilers/platforms are named, you probably
  474. have a very portable item.
  475.  
  476. The PAL has a document called the PAL Catalog (similar in nature to the
  477. Master Index of the ASR).  The PAL Catalog has a similar REVIEW CODE
  478. field, and CMM files are also support in the PAL.  In phase 2 of the
  479. PAL, one or more automated static code analysis tools will be used to
  480. analyze the Ada source code in the PAL and report on it.
  481.  
  482. =======================================================
  483. How Do I Handle the Various Types of FIles in PAL?
  484. Last Update: November 14, 1993
  485.  
  486. A number of file formats have come into play among the files in the PAL,
  487. and this document is designed to bring them to your attention.
  488.  
  489. Text Files
  490. ==========
  491. There are two basic kinds of ASCII text files: MSDOS format and UNIX
  492. format.  The difference is that lines in MSDOS format files are
  493. terminated by a pair of characters (carriage return and line feed)
  494. while lines in UNIX format files are terminated by a single character
  495. (line feed).  Occasionally, MSDOS format files will also have one or
  496. more ^Z characters at their end, but this is becoming more and more
  497. rare.
  498.  
  499. Consequently, if you are on a UNIX system and want to process an MSDOS
  500. text file, there may be problems.  Likewise if you are on an MSDOS
  501. system trying to process a UNIX text file.  In the toolkit directory
  502. are the programs
  503.  
  504.   u2m   -- unix to msdos text file format converter
  505.   m2u   -- msdos to unix text file format converter
  506.   t2t   -- whatever to current text file format converter
  507.  
  508. The toolkit directory includes executables of these programs for MSDOS.
  509. Source code is also included for others.  The t2t program also has a -c
  510. option that can be used to test a text file to determine what kind of a
  511. text file it is.  You may find these programs to be very useful.
  512.  
  513. As a rule, the text files in the PAL are UNIX text files.
  514.  
  515. PAGER2 Files
  516. ============
  517. PAGER2 files are UNIX or MSDOS text files created by the PAGER2 program
  518. in the PAL.  They have a file type of SRC (altho not all SRC files are
  519. necessarily PAGER2 files).  PAGER2 is used to concatenate a number of
  520. Ada source files into one file, where each component file is separated
  521. by a special Ada comment.  That way, Ada source files can be stored in a
  522. single SRC file in compilation order and compiled as one group.  The
  523. pager2 program can be found in the toolkit directory.
  524.  
  525. ZIP Files
  526. =========
  527. These are binary archive files, usually containing a set of files in a
  528. directory tree structure that will be reproduced when the files are
  529. extracted.  The toolkit directory contains the source code to popular
  530. ZIP and UNZIP programs supported by the Info-ZIP Internet group.
  531.  
  532. GNU ZIP Files
  533. =============
  534. These are compressed binary files, usually containing one file that
  535. is reproduced when the GUNZIP program is run.  The toolkit directory
  536. contains the executables and source code to the GNU ZIP (GZIP) and
  537. GNU UNZIP (GUNZIP) programs supported by the Free Software Foundation.
  538. The GNU ZIP and Info-ZIP file formats are different.
  539.  
  540. TAR Files
  541. =========
  542. These are text/binary archive files, usually containing a set of files
  543. like a ZIP file.  TAR (Tape Archiver) came from the UNIX world, and the
  544. toolkit directory contains a TAR.EXE program so MSDOS users can get at
  545. and extract files from TAR files.
  546.  
  547. Compressed (*.Z) Files
  548. ======================
  549. The compress/uncompress program pair came from the UNIX world for file
  550. compression purposes.  The toolkit directory includes an UNCOMP.EXE
  551. program for uncompressing UNIX *.Z files on a PC.  With ZIP on PCs
  552. (and now on virtually all other platforms), compress is less and less
  553. necessary since ZIP automatically compresses as it stores.
  554. Files named *.taz are compressed *.tar files; uncompress them
  555. first, then use tar to extract their contents.
  556.  
  557. WARNING: *.tar files may contain directory or file names that are not
  558. compatible with your operating system.  For example, the tar file may have
  559. originally been created on a UNIX system and you are trying to extract its
  560. contents on an MSDOS system.  The MSDOS tar program may correctly shorten
  561. the file and directory names, but if there are conflicts, files may be
  562. overwritten.  Watch out for this potential problem.
  563.  
  564. Compressed or GNU ZIPped TAR Files
  565. ==================================
  566. The TAR files are frequently compressed by either using the UNIX
  567. COMPRESS program or the GNU ZIP program.  The resulting compressed
  568. TAR files are named filename.tar.Z and filename.tar.gz, respectively.
  569. To maintain compliance with ISO-9660 file name requirements, the
  570. file types *.taz and *.tgz are used to indicated compressed tar and
  571. GNU ZIPped tar files, respectively:
  572.  
  573.   Original File Name   ... is equivalent to ...   PAL File Name
  574.   ==================                              =============
  575.   filename.tar.Z                                  filename.taz
  576.   filename.tar.gz                                 filename.tgz
  577. =======================================================
  578. How Can I Get to the Items in the PAL?
  579. PAL Alternate Sources Tree
  580. Richard Conn, 8 June 1993
  581. conn@wuarchive.wustl.edu
  582.  
  583. The PAL can be accessed directly via FTP and NFS to the
  584. wuarchive.wustl.edu host computer.  For users interested in a general
  585. background on the Internet and the techniques for using FTP and NFS, see
  586. the PAL subdirectory userdocs/internet for documentation and pointers to
  587. books.
  588.  
  589. This userdocs/alt_srcs tree contains information about companies and
  590. organizations that provide support in some way to the PAL user community
  591. through value-added services and products.  Some users of PAL may not
  592. have access to PAL directly via FTP and NFS, so the following
  593. information is presented to help them find alternate ways of accessing
  594. the PAL.
  595.  
  596. Examples of such services are:
  597.   1. The donation of equipment to Washington University at St. Louis
  598.      that is used by PAL
  599.   2. The sale of consulting services to the PAL user community to answer
  600.      questions about PAL and help users locate items they are looking for
  601.      in PAL or other resources
  602.  
  603. Examples of such products are:
  604.   1. The sale of CDROMs, magnetic tapes, floppy disks, etc., that contain
  605.      a copy of PAL in an alternate form, making it possible for people
  606.      who do not have Internet or email archive server access to obtain
  607.      a copy of the items in PAL
  608.   2. The sale of computer accounts that place users on the Internet so
  609.      they can access PAL
  610.  
  611. Companies and organizations wishing to be added to this tree are invited
  612. to send email describing their services or products to me at the above
  613. email address. I will work with them to provide "free advertising" space
  614. in PAL under this tree so users of PAL can be made aware of their
  615. services and products.  I reserve the right to edit material provided by
  616. these companies in the event that this material violates some known law,
  617. public sensibilities, or the like.
  618.  
  619.   ============================================
  620.   File: /archive/languages/ada/userdocs/alt_srcs/adanet.txt
  621.                      AdaNET Service Version Three (ASV3)
  622.                               a component of
  623.             Repository Based Software Engineering (RBSE) Program 
  624.   
  625.                              Administered by:
  626.                      University of Houston - Clear Lake
  627.   
  628.        Operated by:                        AdaNET Client Service:
  629.        MountainNet, Inc.                   1-800-444-1458
  630.        2705 Cranberry Square               lacey@rbse.Mountain.Net
  631.        Morgantown, WV 26505
  632.   
  633.   
  634.        The AdaNET repository contains PAL software and more.  In 
  635.        addition, our Phased Certification Process provides Ada
  636.        software with value-added analysis reports, including
  637.        complexity reports, declaration tree reports and invocation
  638.        tree reports. Our non-software information includes research 
  639.        papers, standards and technical reports authored by recognized,
  640.        authoritative sources on software engineering principles and
  641.        practices.
  642.   
  643.        Our Client Service team provides timely response to requests
  644.        for any component in print or electronic media.  Clients can 
  645.        have qualified software engineers and librarians to assist in
  646.        locating AdaNET and/or PAL components that satisfy their needs.  
  647.        All of our services are free of charge.
  648.   
  649.        AdaNET clients automatically receive an account on our host
  650.        which is connected to Internet.  While this does not provide
  651.        full Internet access, Internet e-mail facilities are available.
  652.   
  653.        Lastly, MountainNet provides a service, MountainNetWorks, 
  654.        which offers Internet access at a reasonable rate for 
  655.        individuals and groups.
  656.   
  657.   ============================================
  658.   File: /archive/languages/ada/userdocs/alt_srcs/archie.txt
  659.   Getting Started with Archie
  660.   Derived from: HELP for the archie email server, as of 10 April, 1993.
  661.   
  662.   To get started with using archie to retrieve files from the Public
  663.   Ada Library (or any of about 800 archives on the Internet, for that
  664.   matter), send an email message with a subject of "help" and a body
  665.   of "help" (no quotes in either the subject or body) to:
  666.   
  667.       archie@<archie_server>
  668.   
  669.   <archie_server> is the name of an archie host. The current (and
  670.   complete) list of archie servers can be found with the "servers" command
  671.   (described in the help message). A sample list is:
  672.   
  673.       archie.rutgers.edu   128.6.18.15     (USA)
  674.       archie.unl.edu       129.93.1.14     (USA)
  675.       archie.sura.net      128.167.254.179 (USA)
  676.       archie.ans.net       147.225.1.2     (USA)
  677.       archie.au            139.130.4.6     (Australia)
  678.       archie.funet.fi      128.214.6.100   (European server in Finland)
  679.       archie.sogang.ac.kr  163.239.1.11    (Korea)
  680.   
  681.   If you do not get mail back within 2 days or so, try using one of the
  682.   other archie sites.
  683.   
  684.   ============================================
  685.   File: /archive/languages/ada/userdocs/alt_srcs/cnam.txt
  686.   The server ftp.cnam.fr (in France) is now a mirror site for the Public
  687.   Ada Library.  Its current address is 163.173.128.6 (but this may change).
  688.   
  689.   This mirror site is available to all who want to access the PAL, but it
  690.   is particularly useful to those in Europe.  Some statistics on it:
  691.   
  692.   ftp.cnam.fr is a VAX 6000/510 with Ultrix 4.3.  It uses a Renater +
  693.   Ebone network with a 2 Mbit/second line.
  694.   
  695.   The /pub directory contains:
  696.   
  697.   total 30
  698.   drwxr-xr-x  9 root          512 Sep 23 19:08 .
  699.   drwxr-xr-x  7 root          512 Sep 14 08:28 ..
  700.   drwxr-xr-x  5 bortz         512 Sep 24 10:02 Ada
  701.   drwxr-xr-x  4 root          512 Sep 12 14:26 CNAM
  702.   drwxr-xr-x  2 douin         512 Sep 23 19:08 Modulog
  703.   drwxr-xr-x  3 bortz         512 Sep 12 14:26 Network
  704.   drwxr-xr-x  2 bortz       22528 Sep 18 13:12 Rfc
  705.   drwxr-xr-x  3 bouroche      512 Sep 12 14:25 VMS
  706.   drwxrwxrwt  4 root          512 Sep 23 19:05 incoming
  707.   
  708.   And the /pub/Ada:
  709.   
  710.   total 7
  711.   drwxr-xr-x  5 bortz         512 Sep 24 10:02 .
  712.   drwxr-xr-x  9 root          512 Sep 23 19:08 ..
  713.   drwxr-xr-x 29 bortz        1024 Sep 12 17:33 AJPO
  714.   lrwxr-xr-x  1 bortz          18 Sep 24 10:01 Ada-Ed -PAL/compiler/adaed
  715.   drwxr-xr-x  2 bortz         512 Sep 12 14:32 CNAM
  716.   drwxr-xr-x 14 bortz         512 Sep 23 19:27 PAL
  717.   lrwxr-xr-x  1 bortz           7 Sep 24 10:02 Repository -PAL/ASR
  718.   
  719.   So the complete path to PAL is ftp.cnam.fr:/pub/Ada/PAL.
  720.   
  721.   They mirror it automatically every Monday at 11 am, local time (UT + 1 or
  722.   UT + 2, depending on the season).
  723.   
  724.   They use the WU ftp server and log every transfer so they can provide stats.
  725.   
  726.   They also mirror the AJPO host (/pub/Ada/AJPO).
  727.   
  728.   Thanks very much to Stephane and the others working with and supporting him
  729.   for this service:
  730.   
  731.   Stephane Bortzmeyer           Conservatoire National des Arts et Metiers
  732.   bortzmeyer@cnam.cnam.fr       Laboratoire d'Informatique
  733.                                 292, rue Saint-Martin            
  734.   tel: +33 (1) 40 27 27 31      75141 Paris Cedex 03
  735.   fax: +33 (1) 40 27 27 72      France    
  736.   ============================================
  737.   File: /archive/languages/ada/userdocs/alt_srcs/decus.txt
  738.   CDROMs from DECUS
  739.   
  740.   The Digital Equipment Computer Users' Society (DECUS) is in the
  741.   process of systematically making CDROMs of the entire WUARCHIVE,
  742.   including the Public Ada Library (PAL).  I have been advised that
  743.   DECUS intends to create new versions periodically.
  744.   
  745.   You can get an application for membership in the DECUS U.S. Chapter by
  746.   calling (508) 841-3500.
  747.   
  748.   Sites which wish to get DECUS CDROMs should contact their DECUS Local
  749.   User Group or the DECUS Library at:
  750.   
  751.       DECUS Library
  752.       333 South St, SHR1-4/D33
  753.       Shrewsbury, MA  01545-4112
  754.   
  755.       (508) 480-3418 / (508) 480-3659 / (508) 480-3446
  756.   
  757.   When contacting DECUS, be sure to check on the date of the CDROM
  758.   release.
  759.   
  760.   Richard Conn
  761.   Manager, PAL
  762.   
  763.   ============================================
  764.   File: /archive/languages/ada/userdocs/alt_srcs/ftpmail.txt
  765.   Anonymous FTP via Electronic Mail
  766.   Derived from: HELP for the archie email server, as of 10 April, 1993.
  767.   
  768.   Anonymous FTP may be performed through the mail by various ftp-mail
  769.   servers. Send a message with the word 'help' in it to:
  770.   
  771.   For BITNET/EARN sites ONLY:
  772.   
  773.           bitftp@pucc.princeton.edu
  774.   
  775.   or (general access):
  776.   
  777.           ftpmail@decwrl.dec.com
  778.   
  779.   for an explanations on how to use them.
  780.   
  781.   ============================================
  782.   File: /archive/languages/ada/userdocs/alt_srcs/rational.txt
  783.   Rational is now offering an online news distribution service that provides 
  784.   information --press releases, case studies, and so on-- to the general public
  785.   using electronic mail.  The news is available over the Internet to anyone
  786.   interested in receiving it.  Subscribers must have access to the Internet
  787.   for e-mail (either directly or via a gateway).
  788.   
  789.   Rational will distribute pertinent, timely information that is of interest 
  790.   to the Ada community.  The purpose of this service is to keep Ada 
  791.   community informed and up to date on Rational's latest product announcements 
  792.   and developments.
  793.   
  794.   If you would like to receive this information electronically, please contact 
  795.   Kara Myers at 408-496-3891 or karam@Rational.com with your e-mail address.
  796.   ============================================
  797.   File: /archive/languages/ada/userdocs/alt_srcs/wcreek.txt
  798.   The file wcreek.zip is a copy of most of the readme files in the
  799.   top-level directory of the Walnut Creek Ada CDROM.  This is also a copy
  800.   of the index tree from that CDROM, showing you in detail the contents of
  801.   the CDROM.
  802.   
  803.   Note: the omitted top-level readme files were omitted because they were
  804.   more of an operational bent than an informational bent, and, as someone
  805.   who wants to know what is on the CDROM, I restricted this blurb of
  806.   information to a higher level of detail.
  807.   
  808.   This information is provided as a service to the PAL user community.
  809.   Users should be able to determine if they wish to acquire the CDROM from
  810.   this information.  To some users, acquisition of this CDROM would also
  811.   require the acquisition of a CDROM reader.  It is hoped that this
  812.   information will allow them to adequately judge the value of the CDROM
  813.   to them before expending the funds for such a purchase.
  814.   
  815.   People who have made a contribution of a significant item on this CDROM
  816.   are entitled to a free copy of the CDROM.  I personally find this to be
  817.   a very generous offer on the part of Walnut Creek, but, as a contributor
  818.   to PAL who also wants to see efforts like Walnut Creek succeed, I chose
  819.   to purchase their CDROM anyway.  However, their offer stands, and it is
  820.   up to you.
  821.   
  822.   People who wish to examine the contents of the CDROM via the Internet
  823.   may access cdrom.com via anonymous FTP.  Follow the instructions in the
  824.   signon messages.
  825.   
  826.   The price of the Ada CDROM is $39.95.  Quantity discounts are available
  827.   starting in lots of 10 CDROMs.  Contact Walnut Creek for details. As
  828.   always, shipping, handling, and sales tax are extra when you consider
  829.   the final price.
  830.   
  831.   For further information contact:
  832.     Walnut Creek CDROM
  833.     4041 Pike Lane, Suite E
  834.     Concord, CA  94520
  835.     800/786-9907 or 510/674-0783
  836.     FAX 510/674-0821
  837.     Email info@cdrom.com
  838.   
  839.   This information was last updated on 8 June 1993.
  840.   
  841.   Richard Conn
  842.   Manager, ASR and PAL
  843.   
  844. =======================================================
  845. How Do I Work with ZIP Files and MAC Binary Files in the PAL from my MAC?
  846. Last Update: June 29, 1993
  847.  
  848. See the file mbin*.abs (a text file) in the PAL toolkit directory.
  849. There is a program for converting binary images in the PAL into Mac
  850. Binary format.  There are also ZIP and UNZIP programs for the Mac.
  851.  
  852. Thanks to Mike Feldman for his support in this matter.
  853.  
  854. =======================================================
  855. How Can I Submit an Item to the PAL?
  856. Last Update: June 21, 1993
  857.  
  858. Contact Richard Conn at
  859.  
  860.   conn@wuarchive.wustl.edu
  861.  
  862. if you wish to submit an item to the PAL.  Several different mechanisms
  863. are in place for making a submission, including direct FTP into the PAL
  864. (which is by far the easiest from my point of view).  I will ask you to
  865. fill out an Item Description (ID) file which describes the item you are
  866. submitting.  Once the item is on WUARCHIVE and I have your filled-out
  867. ID file, I can take it from there.
  868.  
  869. =======================================================
  870. What Copies and Mirrors of Repositories Exist in the PAL?
  871. Last Update: November 14, 1993
  872.  
  873. The Public Ada Library (PAL) contains copies and mirrors of the
  874. following repositories.  These copies and mirrors are duplicated (except
  875. as noted) in the indicated directory trees.
  876.  
  877.   Repository                  PAL Directory Tree   Class
  878.   =======================     ==================   =====
  879.   Ada Software Repository     languages/ada/ASR    Copy
  880.    on WSMR-SIMTEL20.ARMY.MIL
  881.  
  882.   AJPO Repository on          languages/ada/ajpo   Mirror
  883.    AJPO.SEI.CMU.EDU
  884.  
  885.   VHDL Repository on          languages/vhdl       Mirror
  886.    UCENG.UC.EDU
  887.  
  888. A COPY is a duplicate of the directory structure of an external system
  889. with some modification.  Updates to the COPY are made manually. A MIRROR
  890. is a duplicate of the directory structure of an external system with no
  891. modification.  Updates to the MIRROR are controlled by the manager of
  892. the external system.  As changes are made to the external system, the
  893. mirror in the PAL is updated automatically each day.
  894.  
  895. Copies of parts of other external systems are made from time to time (as
  896. items are added to the Software Reuse Repository at
  897. gandalf.umcs.maine.edu or to the Asset Source for Software Engineering
  898. Technology at source.asset.com, for example), but these do not count as
  899. copies or mirrors since the external directory structure is not
  900. duplicated.
  901.  
  902.