home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / mape120.zip / READ.ME < prev    next >
Text File  |  1995-12-23  |  8KB  |  192 lines
  1.                             Program Editor Readme File.
  2.                             ===========================
  3.  
  4. Quick Info:-
  5. PM Based editor with LOADS of features including....
  6.  
  7.     >>>> Customisable edit functions (scripts).
  8.     >>>> Exec to Parse. Test/Make your programs before exiting your editor.
  9.     >>>> Works with most compilers.
  10.     >>>> Customizable goto error keys position you at the error.
  11.     >>>> Extensively MultiThreaded.
  12.     >>>> Smooth Scrolling.
  13.     >>>> Well Tested.
  14.     >>>> Good General Purpose Editor, esp. large files.
  15.     >>>> Fast, Reliable, Safe.
  16.  
  17. To see other features, try it!
  18.  
  19. Note:- Program Editor has been designed for speed. Much useless functionality
  20. has been deliberately omitted. Program Editor V1.2 was written using Program
  21. Editor V1.10 and PM Make V1.00. Simplicity makes for shorter learning curves,
  22. faster load times, and true multitasking even on slow PC's. With these products
  23. program development and project maintenance is faster and more streamlined than
  24. with any other product of it's kind. For further information on PM Make, see the
  25. online help 'About' page.
  26. If you think some important features are missing please let me know and I will
  27. include them in the next version if possible.
  28.  
  29. LEGAL {
  30. This program is the (c) copyright of:-
  31.  
  32.     Peter Koller,
  33.     La vieille Maison d'Anglais,
  34.     Trebuon,
  35.     29530, Plonevez du Faou,
  36.     FRANCE.
  37.  
  38. Note:-
  39. This copyright includes the whole product, including the scripting language
  40. format (but not the example scripts), the install utility, and all documen-
  41. tation associated with the product. All Rights Reserved.
  42.  
  43.     1.You may use the program only on a single machine at any one time. If
  44.       you have purchased a multiple copy, you may use an according number of
  45.       copies simultaneously.
  46.  
  47.     2.You may copy the program into machine readable or printed form for
  48.       backup or data compression purposes. You may not reverse engineer or
  49.       disassemble the program.
  50.  
  51.     3.You may give this copy to others. You may also charge the end user
  52.       reasonable costs incurred by your distribution of this product. Please
  53.       ensure you distribute the entire package as shown below.
  54.  
  55.     4.This product is Shareware. You Must be registered if you continue to use
  56.       this product after you have evaluated it.
  57.  
  58.     5.If you have a Customer Registration Code (CRN), you must not disclose it
  59.       to anyone. Please quote the number shown in the statistics dialog, rather
  60.       than the full CRN, when seeking technical support.
  61.  
  62. The Author accepts no liability for fitness of purpose, or damages caused
  63. whether incidental, or consequential, by the use of this product, howsoever
  64. caused. This product is !! Sold As Seen !!. In those countries where this
  65. statement conflicts with your statutory rights your statutory rights shall
  66. remain unaffected.
  67.  
  68.  
  69. This product consists of:-
  70.  
  71. install.exe         The program install utility
  72. pmpfold.cmd         REXX folder creation, used by install.exe
  73. pmproged.exe        The executable file.
  74. pmproged.hlp        The help File.
  75. pmproged.inf        The help file in .INF format.
  76. pmproged.eas        The extended attributes file.
  77. exe.eas             The .exe file extended attributes.
  78. register.doc        The product registration sheet.
  79. read.me             This file.
  80. uninstal.doc        How to remove (uninstall) Program Editor
  81. main.scr            Main example script.
  82. home.scr            Home example script
  83. eof.scr             End of file example script
  84. poptab.scr          Deindent example script
  85. pushtab.scr         Indent example script
  86. insbkt.scr          Insert Brackets example script
  87. test.scr            Test Message example script
  88. killmenu.scr        Reset menu example script
  89. truncspc.scr        Truncate trailing whitespace example script.
  90.  
  91. The above files will often be found packed in MAPE1??.PK
  92.  
  93. } //end LEGAL
  94.  
  95. Installation Instructions:-
  96.  
  97. Ensure that you have all the necessary files provided. See Legal{...}.
  98. Program editor is included with an install utility. You will be asked to
  99. provide a help path and an executables path. If your system is 'normal' and
  100. you have a 'c:' drive, the default help path will work fine. Otherwise, choose
  101. one of the paths specified in the HELPPATH. See the online OS/2* information
  102. for help on HELPPATH. 
  103. YOU MUST USE THE INSTALL UTILITY. This utility can also be used to Uninstall
  104. or to Register Program Editor.
  105.  
  106. NEW... Extended Attributes:-
  107. PMPROGED now sets EA's for new files. This is essential because it allows you
  108. to double click on your text file to run program editor. Please ensure EAUTIL*
  109. is on your system and in the PATH, as this is what PMPROGED uses.
  110.  
  111. EA's for PMPROGED.EXE:-
  112. In the event that the extended attributes for pmproged.exe are missing, do the
  113. following:-
  114. a)  Make sure you have a copy of exe.eas in the same directory as pmproged.exe
  115.     (eg. c:\pmproged ). If you do not have a copy of exe.eas, you will have to
  116.     obtain one from wherever you found program editor.
  117. b)  run "eautil pmproged.exe exe.eas /o /p /j" from an OS2* command prompt.
  118. Note:- Install normally does the above for you, but then deletes exe.eas.
  119.  
  120. PMPROGED.EAS can be recreated using EAUTIL* on an empty "Program Edited" file
  121. created from a template. The three relevant ea's are .TYPE ("Program Edited"),
  122. .CLASSINFO, and .ICON.
  123.  
  124. That's it !! Enjoy.
  125.  
  126. Registration:-
  127. Please print the file register.doc. This is an order form. Fill in the form and
  128. send it to me with your cheque or money order enclosed. I will then send you a
  129. Customer Registration Number (CRN). Use the Install utility provided to
  130. register.
  131.  
  132. Program Editor is Shareware. As such, it is necessary to register. In turn, I
  133. will undertake to send you the latest version and offer such support as I am
  134. reasonably able to supply.
  135.  
  136. Scripts:-
  137. Here are some more scripts:-
  138.  
  139. /Seek error in parse profile as I use it with IBM CSet++, comments added/
  140. set[hpos,0,set[vpos,0,]                             /clear pointers/
  141. home[,,]                                            /start of line /
  142. find["(",,txtset[vpos,,find[":",,txtset[hpos,,]     /find and get error position/
  143. sysptr[vpos,hpos,]                                  /set the file pointer/
  144. hilite[false,,]                                     /not actually necessary/
  145.  
  146. /Align text start to a tab position/
  147. txthome[,,]tabins[,,]loop[tab,,!stln[,,backsp[,,]
  148.  
  149.  
  150. Problems:-
  151. Program Editor was written under *OS/2 V2.11e and tested using *OS/2 V3.00. I
  152. don't know if it will work with any other versions...
  153.  
  154. Program Editor loads files as it finds them. If the end of line characters are
  155. not in the standard CR, LF (0x0d0a) file format you will have problems. Note
  156. that Program Editor will either read, or append, an eof character (0x1a) at
  157. the end of the file. You cannot overwrite this character, but you can prevent
  158. it being saved. None of these items should normally cause any difficulty.
  159.  
  160. Program Editor allocates 25% of available allocation memory. This ensures that
  161. several copies can run simultaneously. If you get 'PANIC 41 ALMOST OUT OF
  162. MEMORY' errors, you must either a) increase the size of your SWAPFILE, or b)
  163. buy more memory.
  164.  
  165. Program editor is unacceptably slow? This may be because the text file is large
  166. enough to require swapping in and out of memory. Again, either use smaller files
  167. or more memory.
  168.  
  169. Please inform me of any difficulties encountered.
  170.  
  171. Other Products available:-
  172.  
  173. PM Make:-
  174. PM Make is a programmers make utility that makes use of the *PM interface to
  175. provide the necessary functions for project maintenance:
  176.     >>>>    Built in project backup and restore.
  177.     >>>>    User menus defined in the makefile can set compiler, etc., options.
  178.     >>>>    Can include 'global' makefiles as headers.
  179.     >>>>    Can stop on error.
  180.     >>>>    Allows review of error messages.
  181.     >>>>    Force make according to compiler or linker options or make all.
  182.     >>>>    Can make .exe, .hlp, .dll, etc... all in one build.
  183.     >>>>    Background build with 'pop up on error' mode.
  184.     >>>>    Will work in multiple directories.
  185.     >>>>    Fast.
  186.     >>>>    Applicable to any third party compilers, linkers, or other tools.
  187.  
  188. Trademarks:-
  189.  
  190. * PM, EAUTIL, OS/2, and IBM CSet++ (c)IBM
  191. * Registered trademarks of International Business Machines Corporation.
  192.