home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / ada / adastyle / styl-ord.hlp next >
Text File  |  1992-03-12  |  7KB  |  147 lines
  1. Form G85-0392
  2. STYL-ORD.HLP
  3.  
  4. Ada Information Clearinghouse, 1-800/AdaIC-11, 703/685-1477
  5.  
  6. HOW TO OBTAIN Ada QUALITY AND STYLE:
  7. GUIDELINES FOR PROFESSIONAL PROGRAMMERS, VERSION 2.0, 1991
  8.  
  9. Ada Quality and Style: Guidelines for Professional Programmers, Version 2.0, 
  10. 1991 is available for downloading form the AdaIC electronic bulletin board and 
  11. the AJPO host computer.  It is available in hard copy for purchase from the 
  12. Defense Technical Information Center (DTIC) and National Technical Information 
  13. Service (NTIS).
  14.  
  15. PAPER COPIES
  16.  
  17. Defense contractors with DTIC accounts should contact DTIC to order the 
  18. document.  The cost is $11.58.  The DTIC accession number is AD-A242-525:
  19.  
  20. DTIC
  21. Cameron Station
  22. Alexandria, VA  22314
  23. 703/274-7633
  24.  
  25. Other interested parties should contact NTIS to order a copy.  The cost is 
  26. $26.00 for paper copies and $17.00 for microfiche.  The NTIS accession number 
  27. is ADA 242 525.  
  28.  
  29. NTIS
  30. US Department of Commerce
  31. 5285 Port Royal Road
  32. Springfield, VA  22161
  33. 703/487-4600
  34.  
  35.  
  36. ELECTRONIC COPIES
  37.  
  38. Ada Quality and Style on the Internet
  39.  
  40. Ada Quality and Style is available on the AJPO host on the Internet.  The AJPO 
  41. host is accessible only to authorized users of the Defense Data Network and 
  42. other networks that are part of Internet.  The host can be accessed via the 
  43. File Transfer Program (FTP), which allows a user to transfer files to and from 
  44. a remote network host site.  FTP will work for hosts on the Internet, which 
  45. includes DDN and MILNET.  
  46.  
  47. The remote host with which FTP is to communicate can be specified on the 
  48. command line that invokes FTP. In that case, FTP will immediately attempt to 
  49. connect to the host. Once the connection has been established, FTP enters its 
  50. command interpreter, which is indicated by the ftp> prompt. If FTP is invoked 
  51. without a host argument, it will enter the command interpreter right away. An 
  52. example FTP connection follows. 
  53.  
  54. [your-prompt] ftp ajpo.sei.cmu.edu        execute ftp from your remote site. 
  55. name: anonymous                           login using "anonymous" 
  56. password: guest                           enter password of "guest" 
  57. ftp> cd public/adastyle                   change to the appropriate directory
  58. ftp> get README [newname.hlp]             get README.hlp" from ftp and copy it 
  59.                                           to "newname.hlp" on your machine.
  60. ftp> mget file1...fileN                   get multiple files from ftp and load 
  61.                                           them onto your machine with the same 
  62.                                           names. 
  63. ftp> bye                                  logout when finished. 
  64.  
  65.  
  66. Ada Quality and Style on the AdaIC Bulletin Board
  67.  
  68. The Ada Information Bulletin Board system can be accessed by dialing 
  69. (Commercial) 703/614-0215 or (Autovon) 224-0215.  Users should set their 
  70. telecommunications package with the following parameters:
  71.  
  72.       Baud rate = 300 through 9600              Data Bits = 8
  73.       Parity = none                             Stop Bits = 1 
  74.  
  75. Directory 11 of the bulletin board contains the Ada Style Guide in ASCII and 
  76. Postscript versions -- in compressed and uncompressed format.  Files are 
  77. compressed in order to conserve space on the bulletin board system and to 
  78. reduce the time required to download the file.  The AdaIC uses PKZIP for file 
  79. compression on its files.  Use the PKUNZIP.EXE utility to unarchive the 
  80. compressed files.  PKZ101.EXE is available on the bulletin board.  It is a 
  81. self-extracting program, and gives you the PKUNZIP utility as well as others.
  82.  
  83.  
  84.  
  85. BACKGROUND ON AJPO ENDORSEMENT OF ADA QUALITY AND STYLE:
  86. GUIDELINES FOR PROFESSIONAL PROGRAMMERS.
  87.  
  88.  
  89. On Aug. 12, the Ada Joint Program Office (AJPO) and the Software Productivity 
  90. Consortium signed a Memorandum of Understanding aimed at meeting the need of 
  91. the Ada Community and the Department of Defense for a freely available Ada 
  92. style guide.
  93.  
  94. The AJPO is advising defense and military agencies that Ada Quality and Style: 
  95. Guidelines for Professional Programmers is "the suggested Ada Style Guide for 
  96. use in DoD programs".
  97.  
  98. The Consortium will provide the AJPO with both hard copy and electronic 
  99. versions of the guidebook for public distribution on AJPO's Ada Information 
  100. Clearinghouse Bulletin Board and on the AJPO host computer on the Defense Data 
  101. Network (DDN).  The Consortium will also update the guide to meet specific 
  102. AJPO requirements, including those in the areas of reuse, portability, and Ada 
  103. 9X enhancements.
  104. The memorandum, signed by Dr. John P. Solomond, AJPO Director, and Arthur I. 
  105. Hersh, President and Chief Executive Officer of the Consortium, also noted 
  106. that public meetings, co-sponsored by the AJPO and the Consortium, will be 
  107. scheduled to solicit comments on further updates.
  108.  
  109. For some time now, there has been discussion in the Ada community and in the 
  110. Department of Defense about the need for a generally accepted Ada style guide.
  111. The need for a style guide arises because, while the Language Reference Manual 
  112. provides a thorough definition of the Ada language, it was not intended to 
  113. provide complete guidance on the appropriate use of Ada's powerful features.
  114.  
  115. Ada Quality and Style: Guidelines for Professional Programmers was authored by 
  116. the Consortium in 1989; since then, it has become a standard guidebook for Ada 
  117. programming at many organizations.  It offers Ada programmers a set of 
  118. specific guidelines for using the powerful features of Ada in a disciplined 
  119. manner in order to develop Ada code with high degrees of readability, 
  120. portability, and reusability.  (Consortium member company transfer sites 
  121. maintain both hard copy and electronic versions of Ada Quality and Style for 
  122. use by Consortium members.)
  123. The Consortium expects the AJPO recommendation to increase the usage of Ada 
  124. Quality and Style throughout the government and Ada software industry.
  125.  
  126. Ada Quality and Style is not being made into a standard MIL-HDBK.  Instead, it 
  127. is the AJPO's suggested guide.  Pursuing the option of a suggested guide 
  128. allows a flexibility that might be precluded by a military-standard style 
  129. guide.
  130.  
  131.  
  132. It should be understood that, although Ada Quality and Style will be freely 
  133. available for downloading, etc., the Consortium still retains copyrights.  
  134. They have granted permission to use, copy, modify, and distribute copies -- 
  135. but no fee may be charged, and all copies must include the copyright notice 
  136. and the permission notice.
  137.  
  138. Furthermore, the name Software Productivity Consortium, Inc., cannot be used 
  139. in advertising or publicity pertaining to distribution of the guidelines 
  140. without specific, written prior permission.  And Software Productivity 
  141. Consortium, Inc., makes no representations about the suitability of the 
  142. guidelines for any purpose.  It is provided "as is" without express or implied 
  143. warranty.
  144.  
  145.  
  146.  
  147.