home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / wp / pct2_2.zip / PCTDOC1.EXE / lha / CHAP6.TXT < prev    next >
Text File  |  1989-04-21  |  26KB  |  561 lines

  1.        subject: COMMAND LINE OVERVIEW
  2.  
  3.        Esc key: When you are in normal editing mode, the Esc key moves
  4.                 the cursor between the text area and the Command Line.
  5.  
  6.            use: There are numerous commands which may be issued from
  7.                 the Command Line such as EDIT, GET, CALC, search, find
  8.                 and replace, etc.  These commands are initiated by
  9.                 moving the cursor to the Command Line, typing the
  10.                 command, and then pressing Enter or F10.  The Command
  11.                 Line will scroll to the left and right if necessary.
  12.  
  13.        editing: The Ins key places the Command Line in insert mode
  14.                 which is independent of the insert/overwrite mode of
  15.                 the text area.  (The standard mode for the Command
  16.                 Line is overwrite, and it will always be in overwrite
  17.                 upon entry or after executing a command).
  18.  
  19.                 Tab and Shift Tab move 5 spaces to the right or left.
  20.  
  21.                 Ctrl Right Arrow and Ctrl Left Arrow move the cursor
  22.                 to the next "word" to the right or left on the Command
  23.                 Line.
  24.  
  25.                 Home moves the cursor to the beginning of the line.
  26.  
  27.                 End moves the cursor one space beyond the last
  28.                 character on the line.
  29.  
  30.                 Del deletes the character under the cursor.
  31.  
  32.                 Backspace moves to the left and deletes that
  33.                 character.
  34.  
  35.                 F6 erases all characters under, and to the right of
  36.                 the cursor.
  37.  
  38.        F10 key: The commands can also be initiated by pressing F10
  39.                 instead of Enter.  F10 will start a command on the
  40.                 Command Line even if the cursor is in the text area.
  41.                 This is a powerful feature, especially for use with
  42.                 keystroke macros.  If the cursor is on the Command
  43.                 Line when you press F10, the cursor will first move to
  44.                 the text area before executing the command.
  45.  
  46.         buffer: When you type a new command on the Command Line, it is
  47.                 saved in a buffer for later use.  Up to 10 commands
  48.                 are saved in this buffer.
  49.  
  50.                 The last command issued is always visible on the
  51.                 Command Line.  To recall a previous command, press
  52.                 Ctrl W when the cursor is on the Command Line.
  53.                 Repeated Ctrl Ws will cycle through all the commands
  54.                 in the buffer.  You can modify any command as desired
  55.                 and press Enter or F10 to execute the command.
  56.                                   71
  57.  
  58.     keystrokes: Most keystrokes which operate in the text area will
  59.                 also function from the Command Line.  For example,
  60.                 Ctrl PgUp which moves the cursor to the top left of
  61.                 the file you are editing will also perform this
  62.                 function from the Command Line.  The only difference
  63.                 is that the cursor will remain in the Command Line.
  64.  
  65.                 Exceptions to this rule are:
  66.  
  67.                 (1) Those keystrokes mentioned under "editing" above
  68.                     are reserved for Command Line functioning.
  69.  
  70.                 (2) Ctrl W, and Enter behave differently as described
  71.                     above.
  72.  
  73.                 (3) Ctrl J (join), and F5 (delete current line) do
  74.                     not function from the Command Line.
  75.  
  76.                 (4) The following keystrokes work just as they would
  77.                     if you were in the text area, but they will cause
  78.                     the cursor to leave the Command Line and return to
  79.                     the text area just as if you had pressed Esc
  80.                     first:
  81.                              Up Arrow - moves to bottom text line in
  82.                                         active window.
  83.                            Down Arrow - moves to next text line below
  84.                                         bottom text line in active
  85.                                         window if it can.
  86.                             Ctrl Home - moves to upper left corner of
  87.                                         active window.
  88.                              Ctrl End - moves to lower left corner of
  89.                                         active window.
  90.                                    F8 - initiates highlight options
  91.                                         menu.
  92.                                   F10 - initiates command.
  93.                                Ctrl O - checks spelling of word under
  94.                                         cursor in TEXT AREA.
  95.                                Ctrl V - highlights word under cursor
  96.                                         in text area.
  97.                                Ctrl Z - initiates Fault Finder.
  98.  
  99.       commands: The remainder of this section will describe each
  100.                 command which can be issued from the Command Line.
  101.  
  102.        command: SEARCH (FIND)
  103.  
  104.        purpose: Locate a group of characters in the text being edited
  105.                 and move the cursor to that location.
  106.  
  107.          setup: Move cursor to Command Line.
  108.  
  109.         format: {-}/string{/ {b {n}}}
  110.                 {-}\string{\ {b {n}}}
  111.  
  112.                                   72
  113.     discussion: Without optional initial '-' character, the text will
  114.                 be searched beginning one character beyond the current
  115.                 cursor position toward the end of the file to find a
  116.                 group of characters which matches "string".
  117.  
  118.                 With optional initial '-' character, the text will be
  119.                 searched beginning one character before the current
  120.                 cursor position toward the beginning of the file to
  121.                 find a group of characters which matches "string".
  122.  
  123.                 '/' implies that the search is case insensitive, i.e.,
  124.                 if "string" is "abc", then "abc", "AbC", "ABC", etc.
  125.                 will all be considered as valid matches.
  126.  
  127.                 '\' implies that the search is case sensitive, i.e.,
  128.                 if "string" is "abc", then only "abc" can be considered
  129.                 as a valid match.
  130.  
  131.                 The optional trailing '/' or '\' allows blank characters
  132.                 to be included at the end of the string to be matched
  133.                 and permits the {b {n}} options to be used.
  134.  
  135.                 The optional {b {n}}, implies the search process
  136.                 should only conducted on each line beginning at column
  137.                 b, for a maximum of n columns.  If b is present but
  138.                 not n, then the search will be conducted from column b
  139.                 to the end of each line.
  140.  
  141.                 NOTE: when n is used, the entire string must exist
  142.                       within the n columns specified or no match will
  143.                       be registered.  Thus n must have a value of at
  144.                       least "string" characters.
  145.  
  146.     example(s): -\Find this
  147.                 The text is searched from one character before the
  148.                 current cursor location toward the beginning of the
  149.                 file to find an exact match for the characters
  150.                 "Find this". (Quote marks not included.)
  151.  
  152.                 /Find this / 15 25
  153.                 The text is searched starting at one character after
  154.                 the cursor location toward the end of the file to find
  155.                 the sequence of characters "Find this " regardless of
  156.                 case.  (Quote marks not included.)  The search is only
  157.                 made from columns 15 through 39 of each line.
  158.  
  159.        command: FIND and REPLACE
  160.  
  161.        purpose: Locate a group of characters in the text and
  162.                 optionally replace them with a second group of
  163.                 characters.
  164.  
  165.          setup: Move cursor to Command Line.
  166.  
  167.         format: {-}/string1/string2/ {b {n}}
  168.                                   73
  169.                 {-}\string1\string2\ {b {n}}
  170.  
  171.     discussion: Without optional initial '-' character, the text will
  172.                 be searched beginning one character beyond the current
  173.                 cursor position toward the end of the file to find a
  174.                 group of characters which matches "string1".
  175.  
  176.                 With optional initial '-' character, the text will be
  177.                 searched beginning one character before the current
  178.                 cursor position toward the beginning of the file to
  179.                 find a group of characters which matches "string1".
  180.  
  181.                 '/' implies that the search is case insensitive.
  182.                 '\' implies that the search is case sensitive.
  183.  
  184.                 "string2" is the replacement string.
  185.  
  186.                 The optional {b {n}}, implies the search process
  187.                 should only conducted on each line beginning at column
  188.                 b, for a maximum of n columns.  If b is present but
  189.                 not n, then the search will be conducted from column b
  190.                 to the end of each line.
  191.  
  192.                 NOTE: when n is used, the entire string must exist
  193.                       within the n columns specified or no match will
  194.                       be registered.  Thus n must have a value of at
  195.                       least string1 characters.
  196.  
  197.        process: When a match is found for string1, the string will be
  198.                 highlighted and the following question will be asked:
  199.  
  200.                 Answer by pressing Y, N or X.  Y and X will cause
  201.                 "string2" to replace "string1".  Next you will be
  202.                 asked:
  203.  
  204.                 Find Next? (Y/N) (or X=Yes and don't ask)
  205.  
  206.                 Y and X will cause the Find and Replace operation to
  207.                 continue, whereas N will cause it to stop.  (If you
  208.                 press Esc in response to either of these questions,
  209.                 the process will also stop).
  210.  
  211.                 Answering X to the first question causes Find and
  212.                 Replace to replace each match as it is found.
  213.  
  214.                 Answering X to the second question causes the Find and
  215.                 Replace to search for the next match without waiting.
  216.  
  217.                 Two X responses is called a GLOBAL find and replace.
  218.                 All occurrences of "string1" from the current cursor
  219.                 position to the end of the file will be automatically
  220.                 replaced by "string2".
  221.  
  222.                 Answering X to the second question only allows you to
  223.                 step through each match in the file and visually
  224.                                   74
  225.                 inspect it before making the decision to replace it or
  226.                 not.
  227.  
  228.                 Answering X to the first question only will
  229.                 automatically replace the next match found, but allows
  230.                 you to terminate the process after any replacement has
  231.                 been made.
  232.  
  233.        example: -\But,\However,\ 5 20
  234.  
  235.                 Find the string "But," from one character to the
  236.                 left of the current cursor position toward the
  237.                 beginning of the file (if it occurs within the column
  238.                 range 5 to 24) and replace it with the string
  239.                 "However," on request.
  240.  
  241.        command: CALCULATE
  242.  
  243.        purpose: Find the result of a simple equation and save the
  244.                 result in a buffer so it can be inserted into the text
  245.                 area if needed.
  246.  
  247.          setup: Move cursor to Command Line.
  248.  
  249.         format: CALC equation {h}   -or-    CALC equation {d}
  250.  
  251.       equation: The equation may contain the operators:
  252.  
  253.                           +  addition
  254.                           -  subtraction
  255.                      * or x  multiplication
  256.                      / or ÷  division
  257.  
  258.                 Parentheses can be included.  The natural hierarchy of
  259.                 operations is used, i.e., multiplication and division
  260.                 are performed before addition and subtraction.
  261.  
  262.                 Values may be:
  263.                 standard decimal values» -   500    15.3  .5678
  264.                      exponential values» -   1.5E+3 .5E-8
  265.                      hexadecimal values» -   04ABh  0FFh  01234h
  266.  
  267.                 Note that hexadecimal values must begin with a zero
  268.                 and must end with the character h.
  269.  
  270.         result: The result of the equation will be displayed in a
  271.                 window in the center of your screen and the message
  272.                 line will read:
  273.  
  274.                 Move to desired location and press Ctrl_ to insert
  275.                 data
  276.  
  277.                 The result is placed in the "math buffer" and will
  278.                 remain there until another calculation (or a date or
  279.                 time stamp) is performed.  Ctrl _ will cause the
  280.                                   75
  281.                 contents of the buffer to be inserted in the text.
  282.  
  283.                 The number of decimal places displayed in the result
  284.                 is normally 2.  If a value in the equation has more
  285.                 than two decimal places displayed, then that number of
  286.                 digits following the decimal point will be displayed.
  287.  
  288.                     10+2.3333 --> 12.3333
  289.                        10+2.3 --> 12.30
  290.  
  291.                 If the last character in the equation is h, the result
  292.                 will be expressed as a hexadecimal number.
  293.  
  294.       examples: (8+6)x(5-2) --> 42.00        8+6 x 5-2 --> 36.00
  295.                    50/25+10 --> 12.00        50/25+10h --> Ch
  296.                 (50/25+10)h --> Ch        (50/25+010h) --> 18.00
  297.                      (020h) --> 32.00              20h --> 14h
  298.  
  299.        command: DROP TO DOS
  300.  
  301.        purpose: Permits you to execute a DOS instruction or even
  302.                 execute a small program without having to exit
  303.                 PC-Type II.
  304.  
  305.          setup: Move the cursor to the Command Line.
  306.  
  307.         format:    DOS command
  308.                 ALLDOS command
  309.                 where "command" is the DOS command to run, e.g. DIR.
  310.  
  311.     discussion: "Command" is passed to DOS just as if you were
  312.                 actually in the DOS environment at the DOS prompt.
  313.                 The screen will be cleared and the command will be
  314.                 executed.  When the command is finished, the message
  315.                 "Press a key to continue" will be displayed.
  316.  
  317.                 After you press a key your screen will be replaced as
  318.                 it was before issuing the command.
  319.  
  320.                 If you want to drop to DOS and stay there for a series
  321.                 of commands, just place the keyword DOS on the Command
  322.                 Line with no following command.  You will remain in
  323.                 DOS until you type EXIT to return.
  324.  
  325.                 NOTE: If you are going to run another program after
  326.                       dropping to DOS, it is good practice to save
  327.                       your file first.  Otherwise, if the other
  328.                       program behaved poorly and crashed your system,
  329.                       you could lose the file you were editing.
  330.  
  331.                 PC-Type II uses a fair amount of memory, and the more
  332.                 files you have active, or the larger the files are
  333.                 which are active, the less memory is available for
  334.                 going to DOS to execute other commands or programs.
  335.                 If there is insufficient memory available to go to
  336.                                   76
  337.                 DOS, then a message to that effect will be given.
  338.  
  339.         ALLDOS: The ALLDOS command will write the memory being used by
  340.                 PC-Type II to disk before dropping to DOS and executing
  341.                 "command".  When the "command" is finished, the memory
  342.                 saved on disk will be restored before returning to
  343.                 PC-Type II.  This permits you to run large programs
  344.                 without leaving PC-Type II.
  345.  
  346.                 The DOS Command Line instruction is faster but may not
  347.                 be able to work if insufficient memory remains.  The
  348.                 ALLDOS Command Line instruction is slower but permits
  349.                 you to run sizable programs when you drop to DOS.
  350.  
  351.        example: DOS dir a:*.doc
  352.  
  353.                 Drop to DOS and do a directory of all the .DOC files
  354.                 on the current directory of the A disk.
  355.  
  356.        command: EDIT
  357.  
  358.        purpose: To edit another file (or part of a file).
  359.  
  360.          setup: Move the cursor to the Command Line.  Alternatively
  361.                 you may perform the identical function with the
  362.                 "(E)dit/Get" option from the Main Menu (F2).
  363.  
  364.         format: edit filespec {b {n}}  -or-  editp filespec {b {n}}
  365.                  pct filespec {b {n}}  -or-   pctp filespec {b {n}}
  366.  
  367.     discussion: FILESPEC can be any valid file specification and can
  368.                 include drive, path, filename and file extension.  It
  369.                 can also include the standard DOS DIR command wildcard
  370.                 characters "*" and "?".  If it includes the wildcard
  371.                 characters, then all files fitting the description
  372.                 will be presented to you in a menu from which you can
  373.                 choose the specific file you want.
  374.  
  375.                 {b {n}} are optional parameters specifying "begin at"
  376.                 and "for n".  If the EDIT command keyword used was
  377.                 "EDIT", then b and n refer to line numbers.  If the
  378.                 EDIT command keyword used was "EDITP", then b and n
  379.                 refer to page numbers.
  380.  
  381.                 If neither b nor n are used, then the entire file will
  382.                 be loaded.  If only b is used, then the file will be
  383.                 loaded from the beginning point to the end of the
  384.                 file.
  385.  
  386.                 PCT and PCTP are aliases for EDIT and EDITP.  If you
  387.                 are like me, you will get in a habit of typing PCT to
  388.                 edit other files.
  389.  
  390.                 NOTE: If you enter PC-Type II with the simplest entry
  391.                       command, PCT after the DOS prompt, then you will
  392.                                   77
  393.                       be in an empty file called "New File".  Should
  394.                       you EDIT a file in this situation, the name "New
  395.                       File" will be replaced by the name of the file
  396.                       just loaded.
  397.  
  398.       examples: EDIT c:\letters\mom.8
  399.                 The entire file MOM.8 in directory LETTERS of drive C
  400.                 is loaded into PC-Type II.
  401.  
  402.                 PCTP c:\letters\mom.8 3 2
  403.                 Pages 3 and 4 of the same letter are loaded.
  404.  
  405.                 EDIT c:\letters\mom.8 45
  406.                 The same letter is loaded starting at line number 45
  407.                 to the end of the file.
  408.  
  409.        command: GET
  410.  
  411.        purpose: To load all or part of a file on disk into the file
  412.                 currently being edited.
  413.  
  414.          setup: Move the cursor to the Command Line.  Alternatively
  415.                 you may perform the identical function with the
  416.                 "(E)dit/Get" option from the Main Menu (F2).
  417.  
  418.         format: get{p} filespec {b {n}}
  419.  
  420.     discussion: FILESPEC can be any valid file specification and can
  421.                 include drive, path, filename and file extension.  It
  422.                 can also include the standard DOS DIR command wildcard
  423.                 characters "*" and "?".  If it includes the wildcard
  424.                 characters, then all files fitting the description
  425.                 will be presented to you in a menu from which you can
  426.                 choose the specific file you want.
  427.  
  428.                 {b {n}} are optional parameters specifying "begin at"
  429.                 and "for n".  If the GET command keyword used was
  430.                 "GET", then b and n refer to line numbers.  If the GET
  431.                 command keyword used was "GETP", then b and n refer to
  432.                 page numbers.
  433.  
  434.                 If neither b nor n are used, then the entire file will
  435.                 be loaded.  If only b is used, then the file will be
  436.                 loaded from the beginning point to the end of the
  437.                 file.
  438.  
  439.                 When a file is loaded with the GET command, it will be
  440.                 inserted in the current text between the line on which
  441.                 the cursor is located and the following line.
  442.  
  443.                 NOTE: If you enter PC-Type II with the simplest entry
  444.                       command, PCT after the DOS prompt, then you will
  445.                       be in an empty file called "New File".  Should
  446.                       you GET a file in this situation, the name "New
  447.                       File" will be replaced by the name of the file
  448.                                   78
  449.                       just loaded.
  450.  
  451.       examples: GET c:\letters\mom.8
  452.                 The entire file MOM.8 in directory LETTERS of drive C
  453.                 is loaded into the current file on the line following
  454.                 the cursor.
  455.  
  456.                 GETP c:\letters\mom.8 3 2
  457.                 Pages 3 and 4 of the same letter are loaded following
  458.                 the cursor line.
  459.  
  460.                 GET  c:\letters\mom.8 45
  461.                 The same letter is loaded into the current file
  462.                 starting at line number 45 to the end of the file.
  463.  
  464.        command: NAME
  465.  
  466.        purpose: To change the file specification of the current file
  467.                 being edited.
  468.  
  469.          setup: Move cursor to Command Line.
  470.  
  471.         format: NAME filespec
  472.  
  473.     discussion: The filespec provided can include drive, path,
  474.                 filename and file extension.  If only a filename and
  475.                 file extension are provided, then the default
  476.                 directory is assumed.
  477.  
  478.                 After typing NAME followed by the new filespec on the
  479.                 Command Line and pressing Enter, the file
  480.                 specification of the current file being edited will be
  481.                 changed to the new filespec supplied.  The name will
  482.                 change in the highlighted filespec area in the double
  483.                 line at the top of the active window.
  484.  
  485.                 If the screen is split and the same file appears in
  486.                 more than one window, the name will be changed in all
  487.                 places.
  488.  
  489.                 The renamed file will always be referenced by the new
  490.                 name.
  491.  
  492.                 NOTE: Some invalid file specifications will be caught,
  493.                       but the NAME command is very lenient about the
  494.                       file specification you provide.  However, should
  495.                       you try to save the file and the new
  496.                       specification is invalid, then you will be asked
  497.                       to modify it at that time.
  498.  
  499.        example: NAME c:\mydir\newname.pct
  500.  
  501.                 The name of the current file being edited will be
  502.                 changed to NEWNAME.PCT, and if saved, will be saved on
  503.                 drive C in directory MYDIR.
  504.                                   79
  505.  
  506.        command: PRINT
  507.  
  508.        purpose: Initiate printing by going to the Print Window.
  509.  
  510.          setup: Move the cursor to the Command Line.
  511.  
  512.         format: PRINT
  513.  
  514.     discussion: The effect of this command is identical to pressing P
  515.                 from the Main Menu (F2).
  516.  
  517.        command: GOTO and SCROLL
  518.  
  519.        purpose: GOTO moves the cursor to a specified line in the file.
  520.                 SCROLL moves the cursor a specified number of lines
  521.                 toward the top or bottom of the file.
  522.  
  523.          setup: Move the cursor to the Command Line.
  524.  
  525.         format: n                       (This is GOTO)
  526.                 +n                      (This is SCROLL)
  527.                 -n                      (This is SCROLL)
  528.  
  529.     discussion: GOTO
  530.                 Typing a number n on the Command Line and then
  531.                 pressing Enter or F10 will cause the cursor to be
  532.                 moved to the line specified.  If a line number is
  533.                 given which exceeds the length of the file, an error
  534.                 message will be issued.
  535.  
  536.                 This is an especially useful command if you use
  537.                 PC-Type II as an editor for source code, for when you
  538.                 compile, errors are usually given by line number.
  539.                 With this command you can immediately go to the
  540.                 erroneous line.
  541.  
  542.                 SCROLL
  543.                 Typing a number n preceded by a + or - sign causes the
  544.                 cursor to move n lines toward the end or toward the
  545.                 beginning of the current file being edited.
  546.  
  547.                 This is useful if you want to move the screen up or
  548.                 down within the file by a value that differs from
  549.                 the number of lines visible in the window.  It can
  550.                 also be a useful command, (in conjunction with F10),
  551.                 when creating keystroke macros.
  552.  
  553.       examples: 156
  554.                 The cursor will be moved to line 156 of the file.
  555.  
  556.                 -38
  557.                 The cursor will be moved 38 lines toward the beginning
  558.                 of the file.  If the cursor was on line 138, it will
  559.                 be on line 100 after the command is issued.
  560.                                   80
  561.