home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 051.lha / med.doc < prev    next >
Text File  |  1986-11-20  |  8KB  |  265 lines
  1. Article 1975 of 1995, Mon 12:11. 
  2. Subject: Another Text editor-- 
  3. From: rouaix@inria.UUCP (Francois Rouaix) 
  4. Date: 9 Feb 87 20:11:32 GMT 
  5.  
  6. Preliminary: this product is named Med, but it is not related to Matt Dillon's 
  7. editor MED. We are sorry for this confusion, but since this editor has been 
  8. sold in France for six months, it is not possible to rename it for  
  9. international distribution. 
  10.  
  11.  
  12.  
  13.       DOCUMENTATION FOR THE VERSION 2.1 OF TEXT EDITOR MED 
  14.       ====================================================== 
  15.  
  16.  
  17. Med is a text editor that I wrote especially for the Amiga. I wanted to use 
  18. the features of the Amiga to make it as user-friendly as possible. 
  19. So my program works with the mouse and the menus (and many other Intuition 
  20. features). 
  21. You can edit up to 36 texts simultaneously. In this documentation I will try 
  22. to explain some of the special features of Med. 
  23.  
  24. I ask you to be indulgent with my english which is very poor. 
  25.  
  26.  
  27. Use of the Mouse: 
  28. ================= 
  29.  
  30.    Move the cursor. 
  31.    Move the lift. (scroll-bar) 
  32.    Selecting text: 
  33.       Hold down the left button and move the mouse. Release the button 
  34.       at the end of the region you want to select. 
  35.       The selected text is highlighted. 
  36.       You may also use an 'extended-select' mode 
  37.          1. Hold down the left mouse button. 
  38.          2. Press the Escape key. 
  39.          3. Release the left mouse button. 
  40.          4. Use the lift (as many times as you need). 
  41.          5. Click in the window. The visible selected text is highlighted. 
  42.          5. You can return in 2. 
  43.  
  44.       The mouse is also used for all the usual Amiga interface. 
  45.  
  46.  
  47.  
  48. The menus: 
  49. ========== 
  50.  
  51.    There are 28 of them. 
  52.    ONLY THE MENUS WHICH DON'T HAVE AN EVIDENT MEANING ARE 
  53.    DESCRIBED HERE. 
  54.  
  55. Menu File/Quit: 
  56.    Med asks you if you are really sure that you don't want to save the file 
  57.    you have modified. It gives you the name of this file. 
  58.  
  59. Menu Edition/Special/Path: 
  60.    You can give a string which will be put in front of all the filenames. 
  61.    It is very useful when you work on files in a directory which is not 
  62.    the current directory, allowing you not to type the entire path each 
  63.    time you open (or save) a file in this directory. 
  64.  
  65. Menu Edition/Special/Execute: 
  66.    You can execute a CLI command just as you would from the CLI. 
  67.    Med is stopped since this command runs. 
  68.  
  69. Menu Edition/Special/NewCli: 
  70.    You can create a new CLI. 
  71.  
  72. Menu Edition/Special/Script: 
  73.    Use this menu to load several files with an unique command. 
  74.    A requester appears and asks you for a filename. 
  75.    This file will be used as a description file. 
  76.    Each line of this file will be understood by Med as the description of 
  77.    a file to load. 
  78.    The syntax you must use is: 
  79.             filename size comment 
  80.      filename: the file Med should load. If there is a path, it is used. 
  81.      size: the buffer size that Med should allocate . (optionnal) 
  82.      comment: for the user, may be empty. 
  83.  
  84.          Between the fields you must put at least one space. 
  85.          The lines which begin with * are comments. 
  86.  
  87.             example of a script file 
  88. C-DEVEL:one.window.c   20 
  89. C-DEVEL:essai.c        10000 
  90. * this a comment 
  91. C-DEVEL:toto.c         1 
  92. tob.asm                20000 
  93.  
  94.          You can use this feature directly from the command line with the 
  95.          syntax : 
  96.             Med -sfile 
  97.                file must be a script file. 
  98.  
  99. Menu Edition/Special/Save Table 
  100. Menu Edition/Special/Load Table 
  101.  
  102.     These 2 menus deal with the conversion table that Med use when it loads 
  103.     a file. All the character it reads are changed according to this table. 
  104.     Usually a character is changed into itself. 
  105.     The default table is the identity. 
  106.     The menu Load Table can be used to change it. 
  107.     A requester appears asking you for a filename. 
  108.     In this file you must put lines of this type: 
  109.          iv fv comment 
  110.            where 
  111.             iv  :  initial value of the character in hexadecimal 
  112.             fv  :  final value of the character in hexadecimal 
  113.             comment : field reserved to the user. 
  114.  
  115.     These fields must be separed by one (or more) space. 
  116.     If one value iv appears several times the last value is used. 
  117.     If any value doesn't appear Med keeps the default value . 
  118.     The lines which begin with * are comment. 
  119.  
  120.     The menu 'Save Table' may be used to create a file which is the map 
  121.     of the conversion table  and  has the same format. 
  122.  
  123.     This feature is designed to allow you to work on files coming from 
  124.     an another machine or containing special characters. 
  125.  
  126. Example of a table file: 
  127.  
  128. 0 20    0 are changed into space. 
  129. D A     ^M becomes ^J 
  130. * comment 
  131. 41 42   A --> B (!!!). 
  132.  
  133.  
  134. Edition/Special/Without Spaces: 
  135.    This defines a parameter for the way Med writes a file on the disk. 
  136.    When the name of menu is 'Without Space', the spaces Med finds at 
  137.    the end of a line are not written. 
  138.    When the name is 'With Space' they are. 
  139.    The default mode is 'Without Space'. 
  140.  
  141. Window/Open 
  142.    Open a new window. 
  143.    It is possible only if there are more loaded texts than opened windows. 
  144.  
  145.  
  146. Window/Close 
  147.    Close the active window. 
  148.    It won't work if the active window is the only window. 
  149.  
  150. Window/Info 
  151.    Give the number of windows opened by Med. 
  152.  
  153.  
  154. Text/.... 
  155.  
  156.    It shows all the files being currently edited. 
  157.    You may edit up to 36 texts simultaneously. 
  158.    If a file has been modified, its name will appear in a box when selected, 
  159.    else it will be highlighted. 
  160.  
  161.  
  162.  
  163. The soft keys. 
  164. ============= 
  165.  
  166. F1 
  167.    The cursor toggles between beginning and end of line. The cursor will stay 
  168. on the last visible colon if there are characters at his right. This is a sim- 
  169. ple way to tell which line is more than 80 characters long. 
  170.  
  171. F2 
  172.    Creates a new line under the current one. 
  173.  
  174. F3 
  175.    It is a parenthesis and brace verificator. You point the cursor on a 
  176.    parenthesis or a brace, press F3 and the cursor goes to the matching 
  177.    element if it exists. Else, the screen flashes. 
  178.  
  179. F4 
  180. F5 
  181.    Moves the text up and down by a screen unit. 
  182.  
  183.  
  184. F6 
  185.    Repeats commands which are among the menus. Possible commands are Find, 
  186.    Replace,Go to Line,Copy in a File. 
  187.  
  188. F7 
  189.    Gives back the last part of the text which has been deleted by a cut 
  190.    or by F10. 
  191.  
  192. F8 
  193.    Switch upper-case and lower-case letters. 
  194.  
  195. F9 
  196.    Put the cursor on the next tabulation. 
  197.  
  198. F10 
  199.    Delete the line where the cursor is. 
  200.  
  201.  
  202. The control keys: 
  203. ================ 
  204.  
  205.    Some are implemented to help Ed users: 
  206.  
  207.          ^a  == F2 
  208.          ^b  == F10 
  209.          ^f  == F8 
  210.  
  211. Moving in the text: 
  212. ================= 
  213.  
  214.    You may use the cursor keys. 
  215.    Tab indents the line (shifting the text to the right). 
  216.    Shift Tab just moves the cursor to the right. 
  217.  
  218. Some Basics: 
  219. ================= 
  220.  
  221.    When you select text with the mouse, your next action specifies the use 
  222.    of this text. 
  223.    If Med can't have the memory it needs, it shows a requester or it 
  224.    does a screen flash. 
  225.  
  226.    There is no limitation on the length of the lines so you may always 
  227.    put some character in the line BUT a character is inserted exactly 
  228.    where the cursor is. 
  229.  
  230.    Med never accepts non-visible characters. 
  231.  
  232.    The end of line is LineFeed (standard for the Amiga). 
  233.  
  234.    The tabulation characters are always changed in spaces. 
  235.  
  236.    When you load or you save a file, Med doesn't do any back-up. 
  237.    This saves room on disks, while the user generally makes his own back-up 
  238.    on another disk. 
  239.  
  240.  
  241.  
  242. The command line: 
  243. ================= 
  244.  
  245.    med [file [size]] 
  246.       file :file which should  be loaded by med. 
  247.       size :buffer size Med will allocate for the file. 
  248.             You may give it in bytes or in kilo-bytes. 
  249.             Default is 30K. 
  250.  
  251.    med -sfile 
  252.       You use it to load several files with only one command (see the ex- 
  253.       planation above). 
  254.  
  255.  
  256.  
  257. I give my thanks to Francois Rouaix who helped me to write this text in 
  258. english and to test the editor and to Gerald Hewes who always pushes me to 
  259. define more useful commands. 
  260.  
  261.                                  Paris the 01/27/87 
  262.                                           Regis Vaillant. 
  263.  
  264.  
  265.