carpent@SRC.Honeywell.COM (Todd Carpenter) (02/12/91)
Here is some excellent information that Larry Maturo sent to me in response to an earlier post. Parts of this are probably worth putting in the monthly posting. From: larry@titan.tsd.arlut.utexas.edu (Larry Maturo) Subject: Re: VHDL Math packages Below is some information I found laying around on both public-domain VHDL and ADA. Hope it helps. USERS GUIDE TO VHDL-SW July 1987 1. INTRODUCTION This guide is a road map to both the VHDL Repository and the VHDL-SW mailing list for members of VHDL-SW. It provides the following information: 1. Introduction 2. How to Use the VHDL-SW Mailing List 3. An Overview of the VHDL Repository 4. Useful Documentation 5. Statement of Operation of the VHDL Repository 6. How to Access the VHDL Repository 7. How to Submit to the VHDL Repository 7.1 Overview and guidelines 7.2 The Prolog text 7.3 An Example 8. How to Acquire a Tape of the VHDL Repository VHDL-SW is both a mailing list and a VHDL archive. By being a member of VHDL-SW, you can communicate with other VHDL users on the mailing list and have direct access to the VHDL archives. The VHDL-SW mailing list is used to announce new items as they are placed in the VHDL Repository as well as support communication on VHDL-related topics. The VHDL repository is used to archive and disseminate information, hardware descriptions, and (potent- ially) VHDL compilers and tool code to interested professionals in the hardware design community. Announcements about new additions and changes to the VHDL Repository are made over the VHDL-SW mailing list. The VHDL Repository is a collection of voluntarily-contributed files located in the VHDL parent directory on the SIMTEL20 host computer. SIMTEL20 is located at White Sands Missile Range and is available to any user of the Defense Data Network (DDN). The files in the VHDL Repository can be acquired via FTP by DDN users and via magtape by all others. All items distributed through this repository are in the public domain. 2. How to Use the VHDL-SW Mailing List 2.1 Initial Request The VHDL-SW electronic mailing list exists for those who are inter- ested in discussing VHDL issues with other professionals and to provide information on and assistance in accessing and contributing software to the VHDL Repository on SIMTEL20. To subscribe to this mailing list, send a request via electronic mail to: VHDL-SW-REQUEST@SIMTEL20.ARPA 2.2 Use of the Mailing List The mailing list serves two purposes: to help exchange information between the repository users and to mail repository submissions to the maintainer of the VHDL Repository for inclusion in the archives. You will automatically receive messages from other members of the list. If you desire to send a message to the list, use your mail program to create your message and mail it to VHDL-SW@SIMTEL20.ARPA Your message will then be automatically sent to all other members of the list. 2.3 Message Archiving All messages sent over the VHDL-SW mailing list are archived in a file on SIMTEL20. If you want to review old messages, retrieve the file PS:<ARCHIVES.VHDL-SW>VHDL-SW-ARCHIV.TXT This file contains all recent messages passed over the VHDL-SW mailing list. New users on the list are invited to get a copy of this file and scan it for background messages of interest; experienced users may use it for reference. But be forewarned: this is a BIG file! Older messages are not saved in VHDL-SW-ARCHIVE.TXT, but are stored in similar files identified by date. Thus, PS:<ARCHIVES.VHDL-SW>VHDL-SW.ARCHIVE.ymmdd contains older messages by year/month/day. 3. An Overview of the VHDL Repository The repository provides a free source for VHDL descriptions and information. By employing the File Transfer Protocol (FTP) program, users of DDN hosts are able to scan the directories of the repository and trans- fer files to their hosts. The VHDL Repository is divided into several subdirectories. These directories are organized by topic, and their names and a brief overview of their topics are contained in the file DIRLIST.DOC in PD:<VHDL.GENERAL>. The VHDL Repository on SIMTEL20 serves two basic roles: to promote the exchange and use (reusability) of VHDL descriptions and models and to promote VHDL education (specifically by providing several working examples of programs in source form for people to study and modify). All members of the VHDL community are encouraged to freely extract information and programs from the repository as well as make contributions to it. There are no restrictions to access and use of the items in the VHDL Repository other than respecting the constraints of copy- righted software and hardware descriptions and to not unlawfully restrict use of the routines as obtained from others. Be aware that all code and hardware descriptions in the repository are available "as is." 4.0 Useful Documentation A very useful book exists entitled "The Ada Software Repository and the Defense Data Network: A Resource Handbook" written by Richard Conn and published by N. Y. Zoetrope, Inc. This book contains an extensive set of hints and resource notes on the Defense Data Network and the Ada Repository. Because the VHDL Repository is operated on the same model as the Ada Reposi- tory, and because one of the VHDL Repository administrators is also the Ada Repository administrator, information in this book related to the Ada Repo- sitory is also pertinent to the VHDL Repository. You are encouraged to use this book to provide additional details not covered in this guide. The VHDL language currently exists in two forms: 1. Version 7.2 as developed by Intermetrics, Inc., IBM, and Texas Instruments under contract to DoD 2. An incompatible yet intimately related version currently being standardized by the IEEE. VHDL Version 7.2 is described in a) Intermetrics, Inc. "VHDL Language Reference Manual - Version 7.2," 1986. b) Intermetrics, Inc. "A VHDL Tutorial," 1986. c) Intermetrics, Inc. "A Reference for the VHDL," 1986. The IEEE version of VHDL is described in a) IEEE, "The VHDL Language Reference Manual," IEEE Draft Standard P1076, 1987. b) CLSI, Inc., "A Tutorial of the IEEE VHDL," 1987. 5. Statement of Operation of the VHDL Repository The VHDL Repository on SIMTEL20 (and a related tape copy service) are unfunded activities and have been so since Richard Conn, as a result of conversations with Harold Carter, proposed the idea to Frank Wancho in July, 1987. The disk drive on which the repository is sharing space with other collections is funded by the Logistics System Support Activity (LSSA), an Army Materiel Command (AMC, formerly DARCOM) activity. LSSA provided the funds for the disk drive to support the UNIX/C collection for the AMC community, which, because of the availability via ANONYMOUS FTP on DDN, is available to the entire DDN community. The VHDL Repository resides on SIMTEL20 because there happens to be space available on that disk drive. SIMTEL20 is owned and operated by the Computer Systems Directorate at White Sands Missile Range in New Mexico, which is an Installation/Field Operating Activity (I/FOA) under the Test and Eval- uation Command (TECOM) at Aberdeen Proving Ground in Maryland. TECOM is, in turn, a major subordinate command under AMC. AMC is a major command under the Department of the Army. Harold Carter is the maintainer of the VHDL Repository with support from Richard Conn who also maintains the VHDL-SW electronic mailing list. Frank Wancho is the sponsor of the VHDL Repository and runs the tape distribution service. Richard, Harold, and Frank work on a voluntary, unfunded basis. The VHDL Repository is not associated with either the VHDL Program Office or the VHSIC Program Office. All software, documentation, and other items of information in the VHDL Repository are in the public domain. 6. How to access the VHDL Repository The contents of the VHDL Repository are organized in a number of different ways to make finding software and documentation easier for the user of the repository. The following summarizes the information sources. 6.1 User's Guide The User's Guide is a text file which is sent along with a welcome message to all new subscribers to the VHDL-SW electronic mailing list. The guide contains introductory material on the VHDL Repository, the operation and use of the VHDL Repository, and the Defense Data Net- work. The User's Guide is stored in the text file PD:<VHDL.GENERAL>VUSERS.DOC 6.2 Logging on SIMTEL20 To examine filenames and extract files from the VHDL Repository, you must use the FTP program available on your local host. Execute FTP SIMTEL20.ARPA to connect to SIMTEL20 over the Arpanet. Once connected to SIMTEL20, log on as "anonymous" and give any combination of characters as the password. If SIMTEL20 accepts your id and password, you are logged on and can obtain directory dislays, change to desired directories, and download files. 6.3 Simple Directory Displays FTP can provide most users with a directory display of all files in any of the archives in the VHDL Repository. While executing FTP on your local host, type "ls" or "dir" (or something similar on your particular version of FTP) to obtain a file listing of any directory you wish to see. You can also change to a different local directory on SIMTEL20 by using "cd" (or something similar) while executing FTP. 6.4 Downloading files FTP permits one to download text or binary files to a local host. The FTP command "get" (or something similar) is used to accomplish this task. You are encouraged to review your local documentation on FTP for further details on this command. 6.5 Additional Information Additional detailed information is contained in the following files on SIMTEL20: PD:<ADA.GENERAL>FTP.DOC -- introduction to FTP and file transfer PD:<ADA.GENERAL>UUCP-BIT.DOC -- accessing via UUCP and BITNET 6.6 Online Documentation System 6.6.1 Introduction A complete online documentation system exists on SIMTEL20 which can be downloaded to your local host for use by you and your fellow users. The system provides executable code (written in Ada) which implements a menu- driven help capability. The online help files provide a brief description of each VHDL module stored in the repository. It also provides assistance on the use of the repository and other pertinent information. 6.6.2 ONLINE-DOC data base The directory PD:<VHDL.ONLINE-DOC> contains a data base for the online documentation system. PD:<ADA.ONLINE-DOC> contains the source code (in Ada) to the programs which allow you to manipulate this data base and instructions on installing these programs and the data base for use on your host computer. Download the PD:<ADA.ONLINE-DOC> files to your local host, read the documentation file, and compile the executable programs. You then need to download the PD:<VHDL.ONLINE-DOC> files which contain the help text information (in the form of a simple data base) used by the executable programs. When you execute these programs, you are querying the help data base which gives you data on each directory in the repository. This data includes a brief description of the directory, a listing of its contents with file sizes, and descriptions of each program and piece of software in the directory. The data base may be copied from SIMTEL20 from time to time as more VHDL description code is added to the repository. 6.7 Prologue Files Each piece of software has an associated PROLOGUE file of type PRO (e.g., EXAMPLEIO.PRO) which contains the VHDL Repository standard header. See Section 7 below or PD:<VHDL.GENERAL>PROLOGUE.DOC for more information. 6.8 The PD:<VHDL.GENERAL> directory The files in PD:<VHDL.GENERAL> contain information on what is in the VHDL Repository, how to access and use the VHDL Repository, and other items of interest to the community. 7. How to Submit to the VHDL Repository 7.1 Overview To submit one or more VHDL descriptions to the VHDL Repository you must submit at least two files for each analyzable description. One is the .PRO file which describes the entity or package, and the other is the .VHD file which contains the actual VHDL source description. If you have never submitted a file to the VHDL Repository before, or, if it has been a while since you have done so, then 1. Obtain the following files, via FTP or otherwise, from the PD:<VHDL.GENERAL> subdirectory to your host computer: SUBMIT.DOC -- latest submission instructions PROLOGUE.PRO -- prologue for you to edit SAMPLE.PRO -- a sample prologue 2. Read SUBMIT.DOC (this file). This is the current set of submission instructions. 3. Edit PROLOGUE.PRO as per these instructions. 4. Rename the edited PROLOGUE.PRO as filename.PRO, where filename your name for the file. All files associated with a submission should contain a maximum of thirteen characters (a nine-character name, a period, and a three-character suffix, like MYFILE.TXT). The first six characters must be unique, and the first two or three characters of all files should be the same so that they will be grouped together when displayed by the online documentation system. Only letters and digits may be used in file names, and the first character must be a letter. Consult with the maintainer of the VHDL Repository (at VHDL-SW-REQUEST@SIMTEL20.ARPA) before naming your files so that you can pick a 2-3 char prefix that is different from those already selected. Examples of good file names: MYFILE.TXT SOMETHING.DOC ENTITY12.D ARCH1. DOCUMENT.P01 Examples of invalid file names: MY_FILE.TXT -- contains a char other than letter or digit THISISATEST.DOC -- too long ENTITY.DOC ENTITY1.DOC -- grouped together, first six chars are not unique Example of a good submission: EX.PRO -- PROLOGUE file EX.VHD -- VHDL description file EX.DOC -- documentation file (optional) EXREAD.ME -- read me file (optional) This example of filenames is correct because 1) all file names are valid and 2) all file names begin with the same first 2 or 3 characters (a command like DIR EX*.* will pick them up) 5. Transmit all files to SIMTEL20. Consult with the maintainer of the VHDL Repository via VHDL-SW-REQUEST@SIMTEL20.ARPA for the best way to do this (i.e., tape, FTP, or email) 7.2 Instructions for Editing PROLOGUE.VHD Refer to the format given in Section 7.3 or the example in Section 7.4 while reading this section. 1. UNIT NAME: Type in the name of the VHDL analysis unit (i.e., entity, architecture, configuration, or package). Use any format you desire. 2. VERSION: Enter a version number in any format you desire. 3. AUTHOR: Enter your name. Your mailing address, phone number, etc, are also acceptable. 4. DDN ADDRESS: Enter your DDN electronic mailing address. 5. COPYRIGHT: Enter a copyright entry. SAMPLE.PRO shows a good example. Only public domain software is accepted in the VHDL Repository. 6. DATE CREATED: Date analyzable unit created. 7. RELEASE DATE: Date analyzable unit released to the VHDL Repository. 8. LAST UPDATE: Enter updates in the following format (see SAMPLE.PRO): NAME_OF_PERSON_MAKING_UPDATE DATE 9. VHDL VERSION: Enter the version of VHDL used to analyze and/or simulate the description. 10. MACHINE/SYSTEM ANALYZED/SIMULATED ON: Enter the computer on which the software was analyzed and/or simulated and state what VHDL analyzer was used. If you foresee a transportability problem due to machine dependencies, please state. 11. KEYWORDS: Enter keywords or phrases which may be used to categorize your submission. 12. ABSTRACT: Summarize the function of the VHDL description. 13. REVISION HISTORY: Enter an "Initial Release" entry here. See SAMPLE.PRO for an example. 14. DISTRIBUTION AND COPYRIGHT: Edit this per your needs. 7.3 The PROLOGUE The following comment statements are to be submitted in a .PRO file along with each VHDL analyzable unit. -------- SIMTEL20 VHDL Repository Prologue ------------ -- -- Unit name : -- Version : -- Author : -- : -- : -- : -- DDN Address : -- Copyright : (c) -- Date created : -- Release date : -- Last update : -- VHDL Version : -- Machine/System Analyzed/Simulated on: -- --------------------------------------------------------------- -- -- Keywords : -- -- Abstract : -- -- ------------------ Revision history --------------------------- -- -- DATE VERSION AUTHOR HISTORY -- ------------------ Distribution and Copyright ----------------- -- -- This prologue must be included in all copies of this VHDL code. -- -- This description is copyright by the author. -- -- This description is released to the VHDL community. -- This description is released to the Public Domain (note: -- Hardware descriptions released to the Public Domain are not subject -- to copyright protection). -- Restrictions on use or distribution: NONE -- ------------------ Disclaimer --------------------------------- -- -- This VHDL description code and its documentation are provided -- "AS IS" and without any expressed or implied warranties whatsoever. -- No warranties as to performance, merchantability, or fitness -- for a particular purpose exist. -- -- Because of the diversity of conditions under which this code may be -- used, no warranty of fitness for a particular purpose is offered. -- The user is advised to evaluate the code thoroughly before relying on it. -- The user must assume the entire risk and liability of using this code. -- -- In no event shall any person or organization of people be -- held responsible for any direct, indirect, consequential -- or inconsequential damages or lost profits. -- -------------------END-PROLOGUE-------------------------------- 7.4 An example of prologue use This example is file EXAMPLE.VHD in PD:<VHDL.GENERAL> on SIMTEL20. -------- SIMTEL20 VHDL Repository Prologue ------------ -- -- Unit name : entity UP_DOWN_COUNTER -- Version : 1.0 -- Author : Harold W. Carter -- : University of Cincinnati -- : 898 Rhodes Hall, M.L. 30 -- : Cincinnati, OH 45221 -- DDN Address : HCARTER@AFIT-AB.ARPA -- Copyright : (c) 1987 Harold W. Carter -- Date created : June 12, 1987 -- Release date : August 2, 1987 -- Last update : -none- -- VHDL Version : DoD Ver. 7.2 -- Machine/System Analyzed/Simulated on : VAX 11/785, VMS -- Intermetrics analyzer, not simulated -- --------------------------------------------------------------- -- -- Keywords : COUNTER, UP/DOWN -- -- Abstract : This entity consists of a package with simple -- functions for four-value logical functions -- (0, 1, U, Z), and one architecture described -- at the register-transfer-level which defines the -- function of a 32-bit up-down counter. Its purpose -- is for education only. -- -- ------------------ Revision history --------------------------- -- -- DATE VERSION AUTHOR HISTORY -- -- ------------------ Distribution and Copyright ----------------- -- -- This prologue must be included in all copies of this VHDL code. -- -- This VHDL description is copyright by the author. -- -- This description is released to the VHDL community. -- This description is released to the Public Domain (note: -- Hardware descriptions released to the Public Domain is not subject -- to copyright protection). -- Restrictions on use or distribution: NONE -- ------------------ Disclaimer --------------------------------- -- -- This VHDL description code and its documentation are provided -- "AS IS" and without any expressed or implied warranties whatsoever. -- No warranties as to performance, merchantability, or fitness -- for a particular purpose exist. -- -- Because of the diversity of conditions under which this code may be -- used, no warranty of fitness for a particular purpose is offered. -- The user is advised to evaluate the code thoroughly before relying on it. -- The user must assume the entire risk and liability of using this code. -- -- In no event shall any person or organization of people be -- held responsible for any direct, indirect, consequential -- or inconsequential damages or lost profits. -- -- -------------------END-PROLOGUE-------------------------------- 8. How to Acquire a Tape of the VHDL Repository Tape copies of the files in PD:<VHDL*> may be made on 9TRK, 1600 BPI tapes in TOPS-20 DUMPER, TOPS-10 INTERCHANGE, and Unix Tar formats (sorry, SIMTEL20 does not have the capability of making VMS tapes). Send a tape, a stamped, self-addressed mailing label, and a short, informal cover letter stating that you would like a copy of this collection and specifying the format. Personnel at White Sands will make the tape at their convenience and mail it back to you. There is no charge for this service. Please use the following address to send your tape. White Sands cannot accept cash, checks, money orders or purchase orders. Send sufficient return postage in stamps. Commander USA White Sands Missile Range STEWS-IM-CM-S (Bldg. 362, Frank Wancho) White Sands Missile Range, New Mexico 88002-5072 DDN electronic mail address is WANCHO@SIMTEL20.ARPA. Frank's telephone number is 505/678-6257. ----> OVWELCOME.PRO, Version 1.6 <---- WELCOME TO THE ADA SOFTWARE REPOSITORY ON SIMTEL20 You are now on the ADA-SW mailing list, through which users of the Ada Software Repository (ASR) communicate with each other. This message is an introduction to the Ada Software Repository (ASR). A copy of this message is kept in PD2:<ADA.GENERAL>OVWELCOME.DOC if you want to see it again or copy it for other uses. Feel free to distribute this message and any other files in PD2:<ADA.GENERAL> that you wish to take. You may publish these files (in PD2:<ADA.GENERAL>) in any newsletter or commercial publication you desire without restriction. This message contains the following files: FILE CONTENTS PD2:<ADA.GENERAL>OVASR.DOC Overview of the Ada Software Repository PD2:<ADA.GENERAL>OVNAMING.DOC File/Directory Naming PD2:<ADA.GENERAL>AAREAD.ME Pointers to Answers to Common Questions PD2:<ADA.GENERAL>OVFINDME.DOC How to Find Things PD2:<ADA.GENERAL>OVSERVICE.DOC Services Offered and NOT Offered by ASR PD2:<ADA.GENERAL>OVREVIEW.DOC Review Codes PD2:<ADA.GENERAL>OVMLIST.DOC About the ADA-SW Mailing List PD2:<ADA.GENERAL>OVTAPE.DOC Acquiring Magtape of Repository PD2:<ADA.GENERAL>OVFLOPPY.DOC Acquiring IBM PC Floppies of Repository PD2:<ADA.GENERAL>OVFTP.DOC Acquiring Files via FTP PD2:<ADA.GENERAL>OVCDROM.DOC Acquiring CD-ROM of Repository PD2:<ADA.GENERAL>OVUUCPBIT.DOC For USENET (UUCP) and BITNET Users PD2:<ADA.GENERAL>OVNEWSLTR.DOC About the ASR Newsletter PD2:<ADA.GENERAL>OVINDEX.DOC About the ASR Master Index PD2:<ADA.GENERAL>OVDIRLIST.DOC Summary of ADA Directories PD2:<ADA.GENERAL>OVASRSUPP.DOC The Supporting Contractor of the ASR Welcome to the Ada Software Repository on SIMTEL20! Richard Conn Manager, Ada Software Repository ----> OVASR.DOC, Version 1.2 <---- THE ADA SOFTWARE REPOSITORY (ASR) ON SIMTEL20 A repository of Ada programs, software components, and educational material has been established on the SIMTEL20 host computer on the Defense Data Network. This repository has been accessible to any host computer on the network since November 26, 1984. The Ada Software Repository (ASR) provides a free source for Ada programs and information. By employing the File Transfer Protocol (FTP) program, users of DDN hosts are able to scan the directories of the repository and transfer files to their hosts. If the files are Ada programs, they may then compile these programs and use them as they desire. Modifying these programs may be within their rights, and they may freely distribute these programs as they desire, subject to the restrictions specified for each piece of software in its prologue. The Ada Software Repository is available via FTP and on magtape, floppy disk, and CD-ROM. The Ada Software Repository on SIMTEL20 serves two basic roles: to promote the exchange and use (reusability) of Ada programs and tools (including components) and to promote Ada education (specifically by providing several working examples of programs in source form for people to study and modify). All members of the Ada community are encouraged to freely extract information and programs from the repository as well as make contributions to it. The only restrictions which apply to the access and use of this software are presented in the "Distribution and Copyright" section of the prologue associated with each piece of software. The Ada Software Repository is one of several repositories located on the SIMTEL20 Defense Data Network host computer at White Sands Missile Range in New Mexico. SIMTEL20 is owned and operated by the Operations and Systems Integration Division of the Information Systems Command of the US Army. The Ada Software Repository is sponsored by the Operations and Systems Integration Division at White Sands Missile Range with additional funding provided by the STARS (Software Technology for Adaptable, Reliable Systems) Joint Program Office at the Pentagon. DISCLAIMER ========= All software, documentation, and other items of information in the Ada Software Repository are in the public domain. These software, documentation, and information files are provided "AS IS" and without any expressed or implied warranties whatsoever. No warranties as to performance, merchantability, or fitness for a particular purpose exist. Because of the diversity of conditions and hardware under which this software may be used, no warranty of fitness for a particular purpose is offered. The user is advised to test the software thoroughly before relying on it. The user must assume the entire risk and liability of using this software. In no event shall any person or organization of people be held responsible for any direct, indirect, consequential or inconsequential damages or lost profits. Documentation on or mention of any company or its products in any of the files in the Ada Software Repository or in any documents published by the Support Contractor of the Ada Software Repository is provided for the information of the ASR user community only and does not in any way constitute an endorsement. ----> OVNAMING.DOC, Version 1.3 <---- FILE AND DIRECTORY NAMING CONVENTIONS ON SIMTEL20 SIMTEL20 is a DEC 20 host computer which runs the TOPS-20 operating system. SIMTEL20's full name, which must be used in conjunction with file transfer via FTP and electronic mail, is: WSMR-SIMTEL20.ARMY.MIL This file briefly describes the file and directory naming conventions under TOPS-20; this is not a complete description, but it should be enough to allow you to work with the software repositories on SIMTEL20. 1. Directory Names ================== Directory names in the various software repositories on SIMTEL20 take the general forms of: disk:<directory_name> and disk:<directory_name.subdirectory_name> All software repositories reside on the disks named PD1, PD2, and PD3 (for Public Domain 1, 2, and 3). Case is not signficant. Examples of directory names: PD2:<ADA> or pd2:<ada> -- top level of the Ada Software Repository PD2:<ADA.GENERAL> -- the GENERAL subdirectory under the ASR 2. File Names ============= File names under TOPS-20 are of the following general forms: file_name.file_type.version_number Both the file name and file type fields are not case sensitive. Each field can be quite long, but, as a general rule, the file name field is restricted to 9 characters (the first 6 are unique) and the file type field is restricted to 3 characters; this is to enhance transportability between different operating systems. The version number field is optional when referencing a file; if omitted, the latest version of the file is referenced. Examples of file names: MYFILE.TXT ADA-SW.NOT 3. Full File Reference ====================== Directory names and file names may be concatenated in order to provide a complete reference to a file. When referencing a file in the current directory, the file name may be omitted. Examples: PD2:<ADA>ADA.CRC PD2:<ADA.GENERAL>OVNAMING.DOC ----> AAREAD.ME, Version 1.2 <---- ADA SOFTWARE REPOSITORY ON SIMTEL20 COMMONLY ASKED QUESTIONS AND WHERE TO FIND THE ANSWERS The following is a collection of questions and the names of files which contain complete or partial answers to these questions. Unless otherwise noted, these files are contained in PD2:<ADA.GENERAL>. QUESTION FILES 1. What is the Ada Repository on SIMTEL20? OVASR.DOC, AAREAD.ME, OVWELCOME.PRO 2. How do I Access the Ada Repository? OVFTP.DOC, OVUUCPBIT.DOC OVTAPE.DOC, OVFLOP.DOC 3. How do I Find Out What is in the Ada Repository? OVFINDME.DOC, OVMLIST.DOC, OVDIRLIST.DOC, OVNEWSLTR.DOC OVINDEX.DOC 4. How do I Submit Software and other Items to the Ada Repository? OVSUBMIT.DOC 5. How do I Contact the Repository Maintainer and other Users of the Repository? OVMLIST.DOC 6. How do I get Started with Using the Ada Repository? OVWELCOME.DOC, OVMLIST.DOC OVINDEX.DOC, OVNAMING.DOC 7. How do I Contact the Authors of Software in the Ada Repository? OVPROLOGUE.DOC, OVSUBMIT.DOC ----> OVFINDME.DOC, Version 1.3 <---- HOW TO FIND THINGS IN THE ADA SOFTWARE REPOSITORY ON SIMTEL20 The contents of the Ada Software Repository are organized in a number of different ways to make finding software and documentation easier for the user of the repository. The following summarizes the information sources. WELCOME MESSAGE ============== The Welcome Message is a text file which is sent to all new subscribers to the ADA-SW electronic mailing list. This message contains introductory material on the Ada Software Repository, the operation and use of the Ada Software Repository, and the Defense Data Network. The Welcome Message is stored in PD2:<ADA.GENERAL>OVWELCOME.DOC. SIMPLE DIRECTORY DISPLAYS ========================= FTP can provide most users with a directory display of all files in any of the archives in the Ada Software Repository. See the following files for more information: PD2:<ADA.GENERAL>OVASR.DOC -- general info on repository contents PD2:<ADA.GENERAL>AAREAD.ME -- archive structures PD2:<ADA.GENERAL>OVDIRLIST.DOC -- list of subdirectories PD2:<ADA.GENERAL>OVFTP.DOC PD2:<ADA.GENERAL>FTP.DOC PD2:<ADA.GENERAL>FTP1.DOC PD2:<ADA.GENERAL>FTP2.DOC PD2:<ADA.GENERAL>FTPBINARY.DOC -- introduction to FTP and file transfer ONLINE DOCUMENTATION SYSTEM =========================== The directory PD2:<ADA> contains the files ADA.DB and ADA.HDR. ADA.DB contains a machine-readable, comma-delimited ASCII text database that can be read by a number of database and spreadsheet programs (such as dBASE II, SuperCalc, etc). This database contains a taxonomy of the ASR, file specifications, and brief descriptions of each item in the ASR. The file ADA.HDR names the database record fields and gives their size, starting row (on a spreadsheet), and starting column (on a spreadsheet) in a format read by several popular spreadsheet programs. These files are updated frequently. NEWSLETTERS =========== Newsletters are available in electronic form and placed in the directory PD2:<ADA.NEWS>. They are also available in hardcopy form. See the file PD2:<ADA.GENERAL>OVNEWSLTR.DOC for details. MASTER INDEX ============ A Master Index of all software and information in the Ada Software Repository is a 300+ page loose-leaf book is updated periodically as the repository grows. See the machine-readable Master Index in the PD2:<ADA.MASTER-INDEX>*.CH files or the file PD2:<ADA.GENERAL>OVINDEX.DOC for details. PROLOGUE FILES ============== Each piece of software has an associated PROLOGUE file of type PRO (eg, SAFEIO.PRO) which contains the Ada Software Repository standard header. See the file PD2:<ADA.GENERAL>OIPRO.SRC for more information. ITEM DESCRIPTION FILES ====================== Each item of software and information has an associated ID (Item Description) file in the directory PD2:<ADA.ID-FILES>. This is the database from which the Master Index book and the ADA.DB and ADA.HDR files are created. Software items are described in SID files, and textual items are described in TID files. The files ADA.TAX and ADAF.TAX (which list the taxonomy of the ASR) are also created from this database, and ADAF.TAX lists the taxonomy with pointers back to the ID files from which the taxonomy entries were created. TOP-LEVEL FILE LISTINGS ======================= In PD2:<ADA> are several ADA.* files which contain listings of the files in the Ada Software Repository in various formats. These files are updated frequently. Some of them are: ADA.CRC - listing of files by directory with byte counts and CRCs ADA.UUE - UUENCODED form of ADA.CRC ADA.DB - machine-readable database of the ASR (see elsewhere in this document for details) ADA.HDR - companion file to ADA.DB ADA.RPT - listing of files by directory with line and byte counts ADA.SNP - listing of directories (no files) with overall sizes in lines and bytes ADA.TAX - taxonomy of the ASR ADAF.TAX - taxonomy of the ASR with associated ID files referenced ADA.TIM - listing of the files in reverse chronological order (useful if you get tape updates of the ASR and want to see what has changed since your last update) ADAID.TIM - listing of the ID files in reverse chronological order (useful if you want to see what items have been added or changed recently) ADA.USE - listing of files by number of accesses GENERAL ======= The files in PD2:<ADA.GENERAL> contain information on what is in the Ada Software Repository, how to access and use the Ada Software Repository, and other items of interest to the community. Files prefixed by OV (e.g., OVFINDME.DOC) are overview files; files prefixed by OI (e.g., OIPRO.SRC) are operational information files which are used by submitters and people wanting to set up their own repositories. ASSISTANCE VIA TELEPHONE, ELECTRONIC MAIL, and CONVENTIONAL MAIL ================================================================ Questions about the Ada Software Repository may be answered by contacting the support contractor; see the Master Index, the ASR Welcome Message, or the file PD2:<ADA.GENERAL>OVASRSUPP.DOC for details. ----> OVSERVICE.DOC, Version 1.1 <---- This document describes services offered by the Ada Software Repository (ASR) to its users. This document also briefly discusses services which support the ASR community that are offered by companies and other organizations outside of the ASR itself and services which are specifically NOT offered by the ASR. --------------------------------------------------------------------- SERVICES OFFERED BY THE Ada SOFTWARE REPOSITORY The following services are provided as a part of the operation of the Ada Software Repository (ASR). Details on how to actually use these services are provided in the ASR Welcome Message and other files in the General Information subdirectory (named PD2:<ADA.GENERAL>) of the ASR. The ASR user should start with the ASR Welcome Message to answer his questions. 1. File Distribution via FTP ============================ The anonymous login convention is supported. Internet users can employ the FTP programs on their host computers to log into the repository and transfer files from the repository. No fee is charged for this service. 2. File Distribution via Magnetic Tape ====================================== Blank magnetic tapes can be sent to the Support Contractor of the ASR with return postage, and a copy of the entire ASR will be placed on them and returned to the sender. No fee is charged for this service. 3. ADA-SW and SW-COMP Electronic Mailing Lists ============================================== Internet users and users on other networks connected to the Internet via electronic mail gateways may subscribe to the ADA-SW and SW-COMP electronic mailing lists. Notices of new submissions to the ASR and other items of interest to users of the ASR are posted to ADA-SW. Discussions of topics relating to software reuse and reusable software component design are posted to SW-COMP. No fee is charged for this service. 4. ASR Newsletter ================= The ASR Newsletter contains notices of all new submissions to the ASR (where each newsletter documents all new submissions since the last newsletter), articles of interest to users of the ASR, press releases, calls for papers, and other items of information. Machine-readable copies of the ASR Newsletter are available in the PD2:<ADA.NEWS> subdirectory of the ASR without charge, and a hardcopy subscription to this newsletter is available for a fee from the ASR Support Contractor. 5. ASR Master Index =================== The ASR Master Index is a book which contains a taxonomy of the ASR and abstracts of all items in the ASR. Over 300 pages long, this book is updated every few months, with the nature of the revisions being posted in the ASR Newsletters to facilitate updating by those who already have a copy of the book and just wish to update only the chapters that have changed. The ASR Master Index is available in machine-readable form from the PD2:<ADA.MASTER-INDEX> subdirectory of the ASR without charge, and a hardcopy of the current issue of this book is available from the Support Contractor (there is no charge to organizations within the US Government and there is a fee charged to others). 6. ASR Online Database ====================== An online database containing information on the items in the ASR is available in the PD2:<ADA> subdirectory as the files ADA.DB and ADA.HDR. The data itself is in the file ADA.DB, and the record structure is in the file ADA.HDR. The format of the ADA.DB file is a comma-delimited standard that is recognized by many PC-based database management programs, and it can be readily converted into their unique formats and used by them. This database is updated each time a new item is added to the ASR. No fee is charged for this service. 7. ASR Dynamic Information Files ================================ Several information files on the content of the ASR are maintained in the PD2:<ADA> subdirectory of the ASR. These files are often updated each time a new item is added to the ASR. See the ASR Welcome Message for information on them. No fee is charged for this service. 8. Telephone, Electronic Mail, and Conventional Mail Assistance =============================================================== Questions about the ASR may be answered by phoning, sending electronic mail to, or writing the ASR Support Contractor. See the file PD2:<ADA.GENERAL>OVASRSUPP.DOC or the ASR Welcome Message for information on contacting the ASR Support Contractor. --------------------------------------------------------------------- SERVICES OFFERED OUTSIDE THE ASR Several companies and organizations are offering services, usually for a fee, in addition to those offered by the ASR itself. These services include alternate online access to the ASR with value-added reviews of the items in the ASR, floppy disk distribution of the ASR, CD-ROM distribution of the ASR, and reviews of the ASR. These other services are described in the ASR Welcome Message, the ASR Master Index book, and various files in the PD2:<ADA.GENERAL> subdirectory. --------------------------------------------------------------------- SERVICES NOT OFFERED BY THE ASR While the ASR offers many services to its users, there are certain services NOT offered which some users have requested. These services are not offered because of limitations placed on the ASR activity by laws of the US Government (such as the export control laws), by regulations effective within the DoD (such as certain Army regulations), by physical limitations of the Internet capacity (particularly the bandwidth of the DDN backbone and the mail capacity limitations of many Internet email gateways), and by funding and manpower limits. In particular, services NOT offered by the ASR include: 1. sending files other than short information files to users via electronic mail, either manually or by use of an archive server 2. providing a copy of just part of the ASR on magnetic tape (as opposed to providing a magnetic tape copy of the entire ASR, which IS a service as mentioned above) 3. floppy disk distribution of the ASR 4. magnetic tape distribution of the ASR in formats other than those specifically named in the ASR documentation ----> OVREVIEW.DOC, Version 1.3 <---- ASR REVIEW CODES The database maintained on the Ada Software Repository (ASR) includes Review Codes which are used to indicate to some extent the level of trust which may be placed in a particular item. These Review Codes are defined as follows: Code Meaning ==== ======= 500 The item has been accessed more than 500 times 1000 The item has been accessed more than 1000 times CMM Comment Files (*.CMM, *.CM2, etc) are available which describe one or more problems with the item CS Compiled Successfully (followed by an indication of the Ada compiler used in parentheses) by the reviewer ES Executed Successfully (followed by an indication of the target computer used in parentheses if different from the systems mentioned in the CS list) by the reviewer MF-CODE Missing File - Code; one or more files of source code are missing; the item cannot be compiled without these files MF-DATA Missing File - Data; one or more files used as input data when the compiled code runs are missing; the item cannot be executed without these files NR Not Reviewed RI Review Incomplete (only some results of a partial review are posted) ----> OVMLIST.DOC, Version 1.3 <---- ELECTRONIC MAILING LISTS SUPPORTED BY THE ASR Two electronic mailing lists are currently supported by the Ada Software Repository (ASR) activity: ADA-SW -- for users of the ASR SW-COMP -- for people interested in discussing software reuse These lists are described in the following sections. --------------------------------------------------------------------- ADA-SW ELECTRONIC MAILING LIST ============================== An electronic mailing list exists for those who are interested in accessing and contributing software to the Ada Software Repository (ASR) on SIMTEL20. To subscribe to this mailing list, send a request via electronic mail to: ADA-SW-REQUEST@WSMR-SIMTEL20.ARMY.MIL After you have been logged into the repository's mailing list, you will receive a welcome message which provides introductory information on how to access the repository. The mailing list serves two purposes: to help exchange information between the repository users and to mail repository submissions to the maintainer of the Ada Software Repository for inclusion in the archives. A hardcopy newsletter and other hardcopy documentation on the Ada Software Repository are published by the ASR Support Contractor. The file PD2:<ADA.GENERAL>OVASRSUPP.DOC and the ASR Welcome Message contain instructions for contacting him. ADA-SW ADDRESSES and ARCHIVES ============================= If you wish to send a message to the entire ADA-SW reading list, address your message to: ADA-SW@WSMR-SIMTEL20.ARMY.MIL If you wish to discuss an administrative matter, such as changing your mailing address on the ADA-SW email list, address your message to: ADA-SW-REQUEST@WSMR-SIMTEL20.ARMY.MIL PD2:<ARCHIVES.ADA-SW>ADA-SW-ARCHIV.TXT contains all recent messages passed over the ADA-SW mailing list. New users on the list are invited to get a copy of this file and scan it for background; older users may use it for reference. PD2:<ARCHIVES.ADA-SW>yymm.v-TXT-Z contains older messages by year/month in a compressed (UNIX) form. --------------------------------------------------------------------- SW-COMP ELECTRONIC MAILING LIST =============================== The main objective of SW-COMP is to provide a forum for discussions about software components and their design, implementation, and utilization. Sponsored as a part of the Ada Software Repository activity at White Sands Missile Range, discussions on SW-COMP are not by any means limited to software components written in Ada. SW-COMP is for software components written in any language, including Ada, Objective C, C++, and any other language of interest to the readers of this list. This list is oriented to professional component developers, people who are training to become such a professional, and people who have an interest in developing their own components. This list is open to any person interested in the topics of software components and software reuse through components. As a "public service," this list has a secondary function of providing a forum for reviewing and discussing the software components developed by vendors, government contractors, and other sources. Components found in commercial software products as well as public sources, such as the Ada Software and UNIX-C Repositories on SIMTEL20 and the Data and Analysis Center for Software at Rome Air Development Center, may be topics for discussion on this list. The people who have developed software components which are criticized on this list will be given the opportunity to discuss this criticism and seek ideas on how the components may be improved. DISCLAIMER: All messages posted to this list are in the public domain. These messages are provided "AS IS" and without any expressed or implied warranties whatsoever. The opinions and statements expressed in these messages are to be considered to be those of the author, unless otherwise stated by the author, and do not in any way constitute an endorsement or official statement by any organization of the US government or other entity unless it is so stated. SW-COMP ADDRESSES and ARCHIVES ============================== This list is run as a digest. People on the list can address their messages to: SW-COMP@WSMR-SIMTEL20.ARMY.MIL These messages will be automatically collected and released at least once a day (except when the list administrator is not available) as a digest, where the subjects of the messages are presented at the beginning of the digest message. Messages sent to SW-COMP which are not of general interest to the readers, such as administrative messages or messages in conflict with DDN policy, will be filtered out (with an appropriate explanation sent to the sender if possible). Requests for new subscriptions, list deletions, and other administrative matters should be addressed to: SW-COMP-REQUEST@WSMR-SIMTEL20.ARMY.MIL The directory PD2:<ARCHIVES.SW-COMP> is an archive of all messages transmitted on this list. The file SW-COMP-ARCHIV.TXT contains recent messages; files named yymm.1-TXT-Z contain older messages by year and month in a compressed (UNIX) form. ----> OVTAPE.DOC, Version 1.5 <---- ADA SOFTWARE REPOSITORY AVAILABLE ON TAPE Tape copies of the Ada Software Repository (ASR) are available on 9 Track, 1600 and 6250 BPI magtapes in the following formats: Format Target Computer ------ --------------- TOPS-20 DUMPER DEC-20 TOPS-10 INTERCHANGE DEC-10, DEC-20 UNIX TAR UNIX ANSI VAX/VMS, other All tapes listed above are available from the support contractor for the ASR (see the ASR Welcome Message or the file PD2:<ADA.GENERAL>OVASRSUPP.DOC). Additionally, the DEC Users' Society (DECUS) is distributing the ASR in the various tape formats supported by DEC (VMS BACKUP, TK50, etc). Details are presented later in this file. --------------------------------------------------------------------- 9 Track, 1600 and 6250 BPI Tape Formats Supported: TOPS-20 DUMPER TOPS-10 INTERCHANGE UNIX TAR ANSI Charge by the ASR Support Contractor: None Instructions: (1) Send the number of tapes indicated by Table 1 below, a stamped, self-addressed mailing label, and a short, informal cover letter stating that you would like a copy of this collection and specifying the format. Personnel at White Sands will copy to the tapes as they have time and mail them back to you. (2) Please send your tapes to the ASR Support Contractor. His address, phone number, and business hours are in the file PD2:<ADA.GENERAL>OVASRSUPP.DOC and in the ASR Welcome Message. Send a completed UPS Collect or Federal Express Collect form to cover payment of postage. (3) Status of tape requests made to the ASR Support Contractor can be determined by contacting him by phone or in writing. - Table 1: Collections and Tape Counts from the ASR Support Contractor - A Ada Software Repository (Ada Collection) B PC-Blue Collection P All of the PD: (Public Domain) Collections U Unix Collection A - Ada Software Repository in ANSI format at 1600 BPI - 6 tapes (note: VAX/VMS users can read ANSI) in ANSI format at 6250 BPI - 2 tapes (note: VAX/VMS users can read ANSI) in TOPS10 INTERCHANGE at 1600 BPI - 3 tapes in TOPS10 INTERCHANGE at 6250 BPI - 1 tape in TOPS20 DUMPER at 1600 BPI - 1 tape in TOPS20 DUMPER at 6250 BPI - 1 tape in UNIX TAR at 1600 BPI - 3 tapes in UNIX TAR at 6250 BPI - 1 tape B - PC-Blue Collection in TOPS20 DUMPER at 6250 BPI - 1 tape in UNIX TAR at 6250 BPI - 2 tapes P - Public Domain Collection (on disks PD1: and PD2:) in TOPS10 INTERCHANGE at 6250 BPI - unknown (but provided) in TOPS20 DUMPER at 6250 BPI - 10 tapes in UNIX TAR at 6250 BPI - 10 tapes U - UNIX/C Collection in TOPS20 DUMPER at 6250 BPI - 1 tape in UNIX TAR at 6250 BPI - 1 tape --------------------------------------------------------------------- Distribution by DECUS ===================== POC: Ted Nieland - SRL <TNIELAND%FALCON@AAMRL.AF.MIL> The MSDOS, ADA, and UNIX-C collections have been submitted to the DECUS Library. They have been assigned part numbers as listed below. The MS-DOS collection was broken into two pieces (it would not fit on a single TK50 tape). Here are the part numbers: SIMTEL20 Unix-C Collection VMS BACKUP Format............V-SP-88 SIMTEL20 Unix-C Collection TAR Format...................U-SP-105 SIMTEL20 MSDOS Collection Part 1 VMS BACKUP Format......V-SP-89 SIMTEL20 MSDOS Collection Part 2 VMS BACKUP Format......V-SP-90 SIMTEL20 ADA Collection VMS BACKUP Format...............V-SP-91 Ted will be attempting to update these collections in the DECUS Library every six months or so. He will be FTPing all files that changed and removing the superseded files to get a current copy of the archive, without having to get the entire archive again. The address and phone number for the DECUS Library is: The DECUS Program Library 219 Boston Post Road BP02 Marlboro, MA 01752-1850 Phone: 508 480-3418 ----> OVFLOPPY.DOC, Version 1.6 <---- ADA SOFTWARE REPOSITORY AVAILABLE ON IBM PC FLOPPIES Parts of the Ada Software Repository are available on IBM PC compatible floppy disks. The following organizations are providing this service: Organization For Whom Service is Provided ------------ ---------------------------- C2MUG, Fort Leavenworth, KS All echelons within the DoD and the US Federal Government PC-BLUE, NYACC, NY Anyone Advanced Software Technology Anyone ------------------------------------------------------------------------- 1. C2MUG, Fort Leavenworth, KS ============================== C2MUG (Command and Control Microcomputer User's Group) provides a forum of the exchange of ideas and public domain software between microcomputer users, keying on command and control applications. C2MUG provides a focal point for microcomputer users throughout the US Army, and it is sponsored by the Communications-Electronics Command (CECOM). The staff of C2MUG is located at the CECOM Maneuver Control Directorate, Building 138, at Fort Leavenworth, Kansas. C2MUG provides a continuing forum whereby users can: - learn of the latest command and control efforts - participate in contributing ideas and software - seek solutions to microcomputer software problems - learn more about micros relating to their military work environment - receive a free bi-monthly newsletter - receive a free annual software catalog - receive copies of public domain software in exchange for blank floppy diskettes - attend an annual microcomputer seminar - have access to an Electronic Bulletin Board C2MUG provides assistance to its users through a full-time staff. The staff assists with software problems either directly, by referral to another user with the desired background/expertise, or through Requests for Assistance in the monthly newsletter and/or on the Electronic Bulletin Board. Available software consists of over 500 programs, primarily for use with the Apple II Plus/IIe/IIc and IBM PC and compatibles. Some programs are also available for the Wang. C2MUG offers its services to all echelons within the US Army community, the sister military services, and elements of the Federal Government. There is no cost or obligation associated with joining C2MUG, and the services (including the newsletter, catalog, and public domain software copying) are free. For more information, contact C2MUG: Associate Director MCSD Attn: AMSEL-RD-SE-BCS-MC (C2MUG) Fort Leavenworth, Kansas 66027-5600 Phone: AV 552-7550, FTS 753-7550, Commercial 913/684-7550 ---------------------------------------------------------------------- 2. PC-BLUE, NYACC, New York =========================== The New York Amateur Computer Club, Inc., offers a world-wide distribution service of software and information on IBM PC diskettes. A network of volunteer organizations and individuals, including many computer clubs and electronic bulletin boards, distributes the PC-BLUE Library to the public. The PC-BLUE Library now contains part of the Ada Software Repository. The software distributed by C2MUG (see above) is also distributed by PC-BLUE. If you are interested in accessing ASR software and information through PC-BLUE, contact (in writing): PC-BLUE Library New York Amateur Computer Club, Inc. Box 3442 Church Street Station New York, NY 10008 -------------------------------------------------------------------------- 3. Advanced Software Technology, Inc. ===================================== The Ada Software Repository is being distributed by Advanced Software Technology, Inc., on high-density (1.2 megabyte) MS-DOS formatted floppy disks. At the time of this writing (May, 1989), the cost per disk, which includes shipping and handling, is $10.00, and New York state residents should add $0.75 per disk to cover applicable taxes. Disks may be ordered from: Advanced Software Technology, Inc. PO Box 937 Medford, NY 11763 516/289-6646 The files are in a compressed format, and there are currently 29 disks in the distribution. A hard disk is required to provide sufficient space to uncompress the files. ----> OVFTP.DOC, Version 1.3 <---- ADA SOFTWARE REPOSITORY AVAILABLE VIA FTP The Ada Software Repository is on the Defense Data Network, and all files in it are available via the File Transfer Protocol with anonymous login. The following book describes the Ada Software Repository and how to access it via FTP on the Defense Data Network: "The Ada Software Repository and the Defense Data Network: A Resource Handbook" by Richard Conn. Published in 1987, 200+ pages. Contact the Ada Software Repository support contractor (see the file PD2:<ADA.GENERAL>OVASRSUPP.DOC) or the publisher to acquire it; the publisher is: New York Zoetrope 838 Broadway New York, NY 10003 Phone: 800/242-7546 Other information on using FTP is available within the Ada Software Repository itself; send electronic mail requests for this information to: ADA-SW-REQUEST@WSMR-SIMTEL20.ARMY.MIL The files on FTP in the ASR are: PD2:<ADA.GENERAL>FTP.DOC PD2:<ADA.GENERAL>FTP1.DOC PD2:<ADA.GENERAL>FTP2.DOC PD2:<ADA.GENERAL>FTPBINARY.DOC PD2:<ADA.GENERAL>OVFTP.DOC (this file) The full name of the SIMTEL20 host computer, which must be used in conjunction with FTP, is WSMR-SIMTEL20.ARMY.MIL. Anonymous login convention applies. ----> OVCDROM.DOC, Version 1.2 <---- ASR ON CD-ROM The Ada Software Repository (ASR) is available on CD-ROM (Compact Disk Read-Only Memory) as part of the US Air Force's MCCR (Mission Critical Computer Resource) Acquisition Library Demonstration. This CD-ROM contains the entire Ada Software Repository as well as the CAMP (Common Ada Missile Packages) parts and machine-readable copies of several Air Force documents. This CD-ROM is called the "Acquisition Information Resource Demonstration Disc," and it has a total capacity of 550M bytes. It is For Official Use Only and available to selected parties from: Computer Resource Management Technology Program (PE 64740F) ESD/XRS1 Hanscom AFB, MA 01731-5000 617/377-2713 AV 478-2713 POC: 1LT Mark Ziemba (ZIEMBAM@ESDVAX.ARPA) The Ada Software Repository is also available on CDROM from a commercial firm, ALDE Publishing. At the time of this writing, the cost of the Ada CDROM was under $110. For more information, contact: ALDE Publishing PO Box 35326 4830 West 77th Street Minneapolis, MN 55435 Voice: 612/835-5240 FAx: 612/835-3401 Dennis Burke is the project manager. ----> OVUUCPBIT.DOC, Version 1.1 <---- ACCESSING THE ADA SOFTWARE REPOSITORY VIA UUCP (USENET) AND BITNET "How can a user of a USENET host access the public domain microcomputer software collection on the DDN/MILNET host SIMTEL20?" is being asked with increasing frequency as that software collection continues to grow. Unfortunately, direct access is not possible as there is no UUCP gateway for file transfer between SIMTEL20 (running TOPS-20) and a USENET host (as there is for electronic mail). DDN, formerly known as ARPANET, is the Defense Data Network. DDN, along with Arpanet, SATNET, SRINET, etc. are all members of a TCP/IP protocol-based, multiple gateway network called InterNet. USENET has been built on adjacent hosts voluntarily agreeing to store- and-forward relatively short messages across the USENET over dialup lines at 300 or 1200 bps. In the past, helpful InterNet users would fetch the file(s) requested and then e-mail them to the requestor. However, it has been pointed out that large file transfers disrupt the service, delay the shorter messages, and generate unacceptably large phone bills, all of which add up to threaten the tenuous connections that some USENET hosts can barely afford to have. Therefore, we have been asked to encourage InterNet users not to pass archive programs this way. Those USENET and BITNET users who wish to access the files in the Ada Software Repository may acquire them via magtape or IBM PC diskette. See the files PD2:<ADA.GENERAL>OVTAPE.DOC and PD2:<ADA.GENERAL>OVFLOPPY.DOC for details on how to do this. Additionally, the ASR Newsletter documents other methods for accessing the ASR from these communities as they become available; see the file PD2:<ADA.GENERAL>OVNEWSLTR.DOC for details on acquiring the ASR Newsletters. The problem of giving USENET and BITNET users a more timely method of accessing the ASR is being addressed, and details will be released in future issues of the ASR Newsletter. For BITNET Users Only ===================== Michael Feldman of The George Washington University EE&CS Department maintains a mailing list of people at BITNET sites interested in receiving the list of validated Ada compilers and Ada Software Repository Newsletters on a regular basis. Michael can be contacted via electronic mail: MFELDMAN at GWUVM -- BITNET MFELDMAN%GWUVM.BITNET@CUNYVM.CUNY.EDU -- DDN ----> OVNEWSLTR.DOC, Version 1.1 <---- ADA SOFTWARE REPOSITORY NEWSLETTER The Ada Software Repository (ASR) newsletter is published in both electronic form and hardcopy form: 1. Users of the ASR may freely transfer copies of the newsletter from PD2:<ADA.NEWS> via FTP (the newsletters are in the files matching ASR*.DOC). 2. The newsletters are available in electronic form on IBM PC diskettes (see the file PD2:<ADA.GENERAL>OVFLOPPY.DOC for details). 3. The tape distribution of the ASR (see the file PD2:<ADA.GENERAL>OVTAPE.DOC) includes the newsletters. 4. A hardcopy mailing of the newsletter is available from the ASR support contractor (see the file OVASRSUPP.DOC in the directory PD2:<ADA.GENERAL>). Hardcopy subscription to the ASR newsletter is free to all elements of the US Government; the cost to others for a hardcopy subscription to the ASR Newsletter is $16 for 12 copies. ----> OVINDEX.DOC, Version 1.1 <---- ADA SOFTWARE REPOSITORY MASTER INDEX The Master Index of the Ada Software Repository (ASR) is a loose-leaf book which contains details on the software and information in the ASR. Each item of software is described by an abstract, information on the host compiler/operating system and target environment, and a listing of all associated files and their locations in the ASR. Each item of information is described by an abstract and a listing of all associated files. The Master Index breaks down the ASR into the following major categories, each presented as separate chapters: o ASR-Specific Information and Programs o Artificial Intelligence o Benchmarks o Communications o Reusable Software Components o Data Base Management o Documentation o Graphics o Project Management o Ada Software Development Tools o Other Tools o the WIS Ada Tool Set Selected items of information from the ASR are included in the Master Index. These items include the Welcome Message, which gives an extensive introduction to the Ada Software Repository (its operation and use) and the Defense Data Network (with emphasis on the use of FTP to transfer files from the archives on SIMTEL20). The Master Index includes a complete table of contents, which is helpful in quickly locating specific items of interest, and an extensive index. The first publication of the Master Index exceeded 300 pages in size. As the ASR grows, updates to the Master Index will be issued. The loose-leaf format of the Master Index was selected to facilite the update process and to permit the users to assemble the Master Index and the ASR Newsletters conveniently in loose-leaf notebooks. The Master Index and its updates are available through the ASR support contractor. See the file PD2:<ADA.GENERAL>OVASRSUPP.DOC for details on how to contact this contractor. The Master Index is free to all elements of the US Government; the purchase price of the Master Index to others is $50.00 (not including updates). Updates are also free to all elements of the US Government, and their prices to others will be determined as they are released. ----> OVDIRLIST.DOC (Current Version) <---- The following describes the various directories which make up the Ada Software Repository on SIMTEL20. ------------------------------------------ PD2:<ADA> This is the top-level directory. The names of the subdirectories (*.DIRECTORY) and several statistics and information files can be seen here. ------------------------------------------ PD2:<ADA.ABSTRACTIONS> This subdirectory contains the ABSTRACTIONS reusable software components library of Intermetrics. Each file of the library is presented as a separate file, as opposed to the entire library being presented as one large PAGER SRC file. This subdirectory contains the files present within the PAGER SRC file PD2:<ADA.COMPONENTS>ABSTRACT.SRC. ------------------------------------------ PD2:<ADA.ADA-ADOPT> This subdirectory contains Version 1.0 of the "Ada Adoption Handbook: A Program Manager's Guide" by John Foreman and John Goodenough of the Software Engineering Institute in machine-readable form. This is Technical Report CMU/SEI-87-TR-9, ESD-TR-87-110, May 1987. This document is approved for public release. Distribution unlimited. Note: these files have been edited from the original distribution. The original distribution contained additional characters for bold facing and underlining, but no backspaces where included, so the document was not very readable. The editing changes eliminated the duplicate characters and extra spaces and underscores, producing a readable document with no bold facing or underlining. ------------------------------------------ PD2:<ADA.ADA-CAN> "Ada Can" -- the contest to solve the "impossible" problems that "Ada can't do" presented by EVB Software Engineering, Inc. 5320 Spectrum Drive Frederick, MD 21701 (301) 695-6960 DESCRIPTION All of us in the Ada community have heard stories about "deficiencies" in the Ada language. Most of these accounts can be ascribed to one or more of the following problems: - unawareness of one or more language features which directly address the problem. - looking for a single Ada statement which will solve the problem. Oddly, some feel that having to write two or more Ada statements to accomplish one's objectives is a deficiency in the language. - a propensity to duplicate some feature of a more familiar language, e.g., FORTRAN or assembly language. - Wanting an excuse not to use the Ada language. While Ada is not a perfect language, there is much that can be accomplished with the language in its present form. Further, although knowledgeable, the software engineering population frequently seems to be poorly directed. Because we at EVB believe that much could be learned from an endeavor which would promote the positive benefits and strengths of software engineering in Ada, we are announcing the EVB "Ada Can" project. The bound problem definitions and their solutions will be available by Friday, December 9, 1988. ------------------------------------------ PD2:<ADA.ADA-SQL> This subdirectory contains files associated with the development of a standard Ada DBMS interface (Ada/SQL) based on the dpANS Data Base Language SQL. ------------------------------------------ PD2:<ADA.ADAIC> This subdirectory contains information on and files published by the Ada Information Clearinghouse (AdaIC). ------------------------------------------ PD2:<ADA.AI> This subdirectory contains software and information related to the fields of artificial intelligence. ------------------------------------------ PD2:<ADA.ANSI-LRM> This subdirectory contains a machine-readable copy of the ANSI Version of the Ada Language Reference Manual (LRM). Chapters 1-14 and Appendices A-F are included as CHAPxx.DOC (like, CHAP01.DOC or CHAPA.DOC). Error files are also included as CHAPxx.ERR. The Foreword (FOREWORD.DOC, ERR), Postscript (POSTSCRPT.DOC, ERR), and Table of Contents (TOC.DOC) are included. INDEX.DOC contains the index. ------------------------------------------ PD2:<ADA.BENCHMARKS> This subdirectory contains various Ada compiler benchmarks. ------------------------------------------ PD2:<ADA.CAIS> This subdirectory contains software associated with the Common APSE Interface Set (CAIS). The CAIS is defined in MIL-STD-1838. ------------------------------------------ PD2:<ADA.CAIS-TOOLS> This subdirectory contains tools which are compatable with and modified or implemented to run under the CAIS presented in the directory PD2:<ADA.CAIS>. ------------------------------------------ PD2:<ADA.COMPILATION-ORDER> This subdirectory contains software which deals with the analysis of groups of Ada programs to determine the proper compilation order. Other information pertaining to the interrelationship of software segments of a system may be obtained as well. ------------------------------------------ PD2:<ADA.COMPONENTS> This is the components subdirectory. Software components, including general-purpose procedures, packages, and generics, are stored here. Examples are: math packages, TERMCAP routines, generic linked list packages, and dynamic string packages. ------------------------------------------ PD2:<ADA.CROSS-REFERENCE> This subdirectory contains tools which generate cross-reference listings of Ada programs. ------------------------------------------ PD2:<ADA.DBMS> This subdirectory contains Ada software components and programs directly related to Data Base Management functions. ------------------------------------------ PD2:<ADA.DDN> This subdirectory contains tools and components related to the Defense Data Network, its file transfer, mail, and communications facilities. Implementations of the TCP/IP communications protocol, the FTP file transfer tool, and the SMTP mail handler are included. See also PD2:<ADA.DDN2>. ------------------------------------------ PD2:<ADA.DDN2> This subdirectory contains tools and components related to the Defense Data Network, its file transfer, mail, and communications facilities. Implementations of the TCP/IP communications protocol are included. See also PD2:<ADA.DDN>. ------------------------------------------ PD2:<ADA.DEBUGGER> This subdirectory contains Ada source-level debuggers. A Symbolic Debugger is included. ------------------------------------------ PD2:<ADA.EDITORS> This subdirectory contains the source code and documentation on some text editors written in Ada. ------------------------------------------ PD2:<ADA.EDUCATION> This is the education subdirectory. Sample programs, tutorials, and online courseware are located here. ------------------------------------------ PD2:<ADA.EXTERNAL-TOOLS> This subdirectory contains several miscellaneous tools which are helpful in developing Ada code but are not written in Ada or pertain to specific environments. For example, an Ada language development interface for the EMACS editor can be found here. ------------------------------------------ PD2:<ADA.FORMGEN> This subdirectory contains tools for the generation of forms for use by Ada programs. The forms generator will display and accept input into a form (in a screen-oriented fashion via the virtual terminal) in such a way that this mechanism is transparent to the Ada program using it. Instead, the program simply reads fields from the form via procedure interfaces. ------------------------------------------ PD2:<ADA.GENERAL> This is the General Information subdirectory. Notes, comments, usage information, and other data are stored here. ------------------------------------------ PD2:<ADA.GKS> This subdirectory contains routines associated with a Graphical Kernel System. ------------------------------------------ PD2:<ADA.GNU-ADA-MODE> This subdirectory contains the Ada mode implementation for GNU EMACS as developed by Lynn Slater and others. ------------------------------------------ PD2:<ADA.ID-FILES> This subdirectory contains Item Description (ID) files for all items of text and software in the Ada Software Repository. The *.SID files describe the items of software, and the *.TID files describe the items of text. ------------------------------------------ PD2:<ADA.MANAGEMENT-TOOLS> This subdirectory contains tools for use in managing an Ada software development project. Status tracking and Manpower estimation tools are included. ------------------------------------------ PD2:<ADA.MASTER-INDEX> This subdirectory contains a machine-readable copy of the Master Index, a book which documents the items in the Ada Software Repository. The *.CH files are ASCII text files which make up the title page, table of contents and taxonomy, chapters and appendices, and index of the Master Index. The *.CH files files are designed to be printed on 8 1/2" x 11" paper in elite (12 chars/inch) type. No margins should be preset; a 1" margin is already formatted into these files. The order of the files in this subdirectory is: TITLE.CH Title Page TOC.CH Table of Contents and Taxonomy CH01.CH Chapter 1 ... CHnn.CH Chapter nn CHA.CH Appendix A CHB.CH Appendix B INDEX.CH Index Other files in this subdirectory, namely the *.CHS and *.INC files, are data files used in the creation of the Master Index and are not of general interest. ------------------------------------------ PD2:<ADA.MATH> This subdirectory contains packages of math routines. All routines are written in Ada. Routines for trig functions, exponential functions, matrix manipulation, bit manipulation, and others are contained here. ------------------------------------------ PD2:<ADA.MENU> This subdirectory contains software used in the generation of menus. Applications programs may use these menu generators as front-ends. ------------------------------------------ PD2:<ADA.MESSAGE-HANDLING> This subdirectory contains tools for use in message handling facilities and message transfer. ------------------------------------------ PD2:<ADA.METRICS> This subdirectory contains tools used to perform metrics analysis of Ada software. Tools for path analysis, performance analysis, and other metrics reports are included. ------------------------------------------ PD2:<ADA.NEW-ABSTRACTIONS> This subdirectory contains the NEW ABSTRACTIONS reusable software components library of Intermetrics. Each file of the library is presented as a separate file, as opposed to the entire library being presented as one large PAGER SRC file. This subdirectory contains the files present within the PAGER SRC file PD2:<ADA.COMPONENTS>NEWABS.SRC. ------------------------------------------ PD2:<ADA.NEWS> This subdirectory contains the Ada Software Repository (ASR) Newsletters. File names are ASRnnn.DOC. ------------------------------------------ PD2:<ADA.ONLINE-DOC> This subdirectory contains supporting files for the online documentation system of the Ada Repository. ------------------------------------------ PD2:<ADA.PAGER> This subdirectory contains tools which create and manipulated paged files. All SRC files are paged files, which are files composed of several smaller files separated by a special flag. ------------------------------------------ PD2:<ADA.PDL> This subdirectory contains software associated with Ada Program Design Languages and tools to support the Ada program designer. Such tools include tools for data dictionary manipulation and design analysis. There may be some overlap between this directory and software which may fall into the PDL category that is scattered among the other subdirectories. ------------------------------------------ PD2:<ADA.PIWG> TAPE_12_12_87 TAPE_5_1_87 Note: 12/12/87 differs from 5/1/87 in documentation only; this distriubtion is 12/12/87 PIWG is a suite of tests/benchmarks prepared by the Performance Issues Working Group of ACM SIGAda. The purpose of PIWG is to develop the benchmarks and collect and disseminate results. The PIWG tests have been under development for many years and have been run against many Ada compilers. The PIWG test suite contains over 200 files which include Whetstone (to measure processor speed), Dhrystone (to measure statement execution per unit time), and other benchmarks which test various attributes of the Ada language and their implementations under specific compilers. The PIWG tests must be customized for a particular compiler, and instructions are included to do this. ------------------------------------------ PD2:<ADA.POINTERS> This is the pointers subdirectory. Information on other sources of software and information is presented here. This data pertains to both on- and off- net resources. ------------------------------------------ PD2:<ADA.PRETTY-PRINTERS> This subdirectory contains pretty printers for Ada source programs. The pretty printers reformat the Ada source programs in order to outline the structure of the programs and provide other useful information for the programmer. ------------------------------------------ PD2:<ADA.RATIONALE> This subdirectory contains a machine-readable copy of "The Rationale for the Design of the Ada Programming Language." This document has evolved over a number of years. A first version appeared in 1978 as the Rationale for the Green programming language, and this was revised in 1979 at the time that Green was finally selected as Ada. The purpose of these documents was to explain the motivation for the language design, and to justify and defend its position against the other competitive languages and the Ironman (later Steelman) requirements. No corresponding document was written in 1980 when Ada was proposed as a standard, nor in January when Ada finally became both an ANSI and Military Standard. The present version completes and revises a draft issued in January 1984 and which was the subject of public review. ------------------------------------------ PD2:<ADA.REAL-TIME> This subdirectory contains documents and items of Ada software which address questions and standards dealing with the real-time use of the Ada programming language. Documents and information generated and presented by the Ada Runtime Environment Working Group (ARTEWG) are made available in this subdirectory. ------------------------------------------ PD2:<ADA.SEI> This subdirectory contains information on the Software Engineering Institute (SEI) at Carnegie Mellon University (CMU). This information includes details on its mission, activities, and publications. ------------------------------------------ PD2:<ADA.SIMULATION> This subdirectory contains programs and tools associated with performing simulations, such as queuing simulations. ------------------------------------------ PD2:<ADA.SPELLER> This subdirectory contains spelling checkers written in Ada. Dictionaries are also included here. ------------------------------------------ PD2:<ADA.STARTER-KIT> This subdirectory contains tools which are useful in accessing the software in the repository. It includes the PAGER tool, which is used to assemble and disassemble SRC (paged) files. ------------------------------------------ PD2:<ADA.STUBBER> This subdirectory contains Ada program body stubber tools. They analyze the definition of an Ada software design and generate software bodies as stubs to be filled in later during development. ------------------------------------------ PD2:<ADA.STYLE> This subdirectory contains Ada style checking tools. They analyze Ada source code and report on various aspects of the programming style, such as consistent indentation and use of long variable names. ------------------------------------------ PD2:<ADA.TOOLS> This is the miscellaneous tools subdirectory. Sources to various tools which do not fit into the categories of the other subdirectories are placed here. ------------------------------------------ PD2:<ADA.TRANSLATORS> This subdirectory contains tools which convert programs written in one language into Ada automatically. These tools include a COBOL to Ada translator and a FORTRAN to Ada translator. ------------------------------------------ PD2:<ADA.TRI-ADA> This subdirectory contains the results generated by and other materials related to the "Hands-on Ada Workshop and Programming Contest", Tutorial 2 at the TRI-Ada '88 (tm) conference sponsored by ACM/SIGAda from October 24 to October 27, 1988. "Objectives: Evaluate designs and Ada implementations of a small, non-trivial sensor monitoring problem Provide a forum for Ada language experts and embedded system practitioners to jointly explore the Ada process while producing actual code." ------------------------------------------ PD2:<ADA.VIRTERM> This subdirectory contains tools for a virtual terminal package, which performs screen-oriented functions by reading terminal characteristics from a UNIX-like TERMCAP data base. The application program can call routines in these packages and not be concerned with the type of terminal being addressed. ------------------------------------------ PD2:<ADA.WIS-ADA-TOOLS> This subdirectory contains information about the software tools submitted by the Naval Oceans Systems Center (NOSC). An abstract of the tools is included. These tools were paid for by WIS (WWMCCS Information Systems). ------------------------------------------ PD2:<STARS> This top-level directory contains software created under the STARS (Software Technology for Adaptable, Reliable Systems) Foundations contracts. ------------------------------------------ PD2:<STARS.X-WINDOWS> This subdirectory contains an Ada-to-X Windows binding. The current release of the Ada-to-X binding is contained in this directory. Previous releases of the Ada-to-X binding are located in PD2:<STARS.XW-ARCHIVE>. Derivation : MIT X Window System, V11.R2 This Ada language binding to the X Window System inherits the MIT copyright. The following copyright must be included in all software utilizing this binding. Copyright 1985, 1986, 1987 by the Massachusetts Institute of Technology Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of M.I.T. not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. M.I.T. makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. ------------------------------------------ PD2:<STARS.XW-ARCHIVE> This subdirectory contains an Ada-to-X Windows binding. It is an archive of previous releases of the Ada-to-X binding for V11.R1 and V11.R2. The current release of the Ada-to-X binding is located in PD2:<STARS.X-WINDOWS>. See the derivation and copyright notices in PD2:<STARS.X-WINDOWS>A0READ.ME for copyright and use permission information. ------------------------------------------ PD2:<STARS.XW-ARCHIVE> This subdirectory contains an Ada-to-X Windows binding. It is an archive of previous releases of the Ada-to-X binding for V11.R1 and V11.R2. The current release of the Ada-to-X binding is located in PD2:<STARS.X-WINDOWS>. See the derivation and copyright notices in PD2:<STARS.X-WINDOWS>A0READ.ME for copyright and use permission information. ------------------------------------------ ----> OVASRSUPP.DOC, Version 1.3 <---- ADA SOFTWARE REPOSITORY SUPPORT CONTRACTOR The Management Assistance Corporation of America (MACA) provides support to the user community of the Ada Software Repository (ASR) on SIMTEL20. This support includes: 1. hardcopy distribution of the ASR Newsletter to any interested parties (government-related or otherwise), 2. hardcopy distribution of updates to the ASR Master Index to any interested parties, 3. assistance via telephone, electronic mail, and conventional mail to those users who wish to locate items in the ASR, including information on the availability of items through the IBM PC diskette distribution handled by C2MUG and SIG/M, and 4. assistance via telephone, electronic mail, and conventional mail to those users who wish to determine the status of the magtape requests they have made which are processed through MACA at White Sands. To contact MACA in order to be placed on one or both of the distributions or to request assistance, phone 505/678-3288 between the hours of 7:30 AM and 4:00 PM MST. Ask for Prince Levy, Janet McKellar, David Moon, or Mannie Gamez. You may also write to MACA at the following address: Management Assistance Corporation of America PO Drawer 100 - Building T148 White Sands Missile Range, New Mexico 88002 MACA may be reached via electronic mail at: MACAWSMR@WSMR-SIMTEL20.ARMY.MIL The Manager of the ASR may be reached at either of the following electronic mail addresses: ADA-SW-REQUEST@WSMR-SIMTEL20.ARMY.MIL SW-COMP-REQUEST@WSMR-SIMTEL20.ARMY.MIL