home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 1 / 1456 / simped.doc < prev    next >
Encoding:
Text File  |  1990-12-28  |  7.2 KB  |  263 lines
  1.  
  2.  
  3.  
  4.      simped()                         Unix                       simped()
  5.  
  6.  
  7.  
  8.      Name
  9.           simped - a simple, bbs style editor.
  10.  
  11.  
  12.      Syntax
  13.           simped [filename]
  14.           (Note: only one file may be specified at a time)
  15.  
  16.      Description
  17.           simped is a simple line oriented editor for use by people
  18.           who don't want to spend time learning a more flexible
  19.           editor like ed, ex or vi. It was designed with the intent
  20.           that useful work could be done immediately and without
  21.           reading this manual page or any of the online help.
  22.  
  23.           In keeping it simple much flexibility is lost. In an effort
  24.           to recover some of this and allow simped to act as a bridge
  25.           to more flexible editors, some commands may be wholly or 
  26.           partially entered on a single line instead of a separate
  27.           line for each portion of a command.
  28.  
  29.           For example: those commands that require line numbers may
  30.           be entered one of two ways:
  31.  
  32.           Command? d <RETURN>            (delete a line)
  33.           Line number: 1 <RETURN>
  34.           -or-
  35.           Command? d1 <RETURN>
  36.  
  37.           Also an extra editing command (Modify) has been added which
  38.           (once learned) makes editing much easier. Though there is
  39.           no complement to this command in any Unix editor, it does
  40.           regain some editing flexibility.
  41.  
  42.      Program entry
  43.           If no file is named on the command line, or the file is a
  44.           new file, an introductory message is printed and the user
  45.           is placed directly into input mode with the prompt:
  46.  
  47.             1> _
  48.  
  49.           If the file exists, the last half page of text is listed
  50.           and the:
  51.  
  52.           Options: S)ave and quit, A)bort/cancel, L)ist text, E)dit line,
  53.                    I)nsert line, D)elete line, C)ontinue, M)odify, H)elp
  54.  
  55.           Command? _
  56.  
  57.           prompt is displayed.
  58.  
  59.           The number of lines listed is set at compile time by the
  60.           #define'd value PAUSE.
  61.  
  62.  
  63.  
  64.      simped   64                      Page 1                       simped
  65.  
  66.  
  67.  
  68.      simped()                         Unix                       simped()
  69.  
  70.  
  71.      Input mode
  72.           While in input mode characters typed in are placed in a
  73.           buffer. If the text being typed in spills over the end of
  74.           the line, it is automatically moved to the next line and 
  75.           typing continues uninterrupted.
  76.  
  77.           Entering a <RETURN> on a line by itself will exit input
  78.           mode and display the command prompt.
  79.  
  80.           If you want a blank line, enter a space and <RETURN>.
  81.  
  82.           The length of the lines is set at compile time by the
  83.           #define'd value LINELEN.
  84.  
  85.      Command options:
  86.  
  87.           * S)ave and quit 
  88.  
  89.             Saves the file and quits the editor.
  90.             No options.
  91.  
  92.           * A)bort/cancel
  93.  
  94.             Verifies that no save is to be done and then abandons any
  95.             editing that was done.
  96.             No options.
  97.  
  98.           * List text
  99.  
  100.             Lists the text entered, pausing every half page or so. The
  101.             number of lines listed is set at compile time.
  102.  
  103.             Options: A starting line number may be entered. A return
  104.                      will start listing at line 1.
  105.  
  106.           * Edit line
  107.  
  108.             Substitute old text for new text on a line. 
  109.  
  110.             Example 1:
  111.  
  112.             Command? e <RETURN>
  113.             Line number: 1 <RETURN>
  114.  
  115.               1> A line of text
  116.  
  117.             Old text: f t <RETURN>
  118.             New text: f modified t <RETURN>
  119.  
  120.               1> A line of modified text
  121.  
  122.             (returns to the command prompt)
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.      simped   130                     Page 2                       simped
  131.  
  132.  
  133.  
  134.      simped()                         Unix                       simped()
  135.  
  136.  
  137.             Example 2:
  138.  
  139.             Command? e1/f t/f modified t/
  140.  
  141.               1> A line of modified text
  142.  
  143.             (returns to the command prompt)
  144.  
  145.             To insert characters at the beginning of a line, enter
  146.             nothing for the "Old text:" and the characters to be
  147.             inserted for the "New text:".
  148.  
  149.             To delete characters, enter them in the "Old text:" and
  150.             nothing in the new text.
  151.  
  152.             Entering nothing in both "Old text:" and "New text:" will
  153.             result in no change.
  154.           
  155.           * Insert line
  156.  
  157.             Insert lines of text BEFORE the line number specified. The
  158.             user is dropped into 'insert mode'.
  159.  
  160.             Option: The line number you want the inserted text to
  161.                     appear BEFORE.
  162.  
  163.           * Delete line
  164.            
  165.             Delete a line. The line will be printed and you must enter
  166.             a 'y' for the line to be deleted.
  167.  
  168.             Option: The line number you want deleted.
  169.  
  170.           * Continue
  171.  
  172.             Continue entry. Drops the user into input mode AFTER the
  173.             last line in the file.
  174.  
  175.             No options.
  176.  
  177.           * Help
  178.  
  179.             An online source of information about commands.
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.      simped   196                     Page 3                       simped
  197.  
  198.  
  199.  
  200.           * Modify
  201.  
  202.             This is a multi-use editing function added in a effort
  203.             to regain some of the flexibility lost in making this
  204.             editor simple.
  205.             
  206.             Option: The line number you want to modify.
  207.  
  208.             This command can:
  209.  
  210.               - replace text
  211.               - put blanks in place of characters
  212.               - delete text
  213.               - insert text
  214.  
  215.             The line is printed and and the cursor is placed under the
  216.             first character on the next line. Changes are made by placing
  217.             one or more of the available options below the portion of
  218.             the line.
  219.  
  220.             OPTION              EXPLANATION
  221.             ------              -----------
  222.             ^text#              Inserts the characters between the '^'
  223.                                 and the '#' BEFORE the character
  224.                                 pointed to by the '^'. Inside the '^'
  225.                                 and the '#', both the '&' and the '^'
  226.                                 are treated as regular characters.
  227.  
  228.           ^#                Inserts a # before the ^ (special case)
  229.  
  230.                #                (When not the first character after a
  231.                                 '^') causes the character above it to
  232.                                 be deleted and the space closed.
  233.  
  234.                &                Replaces the character above it with a
  235.                                 blank space.
  236.  
  237.             (space)             No effect.
  238.  
  239.             ANY OTHER CHARACTER WILL REPLACE THE CHARACTER ABOVE IT!
  240.             ========================================================
  241.  
  242.             Example:
  243.  
  244.             Command? m1 <RETURN>
  245.  
  246.                1> Thos sentence isstoobbe mortifd
  247.             edit>   i  ^is the ####  #&     d   ^ie#
  248.  
  249.                1> This is the sentence to be modified
  250.  
  251.             Command? _
  252.  
  253.  
  254.  
  255.  
  256.  *
  257.  * Copyright (C) 1990 Jay Konigsberg - see Makefile for details
  258.  * This is Free Software, distrubited under the GNU Software Aggrement.
  259.  *
  260.  
  261.  
  262.      simped   262                     Page 4                       simped
  263.