home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / edit / ed2.pro < prev    next >
Encoding:
Text File  |  1988-05-03  |  7.1 KB  |  136 lines
  1.  
  2. -------- SIMTEL20 Ada Software Repository Prologue ------------
  3. --                                                           -*
  4. -- Unit name    : EDITOR (ALED - Ada Line Editor)
  5. -- Version      : 2.1
  6. -- Author       : Richard Conn
  7. --              : Texas Instruments
  8. --              : PO Box 801, MS 8007
  9. --              : McKinney, TX  75069
  10. -- DDN Address  : RCONN at SIMTEL20
  11. -- Copyright    : (c) 1984, 1985 Richard Conn
  12. -- Date created :  9 Nov 84
  13. -- Release date :  5 Dec 84
  14. -- Last update  :  15 Feb 85
  15. -- Machine/System Compiled/Run on : DG MV 10000, ROLM ADE
  16. --              : All system-specific features are isolated in
  17. --        : the package SYSDEP, so I believe
  18. --              : that the editor is transportable between a
  19. --              : a wide variety of environments; I encountered
  20. --              : a number of "surprises" when I programmed the
  21. --              : editor, and I don't know if they were caused
  22. --              : by the ROLM ADE implementation of TEXT_IO or if
  23. --              : they were intentional; see the documentation
  24. --                                                           -*
  25. ---------------------------------------------------------------
  26. --                                                           -*
  27. -- Keywords     :  EDITOR
  28. ----------------:  LINE-ORIENTED EDITOR
  29. ----------------:  INPUT-LINE EDITOR
  30. --
  31. -- Abstract     :  ALED - Ada Line Editor
  32. ----------------:  A Line-Oriented File Editor Written in Ada
  33. ----------------:  by Richard Conn
  34. ----------------:  
  35. ----------------:  ALED is designed to edit text files.  Upon invocation,
  36. ----------------:  ALED prompts the user for a file name.  If the file
  37. ----------------:  exists, its contents (lines) are read in and prepared
  38. ----------------:  for editing; if the file does not exist, the file is
  39. ----------------:  created and the empty buffer is prepared for editing.
  40. ----------------:  ALED is an interactive editor, accepting single-char
  41. ----------------:  commands, filling in a command prompt (for more info
  42. ----------------:  as needed), and performing its functions in real-time
  43. ----------------:  while the user watches.  The functions provided include
  44. ----------------:  (but are not limited to) the following:
  45. ----------------:  
  46. ----------------:     * List Lines
  47. ----------------:     * Insert a Group of Lines into the Edit Buffer
  48. ----------------:     * Delete Lines
  49. ----------------:     * String Search and String Substitution
  50. ----------------:     * Movement Within the Edit Buffer
  51. ----------------:     * Reading in a File After a Specified Line
  52. ----------------:     * Writing out a Range of Lines to a File
  53. ----------------:     * Built-in, online Documentation (Summary)
  54. ----------------:  
  55. ----------------:  ALED's design includes an input line editor, which allows
  56. ----------------:  the user to edit text as he types it.  I was surprised
  57. ----------------:  NOT to find such a basic function available in TEXT_IO.
  58. ----------------:  Did I miss something?
  59. ----------------:  
  60. ----------------:  ALED is divided into the following files.  The order
  61. ----------------:  in which they are listed is the compilation order.
  62. ----------------:  
  63. ----------------:  SIMTEL20      Ada Package/Procedure  Comments
  64. ----------------:  
  65. ----------------:  SYSDEP.ADA     sysdep            Components library
  66. ----------------:                    of single-character
  67. ----------------:                    I/O routines
  68. ----------------:
  69. ----------------:  LIST.ADA      generic_list           Components library
  70. ----------------:                                       of linked-list routines
  71. ----------------:  
  72. ----------------:  ED-SPT.ADA    edit_support           Visible section
  73. ----------------:                                       of editor support
  74. ----------------:                                       package (which contains
  75. ----------------:                                       a few basic routines,
  76. ----------------:                                       such as the input line
  77. ----------------:                                       editor)
  78. ----------------:  
  79. ----------------:  ED-SPTB.ADA   edit_support           Body of editor support
  80. ----------------:                                       package
  81. ----------------:  
  82. ----------------:  ED-WRK.ADA    edit_worker            Visible seciton of
  83. ----------------:                                       workhorse routines
  84. ----------------:                                       for the editor;
  85. ----------------:                                       all major editor
  86. ----------------:                                       functions and their
  87. ----------------:                                       related support
  88. ----------------:                                       routines are here
  89. ----------------:                                       (such as list lines)
  90. ----------------:  
  91. ----------------:  ED-WRKB.ADA   edit_worker            Body of editor
  92. ----------------:                                       workhorse routines
  93. ----------------:  
  94. ----------------:  ED.ADA        editor                 Mainline of ALED
  95. ----------------:  
  96. ----------------:  
  97. --                                                           -*
  98. ------------------ Revision history ---------------------------
  99. --                                                           -*
  100. -- DATE         VERSION    AUTHOR                  HISTORY
  101. -- 12/5/84        1.0   Richard Conn            Initial Release
  102. -- 1/21/85        2.0   Richard Conn            Production version
  103. -- 2/15/85        2.1   Richard Conn            Minor bug fix
  104. --                                                           -*
  105. ------------------ Distribution and Copyright -----------------
  106. --                                                           -*
  107. -- This prologue must be included in all copies of this software.
  108. --
  109. -- This software is copyright by the author.
  110. --
  111. -- This software is released to the Ada community.
  112. -- This software is released to the Public Domain (note:
  113. --   software released to the Public Domain is not subject
  114. --   to copyright protection).
  115. -- Restrictions on use or distribution:  NONE
  116. --                                                           -*
  117. ------------------ Disclaimer ---------------------------------
  118. --                                                           -*
  119. -- This software and its documentation are provided "AS IS" and
  120. -- without any expressed or implied warranties whatsoever.
  121. -- No warranties as to performance, merchantability, or fitness
  122. -- for a particular purpose exist.
  123. --
  124. -- Because of the diversity of conditions and hardware under
  125. -- which this software may be used, no warranty of fitness for
  126. -- a particular purpose is offered.  The user is advised to
  127. -- test the software thoroughly before relying on it.  The user
  128. -- must assume the entire risk and liability of using this
  129. -- software.
  130. --
  131. -- In no event shall any person or organization of people be
  132. -- held responsible for any direct, indirect, consequential
  133. -- or inconsequential damages or lost profits.
  134. --                                                           -*
  135. -------------------END-PROLOGUE--------------------------------
  136.