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