home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / general / welcome.doc < prev    next >
Encoding:
Text File  |  1988-05-03  |  36.9 KB  |  1,105 lines
  1. ----> WELCOME.PRO, Version 1.0 <----
  2.  
  3.            WELCOME TO THE ADA SOFTWARE REPOSITORY ON SIMTEL20
  4.  
  5.         You are now on the ADA-SW mailing list, through which users of
  6. the Ada Software Repository (ASR) communicate with each other.
  7.  
  8.         This message is an introduction to the Ada Software Repository
  9. (ASR).  A copy of this message is kept in PD2:<ADA.GENERAL>WELCOME.DOC
  10. if you want to see it again or copy it for other uses.  Feel free to
  11. distribute this message and any other files in PD2:<ADA.GENERAL> that
  12. you wish to take.  You may publish these files (in PD2:<ADA.GENERAL>)
  13. in any newsletter or commercial publication you desire without
  14. restriction.
  15.  
  16.         This message contains the following files:
  17.  
  18.     
  19. FILE                    CONTENTS
  20.  
  21. PD2:<ADA.GENERAL>NAMING.DOC        File/Directory Naming
  22. PD2:<ADA.GENERAL>ADAREPOS.DOC        Overview of Repository
  23. PD2:<ADA.GENERAL>AAREAD.ME        Pointers to Answers to Common Questions
  24. PD2:<ADA.GENERAL>OPERATE.DOC          Statement of Operation
  25. PD2:<ADA.GENERAL>MLIST.DOC        About the ADA-SW Mailing List
  26. PD2:<ADA.GENERAL>FINDME.DOC             How to Find Things
  27. PD2:<ADA.GENERAL>DIRLIST.DOC        Summary of ADA Directories
  28. PD2:<ADA.GENERAL>TAPEDIST.DOC        Acquiring Magtape of Repository
  29. PD2:<ADA.GENERAL>FLOPDIST.DOC        Acquiring IBM PC Floppies of Repository
  30. PD2:<ADA.GENERAL>FTPDIST.DOC        Acquiring Files via FTP
  31. PD2:<ADA.GENERAL>UUCPBIT.DOC        For USENET (UUCP) and BITNET Users
  32. PD2:<ADA.GENERAL>NEWSLTR.DOC        About the ASR Newsletter
  33. PD2:<ADA.GENERAL>INDEX.DOC        About the ASR Master Index
  34. PD2:<ADA.GENERAL>ASRSUPP.DOC        The Supporting Contractor of the ASR
  35.     
  36.  
  37.         Welcome to the Ada Software Repository on SIMTEL20!
  38.  
  39.     
  40.                 Richard Conn
  41.                 Manager, Ada Software Repository
  42. ----> NAMING.DOC, Version 1.0 <----
  43.  
  44.     FILE AND DIRECTORY NAMING CONVENTIONS ON SIMTEL20
  45.  
  46.     SIMTEL20 is a DEC 20 host computer which runs the TOPS-20
  47. operating system.  This file briefly describes the file and directory
  48. naming conventions under TOPS-20; this is not a complete description,
  49. but it should be enough to allow you to work with the software
  50. repositories on SIMTEL20.
  51.  
  52.  
  53. 1. Directory Names
  54. ------------------
  55.  
  56.     Directory names in the various software repositories on
  57. SIMTEL20 take the general forms of:
  58.  
  59.     disk:<directory_name>
  60. and    disk:<directory_name.subdirectory_name>
  61.  
  62.     All software repositories reside on the disks named PD1 and
  63. PD2 (for Public Domain 1 and 2).  Case is not signficant.
  64.  
  65.     Examples of directory names:
  66.  
  67.         PD2:<ADA> or pd2:<ada>
  68.             -- top level of the Ada Software Repository
  69.         PD2:<ADA.GENERAL>
  70.             -- the GENERAL subdirectory under the ASR
  71.  
  72.  
  73. 2. File Names
  74. -------------
  75.  
  76.     File names under TOPS-20 are of the following general forms:
  77.  
  78.         file_name.file_type.version_number
  79.  
  80.     Both the file name and file type fields are not case
  81. sensitive.  Each field can be quite long, but, as a general rule, the
  82. file name field is restricted to 9 characters (the first 6 are unique)
  83. and the file type field is restricted to 3 characters; this is to
  84. enhance transportability between different operating systems.  The
  85. version number field is optional when referencing a file; if omitted,
  86. the latest version of the file is referenced.
  87.  
  88.     Examples of file names:
  89.  
  90.         MYFILE.TXT
  91.         ADA-SW.NOT
  92.  
  93.  
  94. 3. Full File Reference
  95. ----------------------
  96.  
  97.     Directory names and file names may be concatenated in order to
  98. provide a complete reference to a file.  When referencing a file in
  99. the current directory, the file name may be omitted.  Examples:
  100.  
  101.         PD2:<ADA>ADA.CRC
  102.         PD2:<ADA.GENERAL>WELCOME.DOC
  103.  
  104. ----> ADAREPOS.DOC, Version 1.0 <----
  105.  
  106.     THE ADA SOFTWARE REPOSITORY (ASR) ON SIMTEL20
  107.  
  108.         A repository of Ada programs, software components, and
  109. educational material has been established on the SIMTEL20 host
  110. computer on the Defense Data Network.  This repository has been
  111. accessible to any host computer on the network since November 26,
  112. 1984.
  113.  
  114.         This repository provides a free source for Ada programs and
  115. information.  By employing the File Transfer Protocol (FTP) program,
  116. users of DDN hosts are able to scan the directories of the repository
  117. and transfer files to their hosts.  If the files are Ada programs,
  118. they may then compile these programs and use them as they desire.
  119. Modifying these programs may be within their rights, and they may
  120. freely distribute these programs within and without the DoD as they
  121. desire, subject to the restrictions specified for each piece of
  122. software in its prologue.
  123.  
  124.         The Ada Software Repository is divided into several
  125. subdirectories.  These directories are organized by topic, and their
  126. names and a brief overview of their topics are contained in the file
  127. DIRLIST.DOC in PD2:<ADA.GENERAL>.
  128.  
  129.         The Ada Software Repository on SIMTEL20 serves two basic
  130. roles: to promote the exchange and use (reusability) of Ada programs
  131. and tools (including components) and to promote Ada education
  132. (especially by providing several working examples of programs in
  133. source form for people to study and modify).
  134.  
  135.         All members of the Ada community are encouraged to freely
  136. extract information and programs from the repository as well as make
  137. contributions to it.  The only restrictions which apply to the access
  138. and use of this software are presented in the "Distribution and
  139. Copyright" section of the prologue associated with each piece of
  140. software.
  141.  
  142. ----> AAREAD.ME, Version 1.0 <----
  143.  
  144.         ADA SOFTWARE REPOSITORY ON SIMTEL20
  145.     COMMONLY ASKED QUESTIONS AND WHERE TO FIND THE ANSWERS
  146.  
  147.         The following is a collection of questions and the names of
  148. files which contain complete or partial answers to these questions.
  149. Unless otherwise noted, these files are contained in PD2:<ADA.GENERAL>.
  150.  
  151.     
  152. QUESTION                        FILES
  153.  
  154.  1. What is the Ada Repository on SIMTEL20?        ADAREPOS.DOC, AAREAD.ME
  155.                             WELCOME.PRO
  156.  
  157.  2. How do I Access the Ada Repository?            FTP.DOC, UUCPBIT.DOC
  158.                             TAPEDIST.DOC,
  159.                             FLOPDIST.DOC,
  160.                             FTPDIST.DOC
  161.  
  162.  3. How do I Find Out What is in the Ada Repository?    FINDME.DOC, MLIST.DOC
  163.                             DIRLIST.DOC,NEWSLTR.DOC
  164.                             INDEX.DOC
  165.  
  166.  4. How do I Submit Software and other Items to the
  167.      Ada Repository?  How do I Modify and Resubmit
  168.      Software that is already in the Ada Repository?    SUBMIT.DOC,CHECKOUT.DOC
  169.  
  170.  5. How do I Contact the Repository Maintainer and
  171.      other Users of the Repository?            MLIST.DOC
  172.  
  173.  6. How do I get Started with Using the Ada
  174.      Repository?                    WELCOME.DOC, MLIST.DOC
  175.                             INDEX.DOC, NAMING.DOC
  176.  
  177.  7. How do I Contact the Authors of Software in
  178.      the Ada Repository?                PROLOGUE.DOC,SUBMIT.DOC
  179.  
  180. ----> OPERATE.DOC, Version 1.0 <----
  181.  
  182.     STATEMENT OF OPERATION - ADA SOFTWARE REPOSITORY
  183.  
  184.     The Ada Software Repository is a public-domain collection of
  185. Ada software and information.  The Ada Software Repository is one of
  186. several repositories located on the SIMTEL20 Defense Data Network host
  187. computer at White Sands Missile Range in New Mexico.  SIMTEL20 is
  188. owned and operated by the Operations and Systems Integration Division
  189. of the Information Systems Command of the US Army.
  190.  
  191.     The Ada Software Repository is sponsored by the Operations and
  192. Systems Integration Division at White Sands Missile Range with
  193. additional funding provided by the STARS (Software Technology for
  194. Adaptable, Reliable Systems) Joint Program Office at the Pentagon.
  195.  
  196. Disclaimer
  197. ----------
  198.     All software, documentation, and other items of information in
  199. the Ada Software Repository are in the public domain.  These software,
  200. documentation, and information files are provided "AS IS" and without
  201. any expressed or implied warranties whatsoever.  No warranties as to
  202. performance, merchantability, or fitness for a particular purpose
  203. exist.
  204.     Because of the diversity of conditions and hardware under
  205. which this software may be used, no warranty of fitness for a
  206. particular purpose is offered.  The user is advised to test the
  207. software thoroughly before relying on it.  The user must assume the
  208. entire risk and liability of using this software.
  209.     In no event shall any person or organization of people be held
  210. responsible for any direct, indirect, consequential or inconsequential
  211. damages or lost profits.
  212.  
  213. ----> MLIST.DOC, Version 1.0 <----
  214.  
  215.     ADA-SW ELECTRONIC MAILING LIST
  216.  
  217.         An electronic mailing list exists for those who are interested
  218. in accessing and contributing software to the Ada Repository on
  219. SIMTEL20.  To subscribe to this mailing list, send a request via
  220. electronic mail to:
  221.     
  222.         ADA-SW-REQUEST@SIMTEL20.ARPA
  223.     
  224.         After you have been logged into the repository's mailing list,
  225. you will receive a welcome message which provides introductory
  226. information on how to access the repository.
  227.  
  228.         The mailing list serves two purposes: to help exchange
  229. information between the repository users and to mail repository
  230. submissions to the maintainer of the Ada Software Repository for
  231. inclusion in the archives.
  232.  
  233.         PS:<ARCHIVES.ADA-SW>ADA-SW-ARCHIV.TXT contains all recent
  234. messages passed over the ADA-SW mailing list.  New users on the list
  235. are invited to get a copy of this file and scan it for background;
  236. older users may use it for reference.  In either case, a WARNING: this
  237. is a BIG file!  PS:<ARCHIVES.ADA-SW>ADA-SW.ARCHIVE.ymmdd contains
  238. older messages by year/month.
  239.  
  240.         A hardcopy newsletter and other hardcopy documentation on the
  241. Ada Software Repository are published by Management Assistance
  242. Corporation of America (MACA).  Contact MACA for details:
  243.  
  244.         MACA 
  245.         PO Drawer 100 - Building T148
  246.         White Sands Missile Range, New Mexico  88002
  247.         Phone: 505/678-3288
  248.  
  249. If you phone, ask for Janet McKellar, David Moon, or Mannie Gamez.
  250.  
  251.  
  252. ADA-SW ADDRESSES
  253. ----------------
  254.  
  255.     If you wish to send a message to the entire ADA-SW reading
  256. list, address your message to:
  257.  
  258.         ADA-SW@SIMTEL20.ARPA
  259.  
  260.     If you wish to discuss an administrative matter, such as
  261. changing your mailing address on the ADA-SW email list, address your
  262. message to:
  263.  
  264.         ADA-SW-REQUEST@SIMTEL20.ARPA
  265.  
  266.     IF YOU SEND A MESSAGE TO ADA-SW, PLEASE REALIZE THAT YOUR
  267. MESSAGE WILL GO TO ALL THE READERS OF ADA-SW (THOUSANDS OF PEOPLE).
  268. USE THE ADA-SW ADDRESS WISELY -- DO NOT SEND ITEMS, SUCH AS YOUR
  269. ADDRESS CHANGES, TO ADA-SW IF THEY ARE NOT OF GENERAL INTEREST TO THE
  270. READERS.  THE ADA-SW-REQUEST ADDRESS IS FOR ADDRESS CHANGES AND THE
  271. LIKE.
  272. ----> FINDME.DOC, Version 1.0 <----
  273.  
  274.     HOW TO FIND THINGS IN THE ADA SOFTWARE REPOSITORY ON SIMTEL20
  275.  
  276.         The contents of the Ada Software Repository are organized in a
  277. number of different ways to make finding software and documentation
  278. easier for the user of the repository.  The following summarizes the
  279. information sources.
  280.  
  281.  
  282. WELCOME MESSAGE
  283.  
  284.         The Welcome Message is a text file which is sent to all new
  285. subscribers to the ADA-SW electronic mailing list.  This message
  286. contains introductory material on the Ada Software Repository, the
  287. operation and use of the Ada Software Repository, and the Defense Data
  288. Network.  The Welcome Message is stored in PD2:<ADA.GENERAL>WELCOME.DOC.
  289.  
  290.  
  291. SIMPLE DIRECTORY DISPLAYS
  292.  
  293.         FTP can provide most users with a directory display of all
  294. files in any of the archives in the Ada Software Repository.  See the
  295. following files for more information:
  296.  
  297.     
  298.         PD2:<ADA.GENERAL>ADAREPOS.DOC
  299.             -- general info on repository contents
  300.         PD2:<ADA.GENERAL>AAREAD.ME
  301.             -- archive structures
  302.         PD2:<ADA.GENERAL>DIRLIST.DOC
  303.             -- list of subdirectories
  304.         PD2:<ADA.GENERAL>FTPDIST.DOC
  305.         PD2:<ADA.GENERAL>FTP.DOC
  306.         PD2:<ADA.GENERAL>FTP1.DOC
  307.         PD2:<ADA.GENERAL>FTP2.DOC
  308.             -- introduction to FTP and file transfer
  309.     
  310.  
  311.  
  312. ONLINE DOCUMENTATION SYSTEM
  313.  
  314.         The directory PD2:<ADA.ONLINE-DOC> contains the source code (in
  315. Ada), instructions, and data base for the online documentation system.
  316. You can copy all of these files over to your host computer, compile
  317. the programs, and then run them to query the data base, which gives
  318. you data on each directory in the repository.  This data includes a
  319. brief description of the directory, a listing of its contents with
  320. file sizes, and descriptions of each program and piece of software in
  321. the directory.  The data base may be copied from SIMTEL20 from time to
  322. time as more software is added to the repository.
  323.  
  324.  
  325. NEWSLETTERS
  326.  
  327.         Newsletters are available in electronic form and placed in the
  328. directory PD2:<ADA.NEWS>.  They are also available in hardcopy form.
  329. See the file PD2:<ADA.GENERAL>NEWSLTR.DOC for details.
  330.  
  331.  
  332. MASTER INDEX
  333.  
  334.         A Master Index of all software and information in the Ada
  335. Software Repository is a 300+ page loose-leaf book is updated
  336. periodically as the repository grows.  See the file
  337. PD2:<ADA.GENERAL>INDEX.DOC for details.
  338.  
  339.  
  340. PROLOGUE FILES
  341.  
  342.         Each piece of software has an associated PROLOGUE file of type
  343. PRO (eg, SAFEIO.PRO) which contains the Ada Software Repository
  344. standard header.  See the file PD2:<ADA.GENERAL>PROLOGUE.DOC for more
  345. information.
  346.  
  347.  
  348. GENERAL
  349.  
  350.         The files in PD2:<ADA.GENERAL> contain information on what is
  351. in the Ada Software Repository, how to access and use the Ada Software
  352. Repository, and other items of interest to the community.
  353.  
  354.  
  355. TELEPHONE ASSISTANCE
  356.  
  357.     Questions about the Ada Software Repository may be answered by
  358. contacting the support contractor; see the file PD2:<ADA.GENERAL>ASRSUPP.DOC
  359. for details.
  360.  
  361. ----> DIRLIST.DOC <----
  362.  
  363.         The following presents a summary of the directories in the Ada
  364. Repository on SIMTEL20.
  365.  
  366.  
  367.  Ada
  368.  
  369. PD2:<ADA>
  370.  
  371.         This  is  the  top-level  directory.    The   names   of   the
  372. subdirectories  (*.DIRECTORY)  can  be  seen here.  The listing of all
  373. files in all subdirectories (ADA.CRCLST) is also stored  here.   Also,
  374. the  file  FILEUSE.DOC,  which  contains a listing of all files in the
  375. repository, ordered by frequency of  use  (popularity),  is  contained
  376. here.
  377.  
  378.  
  379.  Ada-SQL
  380.  
  381. PD2:<ADA.ADA-SQL>
  382.  
  383.         This   subdirectory   contains   files   associated  with  the
  384. development of a standard Ada DBMS interface (Ada/SQL)  based  on  the
  385. dpANS  Data  Base  Language  SQL.   It is anticipated that SQL will be
  386. adopted as the Air Force standard Relational data base query language.
  387.  
  388. .  
  389.  AI
  390.  
  391. PD2:<ADA.AI>
  392.  
  393.         This  subdirectory contains programs relating to the fields of
  394. artificial intelligence, such as expert systems, pattern  recognition,
  395. and heuristic analysis.
  396.  
  397.  
  398. .
  399.  ANSI-LRM
  400.  
  401. PD2:<ADA.ANSI-LRM>
  402.  
  403.         This subdirectory contains a machine-readable copy of the ANSI
  404. Version of the Ada Language Reference Manual (LRM).   The  files  were
  405. obtained   from   the  directory  <ADA-LSN>  on  ECLB,  and  the  file
  406. FTPFILES.SUB shows the FTP process used to copy the files over and the
  407. renaming that was done.
  408.  
  409.         Chapters 1-14 and Appendices A-F are  included  as  CHAPxx.DOC
  410. (like,  CHAP01.DOC  or  CHAPA.DOC).   Error files are also included as
  411. CHAPxx.ERR.    The   Foreword    (FOREWORD.DOC,    ERR),    Postscript
  412. (POSTSCRPT.DOC,  ERR),  and  Table of Contents (TOC.DOC) are included.
  413. INDEX.DOC contains the index.
  414.  
  415.  
  416. .
  417.  Benchmarks
  418.  
  419. PD2:<ADA.BENCHMARKS>
  420.  
  421.         This subdirectory contains various  Ada  compiler  benchmarks.
  422. Benchmarks submitted in conjunction with the NOSC tools are located in
  423. the Ada Repository BENCHMARKS directory.
  424.  
  425.  
  426. .
  427.  CAIS
  428.  
  429.         This  directory  contains  software associated with the Common
  430. APSE Interface Set (CAIS).
  431.  
  432.         The CAIS is defined in MIL-STD-CAIS.
  433.  
  434. .  
  435.  CAIS_Tools
  436.  
  437. PD2:<ADA.CAIS-TOOLS>
  438.  
  439.         This subdirectory contains tools which are compatable with and
  440. modified or implemented  to  run  under  the  CAIS  presented  in  the
  441. directory   PD2:<ADA.CAIS>.    These   tools   have  been  modified  or
  442. implemented by Mitre Corporation and internally funded by Mitre.
  443.  
  444. .  
  445.  Compilation_Order
  446.  
  447. PD2:<ADA.COMPILATION-ORDER>
  448.  
  449.         This subdirectory  contains  software  which  deals  with  the
  450. analysis of groups of Ada programs to determine the proper compilation
  451. order.  Other  information  pertaining  to  the  interrelationship  of
  452. software segments of a system may be obtained as well.
  453.  
  454.  
  455. .
  456.  Components
  457.  
  458. PD2:<ADA.COMPONENTS>
  459.  
  460.          This  is  the  components subdirectory.  Software components,
  461. including general-purpose  procedures,  packages,  and  generics,  are
  462. stored  here.  Examples are:  math packages, TERMCAP routines, generic
  463. linked list packages, and dynamic string packages.
  464.  
  465.  
  466. .
  467.  Cross_Reference
  468.  
  469. PD2:<ADA.CROSS-REFERENCE>
  470.  
  471.         This  subdirectory  contains  tools  which   generate   cross-
  472. reference listing of Ada programs.
  473.  
  474.  
  475. .
  476.  Data Base Management
  477.  
  478. PD2:<ADA.DBMS>
  479.  
  480.         This directory contains Ada software components  and  programs
  481. directly related to Data Base Management functions.
  482.  
  483. .  
  484.  DDN
  485.  
  486. PD2:<ADA.DDN>
  487.  
  488.         This subdirectory contains tools and components related to the
  489. Defense Data Network, its  file  transfer,  mail,  and  communications
  490. facilities.   Implementations  of  the TCP/IP communications protocol,
  491. the FTP file transfer tool, and the SMTP mail handler are included.
  492.  
  493.  
  494. .
  495.  Debuggers
  496.  
  497. PD2:<ADA.DEBUGGER>
  498.  
  499.     This subdirectory contains Ada source-level debuggers.  A
  500. Symbolic Debugger is included.
  501.  
  502. .
  503.  Editors
  504.  
  505. PD2:<ADA.EDITORS>
  506.  
  507.         This directory contains the source code and  documentation  on
  508. some text editors written in Ada.
  509.  
  510.  
  511. .
  512.  Education
  513.  
  514. PD2:<ADA.EDUCATION>
  515.  
  516.         This   is   the   education  subdirectory.   Sample  programs,
  517. tutorials, and online courseware are located here.
  518.  
  519.  
  520. .
  521.  External_Tools
  522.  
  523. PD2:<ADA.EXTERNAL-TOOLS>
  524.  
  525.         This subdirectory contains several miscellaneous  tools  which
  526. are  helpful  in  developing  Ada  code  but are not written in Ada or
  527. pertain to  specific  environments.   For  example,  an  Ada  language
  528. development interface for the EMACS editor can be found here.
  529.  
  530.  
  531. .
  532.  Forms_Generator
  533.  
  534. PD2:<ADA.FORMGEN>
  535.  
  536.         This  subdirectory  contains tools for the generation of forms
  537. for use by Ada programs.  The forms generator will display and  accept
  538. input  into  a  form  (in  a  screen-oriented  fashion via the virtual
  539. terminal) in such a way that this mechanism is transparent to the  Ada
  540. program  using  it.  Instead, the program simply reads fields from the
  541. form via procedure interfaces.
  542.  
  543.  
  544. .
  545.  General
  546.  
  547. PD2:<ADA.GENERAL>
  548.  
  549.         This  is  the  General   Information   subdirectory.    Notes,
  550. comments, usage information, and other data are stored here.
  551.  
  552.  
  553. .
  554.  Graphical_Kernel_System
  555.  
  556. PD2:<ADA.GKS>
  557.  
  558.         This   subdirectory   contains   routines  associated  with  a
  559. Graphical Kernel System.
  560.  
  561.  
  562. .
  563.  Management_Tools
  564.  
  565. PD2:<ADA.MANAGEMENT-TOOLS>
  566.  
  567.         This subdirectory contains tools for use in  managing  an  Ada
  568. software development project.  Status tracking and Manpower estimation
  569. tools are included.
  570.  
  571.  
  572. .
  573.  Math_Library
  574.  
  575. PD2:<ADA.MATH>
  576.  
  577.         This subdirectory contains packages  of  math  routines.   All
  578. routines are written in Ada.  Routines for trig functions, exponential
  579. functions, matrix  manipulation,  bit  manipulation,  and  others  are
  580. contained here.
  581.  
  582.  
  583. .
  584.  Menu
  585.  
  586. PD2:<ADA.MENU>
  587.  
  588.         This  subdirectory contains software used in the generation of
  589. menus.  Applications programs may use these menu generators as  front-
  590. ends.
  591.  
  592.  
  593. .
  594.  Message_Handling
  595.  
  596. PD2:<ADA.MESSAGE-HANDLING>
  597.  
  598.         This  subdirectory  contains tools for use in message handling
  599. facilities and message transfer.
  600.  
  601.  
  602. .
  603.  Metrics
  604.  
  605. PD2:<ADA.METRICS>
  606.  
  607.         This subdirectory  contains  tools  used  to  perform  metrics
  608. analysis  of  Ada  software.   Tools  for  path  analysis, performance
  609. analysis, and other metrics reports are included.
  610.  
  611.  
  612. .
  613.  Miscellaneous_Tools
  614.  
  615. PD2:<ADA.TOOLS>
  616.  
  617.         This is the  miscellaneous  tools  subdirectory.   Sources  to
  618. various  tools  which  do  not  fit  into  the categories of the other
  619. subdirectories are placed here.
  620.  
  621.  
  622. .
  623.  Newsletters
  624.  
  625. PD2:<ADA.NEWS>
  626.  
  627.     This subdirectory contains the Ada Software Repository (ASR)
  628. Newsletters.  They are numbered sequentially, starting at 001.  File
  629. names are ASRnnn.DOC.
  630.  
  631. .
  632.  Online_Documentation
  633.  
  634. PD2:<ADA.ONLINE-DOC>
  635.  
  636.         This  directory  contains  supporting  files  for  the  online
  637. documentation system of the Ada Repository.
  638.  
  639.  
  640. .  
  641.  Pager
  642.  
  643. PD2:<ADA.PAGER>
  644.  
  645.         This subdirectory contains tools which create and  manipulated
  646. paged  files.  All SRC files are paged files, which are files composed
  647. of several smaller files separated by a special flag.
  648.  
  649.  
  650. .
  651.  PDL
  652.  
  653. PD2:<ADA.PDL>
  654.  
  655.         This  subdirectory  contains  software  associated  with   Ada
  656. Program  Design  Languages  and  tools  to  support  the  Ada  program
  657. designer.  Such tools include tools for data  dictionary  manipulation
  658. and design analysis.  There may be some overlap between this directory
  659. and software which may fall into the PDL category  that  is  scattered
  660. among the other subdirectories.
  661.  
  662. .  
  663.  PIWG Benchmarks
  664.  
  665.     PIWG is a suite of tests/benchmarks prepared by the
  666. Performance Issues Working Group of ACM SIGAda.  The purpose of
  667. PIWG is to develop the benchmarks and collect and disseminate results.
  668.     The PIWG tests have been under development for many years and
  669. have been run against many Ada compilers.  The PIWG test suite
  670. contains over 190 files which include Whetstone (to measure
  671. processor speed), Dhrystone (to measure statement execution per
  672. unit time), and other benchmarks which test various attributes of
  673. the Ada language and their implementations under specific
  674. compilers.  The PIWG tests must be customized for a particular
  675. compiler, and instructions are included to do this.
  676.  
  677. .
  678.  Pointers
  679.  
  680. PD2:<ADA.POINTERS>
  681.  
  682.         This is  the  pointers  subdirectory.   Information  on  other
  683. sources  of  software and information (such as the USC-ECLB resources)
  684. is presented here.  This data  pertains  to  both  on-  and  off-  net
  685. resources.
  686.  
  687.  
  688. .
  689.  Pretty_Printers
  690.  
  691. PD2:<ADA.PRETTY-PRINTERS>
  692.  
  693.         This  subdirectory  contains  pretty  printers  for Ada source
  694. programs.  The pretty printers reformat the  Ada  source  programs  in
  695. order  to  outline  the  structure  of  the programs and provide other
  696. useful information for the programmer.
  697.  
  698.  
  699. .
  700.  Program_Stubber
  701.  
  702. PD2:<ADA.STUBBER>
  703.  
  704.         This  subdirectory  contains  Ada  program body stubber tools.
  705. They analyze the definition of an Ada  software  design  and  generate
  706. software bodies as stubs to be filled in later during development.
  707.  
  708.  
  709. .
  710.  Simulation
  711.  
  712. PD2:<ADA.SIMULATION>
  713.  
  714.     This subdirectory contains programs and tools associated with
  715. performing simulations, such as queuing simulations.
  716.  
  717. .
  718.  Spelling_Checkers
  719.  
  720. PD2:<ADA.SPELLER>
  721.  
  722.         This subdirectory contains spelling checkers written  in  Ada.
  723. Dictionaries are also included here.
  724.  
  725.  
  726. .
  727.  Starter_Kit
  728.  
  729. PD2:<ADA.STARTER-KIT>
  730.  
  731.         This subdirectory contains tools which are useful in accessing
  732. the software in the repository.  It includes the PAGER tool, which  is
  733. used to assemble and disassembled SRC (paged) files.
  734.  
  735.  
  736. .
  737.  Style_Checkers
  738.  
  739. PD2:<ADA.STYLE>
  740.  
  741.         This  subdirectory  contains  Ada  style checking tools.  They
  742. analyze  Ada  source  code  and  report  on  various  aspects  of  the
  743. programming  style,  such  as  consistent  indentation and use of long
  744. variable names.
  745.  
  746.  
  747. .
  748.  Virtual_Terminal
  749.  
  750. PD2:<ADA.VIRTERM>
  751.  
  752.         This  subdirectory  contains  tools  for  a  virtual  terminal
  753. package,  which performs screen-oriented functions by reading terminal
  754. characteristics from a UNIX-like TERMCAP data base.   The  application
  755. program  can call routines in these packages and not be concerned with
  756. the type of terminal being addressed.
  757.  
  758.  
  759. .
  760.  WIS_ADA_Tools
  761.  
  762. PD2:<ADA.WIS-ADA-TOOLS>
  763.  
  764.         This directory contains information about the  software  tools
  765. submitted  by  the Naval Oceans Systems Center (NOSC).  An abstract of
  766. the tools is included.
  767.  
  768.     These tools were paid for by WIS (WWMCCS Information Systems).
  769.  
  770.  
  771. .
  772. ----> TAPEDIST.DOC, Version 1.0 <----
  773.  
  774.     ADA SOFTWARE REPOSITORY AVAILABLE ON TAPE
  775.  
  776.     Tape copies of the Ada Software Repository are available on 9
  777. Track, 1600 and 6250 BPI magtapes in the following formats from the
  778. indicated companies:
  779.  
  780.     Format            Contact
  781.     ------            -------
  782.     TOPS-20 DUMPER        Management Assistance Corporation of
  783.                   America (MACA)
  784.     TOPS-10    INTERCHANGE    MACA
  785.     UNIX TAR        MACA
  786.     ANSI            Navajo Technology (1600 BPI only)
  787.  
  788. ---------------------------------------------------------------------
  789. Formats from MACA --
  790.     9 Track, 1600 and 6250 BPI Tape Formats Supported:
  791.         TOPS-20 DUMPER
  792.         TOPS-10 INTERCHANGE
  793.         UNIX TAR
  794.     Charge by MACA: None
  795.     Instructions:
  796.     (1) Send 3 tapes, a stamped, self-addressed mailing label, and
  797. a short, informal cover letter stating that you would like a copy of
  798. this collection and specifying the format.  Personnel at White Sands
  799. will copy to the tapes as they have time and mail them back to you.
  800.         (2) Please use the following address to send your tapes.  Send
  801. a completed UPS Collect or Federal Express Collect form to cover
  802. payment of postage.  The address is:
  803.     
  804.         MACA
  805.         Attn: Janet McKellar
  806.         PO Drawer 100 - Building T148
  807.         White Sands Missile Range, NM 88002
  808.  
  809.     (3) Status of tape requests made to MACA can be determined by
  810. contacting MACA at 505/678-3288.  Ask for Janet McKellar, David Moon,
  811. or Mannie Gamez.  Their hours are 7:30 AM to 4:00 PM MST.
  812.  
  813. -----------------------------------------------------------------------
  814. Formats from Navajo Technology --
  815.     9 Track, 1600 BPI Formats Supported:
  816.         ANSI
  817.     Charge by Navajo Technology:
  818.         $200.00 for 3 tapes; this includes tape copying
  819.         charges, the tapes themselves, and shipping
  820.     Instructions:
  821.     (1) Mail your requests to the following address:
  822.  
  823.     Navajo Technology Corporation
  824.     Navajo Nation
  825.     Box 100
  826.     Leupp, AZ  86035
  827.  
  828.     (2) Other lower prices can be negotiated if you supply the
  829. tapes to Navajo Technology.  Navajo Technology also offers additional
  830. services and products, including guest accounts on their computers and
  831. assistance in bringing up software from the Ada Software Repository.
  832. Contact Navajo Technology for details.
  833.     (3) Status of tape requests to Navajo Technology and other
  834. questions can be answered by contacting Navajo Technology at
  835. 602/686-6391.  Ask for Vince Bia or Tom Ryan.  Their hours are 9:00 AM
  836. to 5:00 PM MST.
  837.  
  838. ----> FLOPDIST.DOC, Version 1.0 <----
  839.  
  840.     ADA SOFTWARE REPOSITORY AVAILABLE ON IBM PC FLOPPIES
  841.  
  842.     Parts of the Ada Software Repository are available on IBM PC
  843. compatible floppy disks.  The following organizations are providing
  844. this service:
  845.  
  846.     Organization            For Whom Service is Provided
  847.     ------------            ----------------------------
  848.     C2MUG, Fort Leavenworth, KS    All echelons within the DoD
  849.                       and the US Federal Government
  850.  
  851.     SIG/M, ACGNJ, NJ        Anyone
  852.  
  853.     Descriptions of these services follow.
  854.  
  855. -------------------------------------------------------------------------
  856. 1. C2MUG, Fort Leavenworth, KS
  857.  
  858.     C2MUG (Command and Control Microcomputer User's Group)
  859. provides a forum of the exchange of ideas and public domain software
  860. between microcomputer users, keying on command and control
  861. applications.  C2MUG provides a focal point for microcomputer users
  862. throughout the US Army, and it is sponsored by the
  863. Communications-Electronics Command (CECOM).  The staff of C2MUG is
  864. located at the CECOM Maneuver Control Directorate, Building 138, at
  865. Fort Leavenworth, Kansas.
  866.  
  867.     C2MUG provides a continuing forum whereby users can:
  868.         - learn of the latest command and control efforts
  869.         - participate in contributing ideas and software
  870.         - seek solutions to microcomputer software problems
  871.         - learn more about micros relating to their military
  872.           work environment
  873.         - receive a free bi-monthly newsletter
  874.         - receive a free semi-annual software catalog
  875.         - receive copies of public domain software in exchange
  876.           for blank floppy diskettes
  877.         - attend an annual microcomputer seminar
  878.         - have access to an Electronic Bulletin Board
  879.  
  880.     C2MUG provides assistance to its users through a full-time
  881. staff.  The staff assists with software problems either directly, by
  882. referral to another user with the desired background/expertise, or
  883. through Requests for Assistance in the monthly newsletter and/or on
  884. the Electronic Bulletin Board.
  885.  
  886.     Available software consists of over 500 programs, primarily
  887. for use with the Apple II Plus/IIe/IIc and IBM PC and compatibles.
  888. Some programs are also available for the Kaypro 2, Zenith Z-100/Z-120,
  889. and Wang.
  890.  
  891.     C2MUG offers its services to all echelons within the US Army
  892. community, the sister military services, and elements of the Federal
  893. Government.  There is no cost or obligation associated with joining
  894. C2MUG, and the services (including the newsletter, catalog, and public
  895. domain software copying) are free.
  896.  
  897.     For more information, contact C2MUG:
  898.  
  899.         Department of the Army
  900.         CECOM MCSD
  901.         Attn: AMSEL-RD-LC-MC (C2MUG)
  902.         Fort Leavenworth, Kansas  66027-5600
  903.         Phone: AV 552-7550, FTS 753-7550,
  904.             Commercial 913/684-7550
  905.  
  906. ----------------------------------------------------------------------
  907. 2. SIG/M, ACGNJ, New Jersey
  908.  
  909.     This service is not yet available.  Details will be filled
  910. in later.
  911.  
  912. ----> FTPDIST.DOC, Version 1.0 <----
  913.  
  914.     ADA SOFTWARE REPOSITORY AVAILABLE VIA FTP
  915.  
  916.     The Ada Software Repository is on the Defense Data Network,
  917. and all files in it are available via the File Transfer Protocol with
  918. anonymous login.  The following book describes the Ada Software
  919. Repository and how to access it via FTP on the Defense Data Network:
  920.  
  921.     "The Ada Software Repository and the Defense Data Network: A
  922. Resource Handbook" by Richard Conn.  Published in 1987, 200+ pages.
  923. Contact the Ada Software Repository support contractor (see the file
  924. PD2:<ADA.GENERAL>ASRSUPP.DOC) or the publisher to acquire it; the
  925. publisher is:
  926.  
  927.         New York Zoetrope
  928.         838 Broadway
  929.         New York, NY  10003
  930.         Phone: 800/242-7546
  931.  
  932.     Other information on using FTP is available within the Ada
  933. Software Repository itself; send electronic mail requests for this
  934. information to:
  935.         ADA-SW-REQUEST@SIMTEL20.ARPA
  936.  
  937.     The files on FTP in the ASR are:
  938.         PD2:<ADA.GENERAL>FTP.DOC
  939.         PD2:<ADA.GENERAL>FTP1.DOC
  940.         PD2:<ADA.GENERAL>FTP2.DOC
  941.         PD2:<ADA.GENERAL>FTPDIST.DOC (this file)
  942.  
  943. ----> UUCPBIT.DOC, Version 1.0 <----
  944.  
  945.     ACCESSING THE ADA SOFTWARE REPOSITORY VIA UUCP (USENET) AND BITNET
  946.  
  947.         "How can a user of a USENET host access the public domain
  948. microcomputer software collection on the DDN/MILNET host SIMTEL20?"
  949. is being asked with increasing frequency as that software collection
  950. continues to grow.  Unfortunately, direct access is not possible as
  951. there is no UUCP gateway for file transfer between SIMTEL20 (running
  952. TOPS-20) and a USENET host (as there is for electronic mail).
  953.  
  954.         DDN, formerly known as ARPANET, is the Defense Data Network.
  955. DDN, along with Arpanet, SATNET, SRINET, etc.  are all members of a
  956. TCP/IP protocol-based, multiple gateway network called InterNet.)
  957.  
  958.         USENET has been built on adjacent hosts voluntarily agreeing
  959. to store- and-forward relatively short messages across the USENET over
  960. dialup lines at 300 or 1200 bps.  In the past, helpful InterNet users
  961. would fetch the file(s) requested and then e-mail them to the
  962. requestor.  However, it has been pointed out that large file transfers
  963. disrupt the service, delay the shorter messages, and generate
  964. unacceptably large phone bills, all of which add up to threaten the
  965. tenuous connections that some USENET hosts can barely afford to have.
  966. Therefore, we have been asked to encourage InterNet users not to pass
  967. archive programs this way.
  968.  
  969.     Those USENET and BITNET users who wish to access the files
  970. in the Ada Software Repository may acquire them via magtape or
  971. IBM PC diskette.  See the files PD2:<ADA.GENERAL>TAPEDIST.DOC and
  972. PD2:<ADA.GENERAL>FLOPDIST.DOC for details on how to do this.
  973. Additionally, the ASR Newsletter documents other methods for
  974. accessing the ASR from these communities as they become available;
  975. see the file PD2:<ADA.GENERAL>NEWSLTR.DOC for details on acquiring
  976. the ASR Newsletters.
  977.  
  978.     The problem of giving USENET and BITNET users a more timely
  979. method of accessing the ASR is being addressed, and details will be
  980. released in future issues of the ASR Newsletter.
  981.  
  982. For BITNET Users Only
  983. ---------------------
  984.     Michael Feldman of The George Washington University EE&CS
  985. Department maintains a mailing list of people at BITNET sites
  986. interested in receiving the list of validated Ada compilers and Ada
  987. Software Repository Newsletters on a regular basis.  Michael can be
  988. contacted via electronic mail:
  989.  
  990.         MFELDMAN at GWUVM - BITNET
  991.         MFELDMAN%GWUVM.BITNET@WISCVM.WISC.EDU - DDN
  992.  
  993. ----> NEWSLTR.DOC, Version 1.0 <----
  994.  
  995.     ADA SOFTWARE REPOSITORY NEWSLETTER
  996.  
  997.         The Ada Software Repository (ASR) newsletter is published in
  998. both electronic form and hardcopy form:
  999.  
  1000.         (1) Users of the ASR may freely transfer copies of the
  1001. newsletter from PD2:<ADA.NEWS> via FTP (the newsletters are in the
  1002. files matching ASR*.DOC).
  1003.  
  1004.         (2) The newsletters are available in electronic form
  1005. on IBM PC diskettes (see the file PD2:<ADA.GENERAL>FLOPDIST.DOC for
  1006. details).
  1007.  
  1008.         (3) The tape distribution of the ASR (see the file
  1009. PD2:<ADA.GENERAL>TAPEDIST.DOC) includes the newsletters.
  1010.  
  1011.         (4) A hardcopy mailing of the newsletter is available
  1012. from the ASR support contractor (see the file ASRSUPP.DOC in the
  1013. directory PD2:<ADA.GENERAL>).  Hardcopy subscription to the ASR newsletter
  1014. is free to all elements of the US Government; the cost to others for a
  1015. hardcopy subscription to the ASR Newsletter is $16 for 12 copies.
  1016.  
  1017. ----> INDEX.DOC, Version 1.0 <----
  1018.  
  1019.     ADA SOFTWARE REPOSITORY MASTER INDEX
  1020.  
  1021.         The Master Index of the Ada Software Repository (ASR) is a
  1022. loose-leaf book which contains details on the software and information
  1023. in the ASR.  Each item of software is described by an abstract,
  1024. information on the host compiler/operating system and target
  1025. environment, and a listing of all associated files and their locations
  1026. in the ASR.  Each item of information is described by an abstract and
  1027. a listing of all associated files.
  1028.  
  1029.         The Master Index breaks down the ASR into the following major
  1030. categories, each presented as separate chapters:
  1031.     
  1032.         o ASR-Specific Information and Programs
  1033.         o Artificial Intelligence
  1034.         o Benchmarks
  1035.         o Communications
  1036.         o Reusable Software Components
  1037.         o Data Base Management
  1038.         o Documentation
  1039.         o Graphics
  1040.         o Project Management
  1041.         o Ada Software Development Tools
  1042.         o Other Tools
  1043.         o the WIS Ada Tool Set
  1044.     
  1045.         Selected items of information from the ASR are included in the
  1046. Master Index.  These items include the Welcome Message, which gives an
  1047. extensive introduction to the Ada Software Repository (its operation
  1048. and use) and the Defense Data Network (with emphasis on the use of FTP
  1049. to transfer files from the archives on SIMTEL20).
  1050.  
  1051.         Appendices include (1) a Snapshot of the ASR (ADA.SNP) which
  1052. names each directory of the ASR and gives the total size of its
  1053. contents in terms of bytes and lines of code, (2) a listing of all
  1054. files in each directory of the ASR with file sizes and CRC data
  1055. (ADA.CRCLST), and (3) a listing of all files in each directory of the
  1056. ASR with file sizes, line counts, and PAGER hashes (ADA.RPT).
  1057.  
  1058.         The Master Index includes a complete table of contents, which
  1059. is helpful in quickly locating specific items of interest, and an
  1060. extensive index.  The first publication of the Master Index exceeded
  1061. 300 pages in size.
  1062.  
  1063.         As the ASR grows, updates to the Master Index will be issued.
  1064. The loose-leaf format of the Master Index was selected to facilite the
  1065. update process and to permit the users to assemble the Master Index
  1066. and the ASR Newsletters conveniently in loose-leaf notebooks.
  1067.  
  1068.     The Master Index and its updates are available through the ASR
  1069. support contractor.  See the file PD2:<ADA.GENERAL>ASRSUPP.DOC for
  1070. details on how to contact this contractor.  The Master Index is free
  1071. to all elements of the US Government; the purchase price of the Master
  1072. Index to others is $50.00 (not including updates).  Updates are also
  1073. free to all elements of the US Government, and their prices to others
  1074. will be determined as they are released.
  1075. ----> ASRSUPP.DOC, Version 1.1 <----
  1076.  
  1077.     ADA SOFTWARE REPOSITORY SUPPORT CONTRACTOR
  1078.  
  1079.     The Management Assistance Corporation of America (MACA)
  1080. provides support to the user community of the Ada Software Repository
  1081. (ASR) on SIMTEL20.  This support includes:
  1082.  
  1083.     (1) hardcopy distribution of the ASR Newsletter to any
  1084. interested parties (government-related or otherwise),
  1085.     (2) hardcopy distribution of updates to the ASR Master Index
  1086. to any interested parties,
  1087.     (3) telephone assistance to those users who wish to locate
  1088. items in the ASR, including information on the availability of items
  1089. through the IBM PC diskette distribution handled by C2MUG and SIG/M,
  1090. and
  1091.     (4) telephone assistance to those users who wish to determine
  1092. the status of the magtape requests they have made which are processed
  1093. through MACA at White Sands.
  1094.  
  1095.     To contact MACA in order to be placed on one or both of the
  1096. distributions or to request assistance, phone 505/678-3288 between the
  1097. hours of 7:30 AM and 4:00 PM MST.  Ask for Janet McKellar, David Moon,
  1098. or Mannie Gamez.  You may also write to MACA at the following address:
  1099.  
  1100.     MACA
  1101.     PO Drawer 100 - Building T148
  1102.     White Sands Missile Range, New Mexico  88002
  1103.  
  1104.  
  1105.