! 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 *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 *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 *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 *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