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