home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / vedit40.zip / VEDITHLP.HLP (.txt) < prev   
Borland Turbo Vision Help  |  1994-08-16  |  48KB  |  775 lines

  1.              
  2.              
  3.  V(edit) v4.0.0k 
  4.              
  5.                  
  6.              
  7.  John O'D Rooney 
  8.              
  9.       [Use 'TAB' to move the highlight.]
  10.       Keys              Commands
  11.       Movement
  12. Keys     Editing
  13.       Delete
  14. Keys       Search/Replace
  15.       Text
  16. Formatting   Cut
  17. Paste
  18.       Place
  19. Marking     Text
  20. Marking
  21.              
  22.              
  23.   About V(edit)  
  24.              
  25.                V(edit) v4.0.0k
  26.      (C)opyright John O'D Rooney 1993,94.
  27. V(edit) is a fast, multi-file, programmers editor. It will run in a limited amount of memory without penalty, each file using only the amount of memory that it needs, and in no case using more than 64K. If the file is bigger than 64K, V(edit) automatically switches to a virtual
  28. memory
  29. mode to handle the file. The maximum single file size that can be edited is 2MB, and the program can handle multiple files of that size without slowing down. #
  30. V(edit) uses windows to display the files in the edit buffers. There can be multiple windows open at the same time. A Setup Options command allows the user to select from various colour or black/white combinations. The windows can be overlapped, shrunk, zoomed, cascaded or tiled. Text can be cut or copied from a window to another window. A 'Read
  31. Only' file can be opened for viewing only. A complete Help system is provided, with help on all menu items via the F1 key, and an extensive Search facility covering all keys, commands and features. 
  32. A WorkSpace Save/Restore facility is included, allowing the user to save and restore complete workspaces in named files. A prompted Clear WorkSpace command is included to close down all files in the editor. 
  33. Each file that is being edited has its own mode, bookmarkers and anchors. In fact, you can consider that each file being edited is completely stand-alone, with the only link to other files being via the clipboard system. w
  34. Full mouse support is provided. This support includes the selection, sizing and moving of windows, cursor placement and text selection, and complete menu and dialog box support. The mouse is active within the Help Display, and topics can be selected with a single click or activated with a double click. Vertical and Horizontal scroll bars are provided in the Help display. 
  35. Enhancements include automatic brace placement and indenting for C source and header files (.c, .h, .cxx, .hxx, .cpp and .hpp), complete literal string editing and full forward and reverse brace-matching on all types of braces. The search function has been enhanced to cope with otherwise illegal characters, and a 'grep' style Regular Expression search has been included. Auto switching for soft tabs is provided, *.doc and *.txt files use hard tabs, all other files use soft tabs. A DeTab function is provided. 
  36. A wordwrap mode is available and a 'wrap paragraph' function is also included. The word wrap right margin can be set via the Setup/Margin menu item. Paragraph wrapping (re-formatting) is aware of the Indent mode as well as the wordwrap margin, and will strip out all extra spaces. D
  37. Both keystroke macros and keystroke repeat commands are supported. 
  38.  INDEX
  39.  ALT KEYS:       FUNCTION
  40.  alt A           Anchor down
  41.  alt B
  42.  alt C           Capitalise letter
  43.  alt D           Desktop menu
  44.  alt E           Edit menu
  45.  alt F           File menu
  46.  alt G           Goto line
  47.  alt H           Hide mark
  48.  alt I           Toggle autoIndent mode
  49.  alt J
  50.  alt K           Kill trailing spaces
  51.  alt L           Lowercase word
  52.  alt M           Set Mark
  53.  alt N
  54.  alt O           Toggle Overwrite mode
  55.  alt P           Pull character down
  56.  alt Q
  57.  alt R
  58.  alt S           Setup menu
  59.  alt T
  60.  alt U           Uppercase word
  61.  alt V           View 25/43 lines
  62.  alt W           Toggle Wrap mode
  63.  alt X           EXit
  64.  alt Y           Delete to end of line
  65.  alt Z           Swap user anchor/cursor
  66.  CONTROL KEYS
  67.  ^A              To first char on line
  68.  ^C              Center cursor line
  69.  ^F              metakey (find)
  70.  ^F+1            Find bookmark 1
  71.  ^F+2            Find bookmark 2
  72.  ^F+[            Find brace
  73.  ^F+]            Find brace
  74.  ^F+up           Find screen top
  75.  ^F+down         Find screen bottom
  76.  ^F spacebar     Find next space right
  77.  ^I              Tab
  78.  ^K              metakey (set)
  79.  ^K+1            Set bookmark 1
  80.  ^K+2            Set bookmark 2
  81.  ^L              Last search/replace
  82.  ^M              Newline
  83.  ^Q              Insert literal char
  84.  ^R              Replace
  85.  ^S              Search
  86.  ^T              Transpose chars
  87.  ^U              Undo
  88.  ^W              Wrap paragraph from cursor
  89.  ^X              Dos Shell
  90.  ^Y              Delete Line
  91.  ^Z              Swap system anchor/cursor
  92.  ^BS             Delete to start of line
  93.  ^Del            Delete to start of next
  94.                  word
  95.  FUNCTION KEYS
  96.  F1              Help
  97.  F2              Save File
  98.  F3              Open File
  99.  Alt F3          Close File
  100.  F4              Search
  101.  Ctrl F4         Search/Replace
  102.  F5              Zoom Window
  103.  Ctrl F5         Size/Move Window
  104.  Sh F5           Tile Window
  105.  Alt F5          Cascade Window
  106.  F6              Next Window
  107.  Sh F6           Previous Window
  108.  F7              Start Macro Recorder
  109.  F8              Stop Macro Recorder
  110.  F9              Replay Macro
  111.  F10             Menu
  112.  OTHER KEYS
  113.  esc             Repeat n times
  114.  home            Beginning of line
  115.  ^home           Scroll up
  116.  end             End of line
  117.  ^end            Scroll down
  118.  PgUp            Up one page
  119.  PgDn            Down one page
  120.  ^PgUp           Top of file
  121.  ^PgDn           End of file
  122.  gray-           Cut
  123.  gray+           Copy
  124.  insert          Paste
  125.  delete          Delete at cursor or
  126.                  delete marked area
  127.  ^delete         Delete to start of next
  128.                  word or
  129.                  delete marked area
  130.  right           Char right
  131.  ^right          Word right
  132.  left            Char left
  133.  ^left           Word left
  134.  BS              Delete char left
  135.  ^BS             Delete to start of line
  136.  INDEX
  137.  SETUP
  138. This menu offers choices for Global settings and window settings. The Global settings include screen colour, soft tabs and file backup. The Global settings can be saved, and will then be active when the editor is started. 
  139.  INDEX
  140.  SAVE OPTIONS
  141. This menu choice saves the Global options to a file 'V(edit).cfg', which is stored in the current directory. This file is read, if it exists, when V(edit) starts up, and the settings from the file are used. If a configuration file does not exist in the current directory, a default configuration is used. 
  142.  INDEX
  143.  DESKTOP MENU
  144. This menu provides menu access to the window selection and movement commands. It also offers choices for saving and restoring named workspaces. 
  145.  INDEX
  146.  EDIT MENU
  147. This menu offers choices for general editing functions including searching and replacing, going to a line number and undo. A Filters sub-menu is also available. 
  148.  INDEX
  149.  MARKING TEXT
  150.  Alt M    Set Mark
  151.  Alt H    Hide Mark
  152. Text can be marked for cutting to the Clipboard and copying to the Clipboard. The start of the region can be marked by Alt M, and the cursor is then moved to the end of the region, in either a forward or backward direction. The marked area is highlighted. The highlight can be removed by Alt H. 
  153.  ShiftKey    Set Mark
  154. The region can also be marked by depressing the Shift key and moving the cursor. If the Shift key is released, further cursor movement will unmark the region. 
  155.  MARKING TEXT WITH THE MOUSE
  156. The mouse can be used to mark text. {
  157. [1] Dragging the mouse with the left button pressed will mark the text from the point where the button was first pressed. R
  158. [2] Placing the cursor on a line and double-clicking will select the whole line. 
  159. [3] Holding down the Shift key while clicking will select all of the text between the original cursor position and the new cursor position. Repeating this action will extend the selection. 
  160. The mouse selection behaves as though the region was selected using the Shift key, ie. any subsequent cursor movement will unmark the text. 
  161.  INDEX
  162.  PLACEMARKING
  163.  BOOKMARKS
  164. There are two methods of placemarking in V(edit). The first is static, and makes use of 'bookmarks'. There are two bookmarks available, and these can be inserted by using Ctrl-K 1, and Ctrl-K 2. They can be inserted anywhere in the text and they remain permanent, until they are used in another place. If the 'save workspace' feature is used, the bookmarks are also saved. The keys for returning to the bookmarked locations are Ctrl-F 1 and Ctrl-F 2. 
  165.  ANCHORS
  166. The second placemarking method is dynamic, and the location is not saved when the workspace is saved. This method uses 'anchors'. There are two anchors available, a 'user' anchor and a 'system' anchor. B
  167. The user anchor is 'dropped' at the location you want to mark by using Alt A. To return to the marked position (the user anchor), use Alt Z. This key moves the cursor to the anchor position, then swaps the anchor to the position where Alt Z was pressed. Continued use of Alt Z swaps the cursor between the two locations. L
  168. The system anchor is dropped automatically in the following circumstances. \
  169. a] To start-of-text (Ctrl-PgUp), sets a system anchor to the place where the jump started. Z
  170. b] To end-of-text (Ctrl-PgDn), sets a system anchor to the place where the jump started. f
  171. c] Search/Replace (F4, Ctrl-F4), sets a system anchor to the place where the current search started. 
  172. To return to the last cursor position after one of the above moves, use the 'swap system anchor/cursor' on Ctrl-Z. The user anchor is undisturbed by the above moves. 
  173.  ABOUT
  174.  INDEX
  175.  CUTTING AND PASTING
  176.  Gray Minus  Cut to clipboard
  177.  Gray Plus   Copy to clipboard
  178.  Insert      Paste from clipboard
  179. V(edit) uses the cursor block keys to implement cutting and pasting. To cut a block of text, first mark it using one of the available methods. Then press the Gray Minus key on the cursor pad. This cuts (deletes) the marked block to the Clipboard. Q
  180. To copy a block of text, mark the block and use the Gray Plus key on the cursor pad. This copies the marked block to the Clipboard, leaving the original text in place and removing the highlighting from the marked block. V(Edit) will correctly handle the cutting and deletion of marked text which has been swapped out to virtual memory.     
  181. Pasting from the Clipboard is done by placing the cursor at the desired insertion point and hitting the Insert key. If the file that gets the data would overflow (eg, a huge clipboard is being pasted into it) then a virtual memory manager is created to handle it. 
  182. Note that using the Delete or Ctrl+Delete key on a marked block does not Cut the block, but Deletes it. It can be recovered immediately by using Ctrl U (Undo), provided that the cursor has not been moved in the meantime, and that the deleted data is resident in memory. 
  183.  INDEX
  184.  DELETING
  185.  Del    Delete char or delete marked area.
  186.  ^Del   Delete to start of next word
  187.         right or delete marked area.
  188.  ^Y     Delete line.
  189.  Alt Y  Delete to end of line.
  190.  BS     Delete char to left.
  191.  ^BS    Delete to start of line.
  192.  Alt K  Delete trailing spaces.
  193.  INDEX
  194.  MOVEMENT KEYS
  195.  Esc             Repeat.
  196.  Home            Beginning of line.
  197.  ^Home           Scroll up.
  198.  End             End of line.
  199.  ^End            Scroll down.
  200.  PgUp            Up one page.
  201.  PgDn            Down one page.
  202.  ^PgUp           Top of file.
  203.  ^PgDn           End of file.
  204.  Right           Char right.
  205.  ^Right          Word right.
  206.  ^F spacebar     Next space right.
  207.  Left            Char left.
  208.  ^Left           Word left.
  209.  Up              Line up.
  210.  ^F Up           Find screen top.
  211.  Down            Line down.
  212.  ^F Down         Find screen end.
  213.  ^A              To first char on the line.
  214.  ^C              Center the cursor line.
  215.  Alt G           Goto Line number.
  216.  Alt Z           To User Anchor.
  217.  ^Z              To System Anchor.
  218.  ^F+1            Find bookmark 1.
  219.  ^F+2            Find bookmark 2.
  220.  INDEX
  221.  EDITING KEYS
  222.  SPECIAL KEYS
  223.  ^C      Centers the cursor line to the
  224.          middle of the screen.
  225.  ^F 1    Find bookmark 1.
  226.  ^F 2    Find bookmark 2.
  227.  ^F [    Find matching brace. Finds the
  228.  ^F ]    matching brace for <> [] () and
  229.          curly braces. Each keyset works in
  230.          both directions.
  231.  ^F spc  Find the first space to
  232.          the right of the next word.
  233.  ^F up   Find top of screen.
  234.  ^F down Find bottom of screen
  235.  ^Q      Quote (insert) literal char.
  236.  ^T      Transpose the character at the
  237.          cursor with the character to
  238.          the left.
  239.  ^W      Wrap paragraph.
  240.  Alt C   Capitalise letter at cursor.
  241.  Alt L   Lowercase word at cursor.
  242.  Alt U   Uppercase word at cursor.
  243.  Alt K   Kills trailing spaces from
  244.          the cursor to the end of file.
  245.          Returns the cursor to its
  246.          starting position.
  247.  Alt P   Pull down the character above
  248.          the cursor.
  249.  Alt O   toggles Overwrite mode.
  250.  Alt I   toggles autoIndent mode.
  251.  Alt W   toggles Wrap mode.
  252.  Esc     Repeat next command n times.
  253.  F7      Start macro recording.
  254.  F8      Stop macro recording.
  255.  F9      Replay recorded macro.
  256.  DELETION KEYS
  257.  Del    Delete char or marked area.
  258.  ^Del   Delete to start of next word
  259.         right or marked area.
  260.  ^Y     Delete line.
  261.  Alt Y  Delete to end of line.
  262.  BS     Delete char to left.
  263.  ^BS    Delete to start of line.
  264.  Alt K  Delete trailing spaces.
  265.  CURSOR BLOCK KEYS
  266.  Home            To beginning of line.
  267.  ^Home           Scroll up.
  268.  End             To end of line.
  269.  ^End            Scroll down.
  270.  PgUp            One page up.
  271.  PgDn            One page down.
  272.  ^PgUp           To top of file.
  273.  ^PgDn           To end of file.
  274.  Gray-           Cut to clipboard.
  275.  Gray+           Copy to clipboard.
  276.  Insert          Paste from clipboard.
  277.  ^Right          Move cursor one word right.
  278.  ^Left           Move cursor one word left.
  279.  INDEX
  280.  File  (Alt-F)
  281. The File menu offers choices for opening files, changing directories, and exiting the program. 1
  282.  Open          Change
  283. Dir    Exit
  284.  Save
  285.  Saveas
  286.  INDEX
  287.  File
  288. Open  (F3)
  289. The Open command displays the Open a File dialog box. In this dialog box you select the text file you want to edit in an edit window. &
  290. The Open
  291. file dialog box contains: 
  292.  an input
  293. box with a history list
  294.  a list
  295. box to browse the directory
  296.  the standard cancel button
  297.  open action button
  298.  an information panel that describes the
  299.    selected file
  300.  INDEX
  301.  File
  302. Change Dir...
  303. Change Dir brings up the change
  304. directory dialog box, in which you can change the current directory. 
  305.  INDEX
  306.  File
  307. DOS Shell
  308. With the Dos Shell command (Ctrl-X), you can leave V(edit) temporarily to perform a Dos command or run another program. 4
  309. To return to V(edit), type Exit at the DOS prompt. 
  310.  INDEX
  311.  File
  312. Exit       (Alt-X)
  313. The Exit command terminates V(edit). You are prompted to save any modified files before exiting. 
  314.  INDEX
  315.  Help on Open a File Dialog Box
  316. The Open a File dialog box contains an input box, a file
  317. list, a file information panel, the standard button cancel, one other action button (open), plus a history list that's attached to the name
  318. inputbox. 
  319.  INDEX
  320.  Name 
  321.                                  
  322. The Name input box is where you enter the name of the file to load, or the file-name mask to use as a filter for the Files list box (for example, *.*). 
  323.  INDEX
  324.  Files 
  325.                                  
  326.   FILENM01.C    
  327.   FILENM09.C    
  328.   FILENM02.C    
  329.   FILENM10.C    
  330.   FILENM03.C    
  331.   FILENM11.C    
  332.   FILENM04.C    
  333.   FILENM12.C    
  334.   FILENM05.C    
  335.   ..            
  336.   FILENM06.C    
  337.   \DEBUGGER     
  338.   FILENM07.C    
  339.   \LIBS         
  340.   FILENM08.C    
  341.   \MANUALS      
  342. The Files list box lists the names of files in the current directory that match the file-name mask in the Name input box, plus the parent directory and all subdirectories. 
  343.  C:\LIB\SOURCE\*.C                        
  344.  HELLO.C         52  Jul 14,1990  12:00pm 
  345. The File information panel shows the path name, file name, date, time, and size of the selected file. =
  346. None of the items on this information panel are selectable. 
  347.  INDEX
  348.  [ Open ] 
  349. The Open button opens a new edit window and places the selected file in that window. If the file is already being edited in another window, then a 'ReadOnly' window is opened. This file can be modified independently but cannot be saved. 
  350.  INDEX
  351.  [ Cancel ] 
  352. If you choose Cancel, nothing changes and no action occurs, and the dialog box is put away. M
  353. (Esc always cancels a dialog box, even if a Cancel button does not appear.) 
  354.  INDEX
  355.  [ Open ] 
  356. In the Open a File dialog box, if you choose the Open button V(edit) opens a new edit
  357. window and places the selected file in that window. 
  358.  INDEX
  359.  Help on the Change Directory dialog box
  360. The Change Directory dialog box consists of an input box, a list box, the standard OK and Help buttons, and two other buttons (Chdir and Revert). |
  361.  Directory Name 
  362.                                      
  363. The Directory Name input box is where you type in the path of the new directory. 
  364.  Directory Tree 
  365.    Drives                            
  366. D:\                            
  367.      
  368. LIB                          
  369.        
  370. MYSOURCE                   
  371. The Directory Tree list box enables you to navigate directories by using the selecting bar and pressing Enter. 
  372. If you're using the keyboard, press Enter to make the selected directory be the current directory, then choose OK or press Esc to exit the dialog box. +
  373.  [Chdir ] 
  374. The Chdir button changes the current directory once you've selected or typed in a directory name. +
  375.  [Revert] 
  376. The Revert button goes back to the previous directory, as long as you haven't yet exited the dialog box. 
  377.  INDEX
  378.  File Window
  379.  A file edit window views the contents of a text file. You can use the
  380. arrow keys to move about in the file. A file is loaded via the file
  381. open menu item. ?
  382. Edit windows can be resized and moved using the Desktop menu. 
  383.  INDEX
  384.  SETUP
  385. SET MARGIN
  386.  WRAPPING AND RE-FORMATTING
  387. The Setup
  388. Set Margin command is used with auto text wrapping and text block re-formatting. 
  389.  AUTO TEXT WRAPPING
  390. V(edit) can handle auto text wrapping when entering text. The lines are correctly terminated, with no trailing space. Wordwrap is toggled by Alt-W, and when enabled, 'Wrap' is displayed beside the line indicator. The right hand margin is set by default to 72 but can be changed from the Setup menu (Set Margin). Entering a new value for the right margin automatically engages the Wrap mode. The maximum line length allowed is 256 characters. 
  391.  TEXT RE-FORMATTING
  392. Text can be re-formatted with the ^W key. The text block is re-wrapped from the start of the cursor line to the next empty line. Lines beginning with a hard tab are not re-formatted, nor are lines which consist only of non-text characters. The code is aware of the 'Indent' setting and will correctly indent re-formatted lines if auto-indent is set. When re-formatting lines which are already indented, the redundant spaces are stripped out. The right hand margin can be set independently for each text block. 
  393.   INDEX
  394.   ABOUT
  395.  DESKTOP FACILITIES
  396. V(edit) provides a full workspace save and restore facility, using named files. This means that you can save multiple workspaces and restore them by name. Three commands on the Desktop menu control the system. 
  397.  DESKTOP
  398. SAVE WORKSPACE
  399. This command displays the 'Save Desktop File' dialog box. In this box you allocate a filename to save the current workspace to. The *.dsk file contains the information required to reconstruct the current desktop. As well as the filenames, the window sizes and positions are saved, the cursor locations are saved and any active bookmarks are saved. Also saved are the wordwrap and auto-indent settings, and the current right margin setting. This command does not clear the desktop. 
  400.  DESKTOP
  401. RESTORE WORKSPACE
  402. This command displays the 'Restore Desktop File' dialog box. The files shown are restricted to desktop files, *.DSK. Selecting one of these files for restoring clears the current desktop, with any necessary prompting, and restores a previously saved position. 
  403.  DESKTOP
  404. CLEAR WORKSPACE
  405. This command clears all the files from the desktop. If any of the files have been modified, you will be asked if you want to save them. 
  406.   INDEX
  407.   ABOUT
  408.  COMMAND           MENU     KEY
  409.            
  410.      
  411.  FILE COMMANDS
  412.  Open                Y      F3
  413.  New                 Y      Alt-F N
  414.  Save                Y      F2
  415.  SaveAs              Y      Alt-F A
  416.  ChangeDirectory     Y      Alt-F C
  417.  Close               Y      Alt-F3
  418.  QUERY COMMANDS
  419.  Search              Y      F4 or Ctrl-S
  420.  Replace             Y      Ctrl-F4 or Ctrl-R
  421.  SearchAgain         Y      Ctrl-L
  422.  GotoLine            Y      Alt-G
  423.  SwapAnchor          N      Alt-Z
  424.  FindMatchingBrace   N      Ctrl-F [ or ]
  425.  FindBookMark1       N      Ctrl-F 1
  426.  FindBookMark2       N      Ctrl-F 2
  427.  FindScreenTop       N      Ctrl-F 
  428.  FindScreenBottom    N      Ctrl-F 
  429.  MOVEMENT COMMANDS
  430.  CharLeft            N      
  431.  CharRight           N      
  432.  WordLeft            N      Shift 
  433.  WordRight           N      Shift 
  434.  NextSpaceRight      N      Ctrl-F spacebar
  435.  LineStart           N      Home
  436.  FirstChar           N      Ctrl-A
  437.  LineEnd             N      End
  438.  LineUp              N      
  439.  LineScrollUp        N      Ctrl-Home
  440.  LineDown            N      
  441.  LineScrollDown      N      Ctrl-End
  442.  LineCenterOfScreen  N      Ctrl-C
  443.  PageUp              N      PgUp
  444.  PageDown            N      PgDn
  445.  TextStart           N      Ctrl-PgUp
  446.  TextEnd             N      Ctrl-PgDn
  447.  NewLine             N      Enter
  448.  BackSpace           N      BS
  449.  DropAnchor          N      Alt-A
  450.  SetBookMark1        N      Ctrl-K 1
  451.  SetBookMark2        N      Ctrl-K 2
  452.  DELETION COMMANDS
  453.  DelChar             N      Delete
  454.  DelCharLeft         N      BS
  455.  DelWordRight        N      Ctrl-Del
  456.  DelToStartofLine    N      Ctrl-BS
  457.  DelToEndOfLine      N      Alt-Y
  458.  DelLine             N      Ctrl-Y
  459.  Clear               N      Ctrl-Delete
  460.  Undo                N      Ctrl-U
  461.  KillTrailingSpaces  N      Alt-K
  462.  DeTabLine           Y      Alt-E L
  463.  DeTabFile           Y      Alt-E E
  464.  MODE COMMANDS
  465.  GlobalOptions       Y      Alt-S O
  466.  OverwriteMode       Y      Alt-O
  467.  IndentMode          N      Alt-I
  468.  WordWrapMode        N      Alt-W
  469.  MarkTextOn          N      Alt-M
  470.  MarkTextOn(Soft)    N      Shift
  471.  MarkTextOff         N      Alt-H
  472.  StartRecordMacro    N      F7
  473.  StopRecordMacro     N      F8
  474.  ReplayMacro         N      F9
  475.  RepeatCommand       N      Esc
  476.  EDITING COMMANDS
  477.  CutMarkedText       Y      Gray -
  478.  CopyMarkedText      Y      Gray +
  479.  InsertClipboard     Y      Ins
  480.  Undo                Y      Ctrl-U
  481.  CopyCharDown        N      Alt-P
  482.  TransposeChars      N      Ctrl-T
  483.  Literal             N      Ctrl-Q
  484.  UppercaseWord       N      Alt-U
  485.  LowercaseWord       N      Alt-L
  486.  UppercaseChar       N      Alt-C
  487.  WrapParagraph       N      Ctrl-W
  488.  MISC COMMANDS
  489.  SaveOptions         Y      Alt-S S
  490.  DosShell            Y      Ctrl-X
  491.  ExitEditor          Y      Alt-X
  492.  DISPLAY COMMANDS
  493.  VideoMode           Y      Alt-V
  494.  SaveWorkSpace       Y      Alt-D D
  495.  RestoreWorkSpace    Y      Alt-D R
  496.  ClearWorkSpace      Y      Alt-D C
  497.  Size/Move           Y      Ctrl-F5
  498.  Zoom                Y      F5
  499.  Tile                Y      Shift-F5
  500.  Cascade             Y      Alt-F5
  501.  Next                Y      F6
  502.  Prev                Y      Shift-F6
  503.  Close               Y      Alt-F3
  504.   INDEX
  505.  SETUP OPTIONS
  506. Global options can be set from a dialog box. These options apply to every edit window. The options are: =
  507.         Colour,
  508.         Soft Tab Size,
  509.         File Backup.
  510.  COLOUR
  511. The screen colour can be changed from the Options dialog box. Four choices are presented for selection. They are: 
  512.  Yellow/Blue       Blue/Yellow Screen
  513.  LCD               LCD Screen
  514.  Monochrome        EGA/VGA Screen
  515.  Gray/Blue         Blue/Gray Screen
  516.  SOFT TABS
  517. The soft tabs setting, which is used in all files except *.TXT and *.DOC, can be adjusted here. Any setting from 2 to 20 is acceptable. Soft tabs fill to the next tab stop with spaces, instead of using a hidden control character. 
  518.  FILE BACKUP
  519. The file backup selection is in the form of a check box. When the box is checked, file backup is active, when unchecked, there is no file backup at all. 
  520. Backup files are saved under their original name and extension in a directory named \V(edit)\BACKUP. If this directory does not exist, it is created. N
  521. When the dialog box is closed, the new settings are immediately implemented. 
  522.  INDEX
  523.  SELECTING WINDOWS
  524. A window can be activated in the following ways. 
  525.  USING THE MOUSE
  526. If the window or any part of it is visible, clicking on it with the mouse will activate it and bring it to the top. 
  527.  USING THE KEYBOARD
  528. The Desktop/Next (Alt-DN )and Desktop/Previous (Alt-DP) menu items will cycle through all of the available windows, either forward or backward. These commands are duplicated on F6 (Next) and Shift-F6 (Previous). Any window can be made the active window by selecting its number in conjunction with the Alt key eg. Alt-2 will activate window number two. 
  529.  INDEX
  530.  CASCADING THE WINDOWS
  531. The windows can be cascaded (arranged so that all the windows overlap with the titles visible) by using the menu (Alt-DC) or the keyboard (Alt- F5). Any window can be made the active window by selecting its number in conjunction with the Alt key eg. Alt-2 will activate window number two. Clicking on a window with the mouse will also activate the window. 
  532.  INDEX
  533.  TILING THE WINDOWS
  534. The windows can be tiled (arranged so that all windows are visible) by using the menu (Alt-DT), or the keyboard (Shift-F5). Tiling is horizontal up to a maximum of three open windows. After that, tiling is arranged to maximise the view of the windows. Any window can be made the active window by selecting its number in conjunction with the Alt key eg. Alt-2 will activate window number two. Clicking on a window with the mouse will also activate the window. 
  535.  INDEX
  536.  ZOOMING THE ACTIVE WINDOW
  537. The active window can be zoomed to fill the screen by using the menu (Alt-DZ), the keyboard (F5), or the mouse. To use the mouse, click on the Zoom Arrow icon (on the top line at the right). The Zoom function is a toggle, and repeated selection will alternate the window between full screen and reduced size. The Zoom Arrow icon will alternate from a single arrowhead to a double arrowhead if the window can be reduced using the Zoom feature. 
  538.  INDEX
  539.  SIZE/MOVE THE ACTIVE WINDOW
  540. The active window can be sized and moved in the following ways: 
  541.  USING THE MOUSE
  542.  SIZING THE WINDOW
  543. Place the mouse cursor on the lower right corner of the window and hold down the left mouse button. Drag the corner of the window until the window is at the required size. 
  544.  MOVING THE WINDOW
  545. Place the mouse cursor on the top edge of the window and hold down the left mouse button. Drag the window to the desired location. 
  546.  USING THE KEYBOARD
  547.  SIZING THE WINDOW
  548. Select the Size/Move mode with either Ctrl-F5 or Desktop/Size/Move (Alt-DS). The window border changes from a double line to a single line, indicating that the window is selected for Sizing and Moving. To change the size, use the shift-arrow keys. When the window is at the correct size, press enter. 
  549.  MOVING THE WINDOW
  550. Select the mode as above, and use the arrow keys to move the window around the desktop. 
  551.  INDEX
  552.  VIRTUAL MEMORY
  553. The virtual memory system in V(edit) is intended to work in the background, and during editing there should be no apparent interaction with the screen display. In fact, the intention is that the user should be unaware that he is editing a file or files that are much bigger than Dos memory constraints would allow. 
  554. V(edit) is a multi-file editor. If the user loaded a very large file for editing, and all of the file was brought into memory, then the ability to handle multiple files at the same time would be severely degraded. To overcome this, V(edit) will only allow each file to be allocated a certain amount of memory as an edit buffer. These buffers can be as small as 4k or as large as 64k, and they can grow or shrink dynamically with changes in the edited filesizes.     
  555. When a file gets too big to fit into the maximum buffer size allocated for it, V(edit) switches to the use of 'virtual' memory. That simply means that the editor uses a portion of the hard disk as a storage area for those parts of the file not resident in memory. 
  556. V(edit) checks the size of a file when it is opened for editing, and if it is bigger than a critical size, the file is opened in 'virtual memory mode'. In-situ checks are also made on files in the editor which are close to a critical size, and if necessary, the file is switched into 'virtual memory mode'. These actions require no intervention from the user and are totally transparent. 
  557.  Perfomance
  558. Issues
  559.  INDEX
  560.  PERFORMANCE ISSUES
  561.  FILES SMALLER THAN 64 KILOBYTES
  562. V(edit) is coded to be a very fast editor. When the file that is being edited is completely in memory, then speed is at a maximum. There are no external factors at work beyond the speed of the processor and the speed of the memory. In these circumstances, V(edit) can be run perfectly well from a floppy, with no speed penalty incurred. !
  563.  FILES LARGER THAN 64 KILOBYTES
  564. When the edited file is very large and is making use of virtual memory, then other factors can come into play, chiefly the disk I/O performance. The Virtual Memory manager in V(edit) has been written to minimise disk accesses. To improve disk I/O performance, do the following. {
  565. Run V(edit) on a hard disk, not a floppy. When V(edit) creates a virtual memory cache, it puts the cache in the same directory as the file being edited. Floppies have neither the speed nor the capacity to act as a virtual memory. If you attempt to edit a file from a floppy, that is big enough to need Virtual Memory, V(edit) will not load it but will display an error message. /
  566. Use a disk cache (SmartDrive is perfectly adequate). Any speed penalty when editing a very large file is due to the disk I/O performance, and a cache will help here. If possible, the cache should be as large as memory will allow (not usually a problem in Dos), and 'write-behind' caching should be ON. s
  567. Given the above configuration, there will be no discernable speed penalty when editing a bunch of humungous files. For example, with a 990 kilobyte text file, the time to jump from the start of file to the end of file is less than a second, and the 'search' time across the same file, looking for a unique 21 character string at the end of the file, is about 5 seconds. /
  568.  Configuration when editing very large files:
  569.     CACHE                       PERFORMANCE
  570.     None                        Disk Bound
  571.     Small, No Smart-Write       Adequate
  572.     Large, No Smart-Write       Better
  573.     Large, Smart-Write          Fast
  574.  RAM DISKS
  575. Don't be tempted to use a Ram disk such as ramdrive.sys to hold the file being edited. If the file is small, below 64K, then no improvement will be seen, and if the file is big, the ramdrive will be targeted as the virtual memory cache. This won't be any faster than a disk cache, but has the disadvantage of limiting the size of virtual memory to the capacity of the ramdrive. 
  576.  ABOUT
  577.  INDEX
  578.  SEARCH AND REPLACE
  579. The Edit|Search, Edit|Replace and Edit|Search Again commands let you search for and optionally replace strings. The search strings can include any characters, including control characters (see Regular Expressions below). A search string can be up to 80 characters long. 5
  580. There are three options in the 'Search' dialog box: A
  581.    Case Sensitive,
  582.    Regular Expressions,
  583.    Whole Words Only.
  584. There are five options in the 'Replace' dialog: g
  585.    Case Sensitive,
  586.    Regular Expressions,
  587.    Whole Words Only,
  588.    Prompt On Replace,
  589.    Replace All.
  590. In each dialog box, any, all or none of the options can be selected. 
  591.  REGULAR EXPRESSIONS
  592. A 'Regular Expression' is a search string which contains characters that have special meanings: they are operators that govern the search. (In a 'literal' string, there are no operators: each character is treated literally). |
  593. The 'Regular Expressions' mode uses the standard Unix search operators. The options that are available are detailed below. "
  594.  ^ start of line   $ end of line
  595.  . any character   \ quote next character
  596.  * match zero or   + match one or more
  597.    more of the       of the preceding
  598.    preceding char    character
  599. [aeiou0-9]   match a, e, i, o, u, and 0 thru 9 f
  600. [^aeiou0-9]  match anything but a, e, i, o, u, and 0 thru 9 
  601.  OPERATOR   MEANING
  602.  ^          Matches start of line.
  603.             The search string must begin
  604.             at the start of a line. The
  605.             hidden start-of-line
  606.             character is not selected on
  607.             a successful search.
  608. Example: ^abc 
  609. abcdef xxx abc 
  610. The first 'abc' will be found as it starts at the beginning of the line, but the second instance of 'abc' will be ignored. 
  611.  $          Matches end of line.
  612.             The search string must be
  613.             located at the end of a
  614.             line. The hidden end-of-line
  615.             character is not selected on
  616.             a successful search.
  617. Example:   abc$ 
  618. abcdef xxx abc 
  619. The second 'abc' will be found since it is at the of the line, but the first instance of 'abc' will be ignored. 
  620.  \          Quote the next character.
  621.             The next character may be a
  622.             special control character.
  623.             The special control
  624.             characters are;
  625.  \xhh       Matches the hex character
  626.             defined by the two chars
  627.             following the \x.
  628.             Example, \x1b matches the
  629.             'esc' character, and \x0b
  630.             matches ctrl-G.
  631.  \n         Matches a crlf pair embedded
  632.             in the search string.
  633.  \t         Matches a tab character.
  634.  \e         Matches an escape character.
  635.  \\         Matches a '\' character.
  636. Replacement strings do not make use of these control codes. Each character in the replacement string is accepted as literal text. *
  637.  .          Matches any character.
  638.  *          Matches zero or more
  639.             instances of the character
  640.             immediately preceding it.
  641. Example:    to* 
  642. Matches t, to, too etc. *
  643.  +           Matches one or more
  644.              instances of the character
  645.              immediately preceding it.
  646. Example:     to+ !
  647. Matches to, too etc, but not t. *
  648.  []         A string enclosed in
  649.             brackets matches any
  650.             character in that string. If
  651.             the first character in the
  652.             string is a circumflex '^',
  653.             the expression matches any
  654.             character EXCEPT the
  655.             characters in the string.
  656.             You can specify a range of
  657.             characters with two
  658.             characters separated by a
  659.             dash, '-'. These can be
  660.             combined to form expressions
  661.             like [a-bd-z?] to match ?
  662.             and any lowercase character
  663.             except 'c'.
  664. Example:    [^a-z]main *( 
  665. Matches.    main(i:integer) 
  666.             if (main   ())
  667. Does not match. 
  668.             mymain()
  669.  Notes:      None of the previously 
  670.             defined characters have any
  671.             special meaning when used in
  672.             a bracketed expression. In
  673.             addition, the '^' is only
  674.             treated specially when it is
  675.             the first character inside
  676.             the brackets. All of the
  677.             characters in a bracketed
  678.             set are case-sensitive,
  679.             regardless of the setting of
  680.             the case-sensitive checkbox.
  681.  INDEX
  682.  REPEAT NEXT COMMAND/KEYSTROKE
  683. The 'repeat' function allows multiple instances of a command or keystroke. The 'esc' key brings up the 'repeat' dialog box. Type in the number of repeats wanted and close the dialog box. The next keystroke is interrogated, and if valid, is repeated by the number required. Most keyboard commands and all text entry keys are accepted. 
  684.  INDEX
  685.  KEYSTROKE MACROS
  686. The keystroke macro function allows you to record a series of keystrokes and to replay them. Mouse actions are not recorded. User commands requiring the use of a dialog box, such as the 'repeat' command, are recorded and played back without user intervention. 
  687. The F7 key is the 'start macro recording' key. When pressed, the 'REC' symbol appears on the information line at the bottom of the screen. Keystrokes are recorded until F8, the 'stop macro recording' key is pressed, when the 'REC' symbol is removed. 1
  688. The F9 key is the 'playback macro' key. Place the cursor where you want the replay to begin and press F9. Macros are system wide, they can be recorded in any file and replayed in any file. They are not saved with the desktops. The Replay Key 'F9' is locked out during the recording of a keystroke macro. d
  689. There are no facilities yet for saving macros, although I'm thinking about it for future versions. ?
  690. Macros cannot be recorded or played back in a Read
  691. Only file. 
  692.  INDEX
  693.  SAVE A FILE
  694. The 'save file' key is F2. There is no dialog for this function unless the file is untitled, when a dialog box similar to the FileOpen dialog is presented. This command is inhibited when the file is Read
  695. Only. 
  696.  INDEX
  697.  SAVE AS..
  698. This function allows saving a file under another name. A dialog box similar to the FileOpen dialog is opened. When the box is closed, the file is saved under the new name and the window title is changed. This command is inhibited when the file is Read
  699. Only. 
  700.  INDEX
  701.  NEW FILE
  702. This function opens an empty, untitled window for editing. 
  703.  INDEX
  704.  CLOSE WINDOW
  705. Close Window can be selected from the menu File/Close (Alt-FL) or Desktop/Close (Alt- DL). The keyboard command for Close Window is Alt-F3. The mouse can also be used to close a window, by clicking on the Close Window icon (a square at the top left of the window). 
  706. The window and its associated file are closed immediately when Close is selected, unless the file has been modified, when an information box will be displayed, prompting for a yes/no decision. 
  707.  INDEX
  708.  SEARCH
  709. The Search facility will search forward for a string of characters, stopping when a match is found. The matched string is highlighted and the cursor is placed at the end. Options are available for a 'Case Sensitive' search, a 'Regular Expression' search and a 'Whole Words Only' search. The 'Search' can be repeated with the 'SearchAgain' command. 
  710.  INDEX
  711.  REPLACE
  712. The Replace facility will search forward for a string of characters and will optionally replace the matched string with the specified new text. Options are available for a 'Case Sensitive' search, a 'Regular Expression' search and a 'Whole Words Only' search. Replace options are 'Prompt on Replace', and 'Replace All'. The 'Replace' can be repeated with the 'SearchAgain' command. 
  713. Example: Replace. 
  714. If 'Prompt On Replace' is selected, the editor stops at the first match with the matching text highlighted and a dialog box pops up. The user instruction is then carried out and the Replace mode exits. 
  715. If 'Prompt On Replace' and 'Replace All' are selected, the editor stops at each match and carries out the user instructions, until there are no more matches or the user selects 'Cancel'. 
  716.  INDEX
  717.  SEARCH AGAIN
  718. The SearchAgain command repeats the last Search or Replace action. 
  719.  INDEX
  720.  GOTO LINE...
  721. The GotoLine command will jump forward or backward to the required line number. A dialog box pops up to get the line number. 
  722.  INDEX
  723.  FIND MATCHING BRACE
  724. The FindMatchingBrace command will jump to the next brace that matches the brace at the cursor. If the brace at the cursor is a left brace, V(edit) will search forward for a matching right brace, and vice-versa. While the search is proceeding, the cursor is blanked out. NOTE that this is the only indication you have when a search is in progress across a very large distance. 
  725. Either of the two key combinations for this command will search for the correct brace. Braces matched are <> () [] and curly braces. The <> braces are not searched for in C source files. 
  726.  INDEX
  727.  FIND SCREEN TOP
  728. The FindScreenTop command moves the cursor from the current line to the line at the top of the screen. 
  729.  INDEX
  730.  FIND SCREEN BOTTOM
  731. The FindScreenBottom command moves the cursor from the current line to the line at the bottom of the screen. 
  732.  INDEX
  733.  FIRST CHAR
  734. The FirstChar command moves the cursor from its present position to the first visible character on the curren line. 
  735.  INDEX
  736.  KILL TRAILING SPACES
  737. Most word-processors and text editors, and V(edit) is no exception, leave trailing spaces littered around the file. As well as increasing the file size, they can impede searches, particularly across line breaks. The KillTrailingSpaces command deletes all spaces between the last visible character on each line and the end-of-line character. When the command is active, a 'Kill' legend is shown on the information line at the bottom left of the window. When the command is finished, the 'Kill' legend is removed. The cursor does not move from its current position. 
  738.  INDEX
  739.  OVERWRITE MODE
  740. This is not a Global mode, but is individual to the window in which it is selected. In this mode of operation, new text overwrites the text at the cursor position. The cursor changes from a blinking '_' to a blinking '
  741. ' character. The mode can be toggled. 
  742.  INDEX
  743.  AUTO INDENT MODE
  744. This is not a Global mode, but is individual to the window in which it is selected. In this mode of operation, a new line will begin directly beneath the first character on the line above it. Spaces or tabs are used as the fill characters, depending on the file type. The mode is ON by default, but can be toggled. An Indent symbol is show on the information line at the bottom left of the window whenever the mode is active. 
  745.  INDEX
  746.  NEXT SPACE RIGHT
  747. This command moves the cursor to the first space after the current word. If the cursor is not positioned on a visible character, the cursor is moved to the first space after the next word. 
  748.  INDEX
  749.  UNDO
  750. The Undo command will undo the last typing action, provided that the cursor has not been moved in the meantime. 
  751.  INDEX
  752.  COPY CHARACTER DOWN
  753. The CopyCharDown command will copy the character directly above the cursor to the cursor position. The cursor is moved one position to the right. The contents of the clipboard are not disturbed. 
  754.  INDEX
  755.  TRANSPOSE CHARACTERS
  756. The TransposeChars command swaps the character at the cursor with the character immediately to its left. The cursor is moved one position to the right. The contents of the clipboard are not disturbed. 
  757.  INDEX
  758.  LITERAL
  759. The Literal command allows the insertion of control characters. When the command is activated, the next keystroke is accepted as a text insertion and not as a command. Note that this means that the ^I amd ^M characters are still handled as tabs and carriage returns respectively. 
  760.  INDEX
  761.  CASE COMMANDS
  762. These commands, UpperCaseWord, LowerCaseWord and UpperCaseChar act directly on the word from the position of the cursor. That means that a word will be changed to uppercase or lowercase from the cursor position only. 
  763.  INDEX
  764.  VIDEO MODE
  765. This command toggles the screen between EGA/VGA (43/50 lines) and 25 lines. 
  766.  INDEX
  767.  READ ONLY FILES
  768. When a file is already being edited, and another copy of the same file is required, then the copy is opened in 'Read Only' mode. All V(edit) movement commands are supported, and it is allowed to mark and copy data from the 'Read Only' file, but all insertion, deletion and save commands are inhibited. 
  769.  INDEX
  770.  DeTab to Line End
  771. This command will remove any hard tabs on the line from the cursor position to the end of the line. Each removed hard tab will be replaced with the correct number of spaces as governed by the current setting for soft tabs. 
  772.  INDEX
  773. This command will remove any hard tabs in the file from the cursor position to the end of the file. Each removed hard tab will be replaced with the correct number of spaces as governed by the current setting for soft tabs. 
  774.  INDEX
  775.