!  CMEDIT BASIC HELP FILE
! 
!comments:
!     The above files are contributed by The Boeing Company to DECUS
!     Modifications will be made on a continuing basis. If the programs
!     are of use to DECUS, revised copies well be made available.
!     Note :  CMEDIT is very easy to use and is used by about 60% of
!     our users as the standard editor. It is weak in character mode
!     editing compared to SOS but is quite fast and has excellent
!     line mode commands. Some macro capability is present as well
!     as block maipulation commands (put a block on a file,get a block or
!     file, remove a block, duplicate a block, move a block).
! 
!     The programs are authored by or revised by Byron Bassett
!     Boeing Computer Services.
!          Phone 206-773-5028
!          Address:
!           Byron Bassett
!           MS  8E-10
!           PO Box 24346
!           Seattle, Washington 98124
  A VAX native mode editor modelled after the BCS editor
  The general form of most commands is as follows
    Prefix Command Delimiter Arguments
      prefix is "." "-" or both (default no prefix)
      "." reverses verify temporarily
      "-" reveses the search direction for After,Before,Change,Find,Locate
      	Turns off tabbing for Tabchar,Tabdef & Disables line-mode for LInem
      Command is any of the commands below
      	Commands may be upper or lower case and partially
      	defined (the command precedence below is the search order)
      delimiter usually a blank but may be any non-alpha character
      Arguments are particular to each subcommand
  After,Before,Change,Find,Locate,Overlay,Tabchar,Tabdef,Tabset,X & Y
    are commands that have memory
  Dup,Extract,Getfile,Move,Putfile & Remove are block commands
    delimited by Start & End commands
  CMEDIT can edit up to 64,000 lines BIGCM up to 350,000 lines
*After
  Insert string2 after string1
 
  After /string1/string2/ nline noccur
 
  Insert string1 after the noccur occurance of string1 in each of the
  next nline lines. If noccur is G, g or * then string2 will be inserted
  after all occurances of string1. If nline is an * then all of the lines
  remaining in the file will be scanned for string1. If nlinie is a G or g
  then string2 will be inserted after string1 for all occurences to the
  end of the file.
 
  Defaults: nline = 1, noccur = 1
  Prefix: . changes printout, - searches up the file.
  The area of search can be modified by Zone.
  Note: string may be composed of standard characters and or hex and or
  octal representation of characters via the %'hex string'% or
  %"octal string"% format for a string.
  E.G.    /abcdef%'0D'%/   would be the string abcdef<CR>
*Alter
  Enter the alter mode for the next nline lines
 
  Alter nline
 
  Alter enters the alter mode for column editing. The alter mode is exited
  via a null entry(cr with no input).
 
  Commands:
     blank     leave the above column alone
       @       delete the above column
       #       force the above column to a blank
       %       string insert flag
               %delim string delim     inserts string before the % column
               %blank or no paired delimiters inserts a blank before the % colum
      any other   replace the above column with this character
 
  Default: nline = 1
*Before
  Insert string2 before string1
 
  Before /string1/string2/ nline noccur
 
  Insert string1 before the noccur occurance of string1 in each of the
  next nline lines. If noccur is G, g or * then string2 will be inserted
  before all occurances of string1. If nline is an * then all of the lines
  remaining in the file will be scanned for string1. If nlinie is a G or g
  then string2 will be inserted before string1 for all occurences to the
  end of the file.
 
  Defaults: nline = 1, noccur = 1
  Prefix: . changes printout, - searches up the file.
  The area of search can be modified by Zone.
  Note: string may be composed of standard characters and or hex and or
  octal representation of characters via the %'hex string'% or
  %"octal string"% format for a string.
  E.G.    /abcdef%'0D'%/   would be the string abcdef<CR>
*Bottom
  Goes to the bottom of the file
 
  Bottom
*Change
  Change string1 to string2
 
  Change /string1/string2/ nline noccur
 
Change the noccur occurance of string1 to string2 in each of the
  next nline lines. If noccur is G, g or * then string2 will replace
  all occurances of string1. If nline is an * then all of the lines
  remaining in the file will be scanned for string1. If nline is a G or g
  then string2 will replace string1 for all occurences to the
  end of the file.
 
  Defaults: nline = 1, noccur = 1
  Prefix: . changes printout, - searches up the file.
  The area of search can be modified by Zone.
  Note: string may be composed of standard characters and or hex and or
  octal representation of characters via the %'hex string'% or
  %"octal string"% format for a string.
  E.G.    /abcdef%'0D'%/   would be the string abcdef<CR>
*Call
  Call a file of edit commands for execution
 
  Call filename
 
  Call opens the file filename for input and reads all inputs
  from this file until an end of file is detected. At that time
  normal input reverts to the the logical file SYS$INPUT.
*Down
  Moves the pointer down nlines
 
  Down nlines
 
  Default: nlines = 1
*Delete
  Delete nlines from the file
 
  Delete nlines
 
  Default: nlines = 1
*Dup
  Insert a block of lines defined by start and end after the current line
 
  Dup
*End
  Mark the current line as the end of a block
 
  End
*Extract
  Build a new file from a block of code
 
  Extract filename (block defined by Start & End)
  Extract filename startline endline
*Find
  Find a line which matches a string
 
  Find blank line-image
 
  Starting with the next line the file is searched until a match is found
  for line-image. Note blanks are ignored and line-image is affected by
  tabbing
 
  Default: the previous find line-image
  Prefix: . changes printout, - searches up the file
  Affecting commands: Tabchar Tabdef Tabset
*File
  Saves the current file and exits cmedit
 
  File filename (default current filename)
*Filename
  Changes current file name or tells what current file name is
 
  Filename
  Filename newfile
*Fname
  Changes current file name or tells what current file name is
 
  Fname
  Fname newfile
*Goto
  Moves current line pointer to line-no and displays the line with line-no
 
  Goto line-no
 
  Default: line-no = current line
*Getfile
  Inserts a block of code from filename after current line
 
  Getfile filename startline endline
 
  Default: startline = 1, endline last line of file
*Getline
  Moves current line pointer to line-no and displays the line with line-no
 
  Getline line-no
 
  Default: line-no = current line
*Help
  Informs user about cmedit while in cmedit
 
  Help    (general message)
  Help command
*Input
  Inputs a line after the current line or enters input mode
 
  Input
  Input line-image
*Insert
  Inputs a line after the current line or enters input mode
 
  Insert
  Insert line-image
*Locate
  Locates string1 in the next nlines for occur# occurances
 
  Locate /string1/ nlines occur#
  Locate a string in nlines for occur# occurances. The /
  is any character other than blank. Nlines (default *) is lines to search
  if an * will cause a search for the rest of the file (a G or g is the same).
  Occur# (default 1) if an * G or g will force all occurances in nlines
  to be located.
 
  Prefix: . reverses printout, - causes an upward search
  Defaults: nlines all lines, occur# = 1
            The command has memory i.e. L means previous locate
  Affecting commands: Verify Zone
  Note: string may be composed of standard characters and or hex and or
  octal representation of characters via the %'hex string'% or
  %"octal string"% format for a string.
  E.G.    /abcdef%'0D'%/   would be the string abcdef<CR>
*Linem
  Sets linemode on and off
 
  Linem
  -Linem
  Linem sets linemode (default) ,  -Linem sets linemode off (like EKS CMEDIT)
*List
  List nlines at the terminal
 
  List nlines
*Move
  Moves a block of lines defined by start & end after current line
 
  Move
*Next
  Moves the pointer down nlines
 
  Next nlines
 
  Default: nlines = 1
*Overlay
  Overlay overlays the current line with line-image or previous line
 
  Overlay
  Overlay line-image
 
  Affecting commands: Tabchar Tabdef Tabset
*Print
  List nlines at the terminal
 
  Print nlines
*Putfile
  Build a new file from a block of code
 
  Putfile filename
  Putfile filename startline endline
*Pzone
  Sets a zone for printing output (Type Print etc.)
 
  Pzone start-col end-col
 
  Default: start-col = 1, end-col = max record size
*Quit
  Exit cmedit and DO NOT save anything
 
  Quit
*Replace
  Replace the current line with line-image or with input (default)
 
  Replace
  Replace line-image
  Affecting commands: Tabchar Tabdef Tabset
*Remove
  Remove a block of code defined by start & end
 
  Remove
*Start
  Identify the start of a block at the current line
 
  Start
*Save
  Saves the current file in filename or current file name(default)
 
  Save
  Save filename
*Top
  Places the current line pointer before the first line
 
  Top
*Tabchar
  Identifies tab character & changes tabbing mode
 
  Tabchar
  Tabchar character
 
  Default: print tab character (last set)
           turn tabbing on
  Prefix: - disables tabbing (tabbing disabled initially)
          no prefix enables tabbing
  Affecting commands: Tabdef Tabset
*Tabdef
  Identifies tab character & changes tabbing mode
 
  Tabdef
  Tabdef character
 
  Default: print tab character (last set)
           turn tabbing on
  Prefix: - disables tabbing (tabbing disabled initially)
          no prefix enables tabbing
  Affecting commands: Tabchar Tabset
*Tabset
  Lists current tab positions or inputs new positions (100 max)
 
  Tabset
  Tabset t1,t2,t3,t4 ... t100
*Type
  List nlines at the terminal
 
  Type nlines
*Up
  Moves current position up nlines
 
  Up nlines
 
  Default: nlines = 1
*Verify
  Sets printing mode off or on  (default set off) (initial is on)
 
  Verify
  Verify on
*X
  X is a macro command with memory
 
  X;command;command;command
  X ntimes
 
  Format:
     ; any delimiter if initially a blank then delimiter is a "\"
       this character separates commands
     command any valid cmedit command except X or Y
       any number of commands may be present (up to 255 characters worth
     ntimes (default 1) Executes the X command ntimes
*Y
  Y is a macro command with memory
 
  Y;command;command;command
  Y ntimes
 
  Format:
     ; any delimiter if initially a blank then delimiter is a "\"
       this character separates commands
     command any valid cmedit command except X or Y
       any number of commands may be present (up to 255 characters worth
     ntimes (default 1) Executes the Y command ntimes
*Zone
  Sets the width of the search and modification zone for After, Before,
  Change and Locate
 
  Zone start end
 
  Default: start 1, end record size
