; ------------------------ EDIT.TXT ---------------------
;
; This is the help text file for Edit. It includes the help
; text for the Edit user interface.
;
; There can be a help window with a helptag name for each
; command in commands.h, each menu label on the menu bar 
; as defined in menus.c, and each dialog box name in dialogs.c
;
; There can be other help windows as well. Some of them will
; be displayed as the result of hypertext and definition key 
; words embedded in the help text of other help windows. Others
; can be implemented from within an application software system.
;
; Following is the format for a help window:
;
; ÚÄÄ (1st column of each line)
; 
; ; anything with a semicolon in the 1st column is a comment
; <helptag>                 (names the help window)
; [<<]<helptag>             (names the previous window in chain)
; [>>]<helptag>             (names the next window in chain)
; Help Window Title         (displays in window's title bar)
; Help text follows until next helptag occurs
; Hypertext reference  [..keyword]<helptag> embedded in text
; Definition reference [**keyword]<helptag> embedded in text
; <helptag>                 (names another window)
;
; Notes: 
;   1. A hypertext reference, when selected, causes the 
;      associated help window named by the <helptag> to 
;      become the active help window.
;   2. A definition reference, when selected, displays
;      a momentary window with the text of the associated
;      help window named by the <helptag>. The window 
;      closes when the user releases the Enter key or
;      mouse button.
;   3. A definition window has no title.
;   4. The last window is followed by the <end> helptag.
;   5. The window's height and width adjust to the text.
;   6. The [..], [**], and <helptags> do not display and
;      do not figure in the width of the line in which 
;      they occur.
;
; -----------------------------------------
<Application>
[<<]<MEMOPAD>
[>>]<Menubar>
Application Window
The Application Window is the desktop for the 
application.

The Application window contains the application's 
[..Document Windows]<docwindow>. Before you open any documents,
the Application window is empty.

The application window has an [..Action Bar]<Menubar> just below
its [..Title Bar]<titlebar> and a [..Status Bar]<statusbar> at the bottom.

Note that there might not be a title or status bar
depending on the [..Display]<ID_DISPLAY> option on the [..Options]<Options>
menu.
; -----------------------------------------
<MEMOPAD>
[>>]<Application>
FreeDOS Edit
Edit is a multi-window notepad program.

; -----------------------------------------
<MEMOPADDOC>
[<<]<Application>
The Edit Document Window
This [..Document Window]<docwindow> is a basic notepad text editor. You can 
have many of these windows open at one time.

; -----------------------------------------
<docwindow>
Document Window
A Document Window contains the data that you work
on. It displays within the [..Application Window]<Application> and
consists of these parts:

  [..Client Area]<client>
  [..Border]<border>
  [..Title Bar]<titlebar>
  [..Status Bar]<statusbar>
  [..Scroll Bars]<scrollbar>
  [..Control Box]<controlbox>
  [..Minimize Box]<minbox>
  [..Maximize Box]<maxbox>
  [..Restore Box]<restorebox>
  [..Resize Box]<sizebox>

; -----------------------------------------
<client>
[<<]<docwindow>
[>>]<border>
Client Area
The Client Area is the space inside the window's
borders where the application's data values are
displayed and manipulated.

; -----------------------------------------
<border>
[<<]<client>
[>>]<titlebar>
Border
The Border is the frame around a window. When the
window has the focus, the border is a double line.
When a different window has the focus, the border
is a single line.

The window's [..Scroll Bars]<scrollbar>, if any, are positioned
in the right and bottom parts of the border.
; -----------------------------------------
<titlebar>
[<<]<border>
[>>]<statusbar>
Title Bar
The Title Bar is at the top of the window and 
contains the window's title. When the window
has the focus, the title is highlighted. The
Title Bar includes these items as well:

  [..Control Box]<controlbox>
  [..Minimize Box]<minbox>
  [..Maximize Box]<maxbox>
  [..Restore Box]<restorebox> 

You can move the window with the mouse by clicking
the title bar and dragging the window to its new
location.

; -----------------------------------------
<statusbar>
[<<]<titlebar>
[>>]<scrollbar>
Status Bar
The Status Bar is at the bottom of the application window.
It displays the time and brief contextual messages about
the menus and other application-dependent features.

; ----------------------------------------- 
<scrollbar>
[<<]<statusbar>
[>>]<controlbox>
Scroll Bars
You use Scroll Bars to scroll a window's data with the
mouse. A window can have one or two Scroll Bars - one
at the right and one at the bottom parts of the
window's Border. The Scroll Bar at the right scrolls
the document's data up and down.  The Scroll Bar on
the bottom scrolls the window's data right and left.

To scroll a window a line at a time, click the arrow
tokens at either end of the Scroll Bar. The Scroll Bar
includes a slider box that indicates the relative
position of the window's display with respect to the
total document. You can page to an approximate position
within the document by clicking inside the Scroll Bar.
You can drag the slider box in either direction to
scroll the document.

; -----------------------------------------
<controlbox>
[<<]<scrollbar>
[>>]<minbox>
Control Box
The Control Box is indicated by the character (ð) at
the left end of the window's [..Title Bar]<titlebar>. You can
click it to select the System Menu or double click
it to close the window.

; -----------------------------------------
<minbox>
[<<]<controlbox>
[>>]<maxbox>
Minimize Box
The Minimize Box is the  token at the right 
end of the window's [..Title Bar]<titlebar>.

When you click on the Minimize Box, the window
is reduced to an icon at the bottom of the
[..Application Window]<Application>

; -----------------------------------------
<maxbox>
[<<]<minbox>
[>>]<restorebox>
Maximize Box
The Maximize Box is the  token at the right 
end of the window's [..Title Bar]<titlebar>.

When you click on the Maximize Box, the window
grows to occupy the entire [..Client Area]<client> of the
[..Application Window]<Application>

; -----------------------------------------
<restorebox>
[<<]<maxbox>
[>>]<sizebox>
Restore Box
The Restore Box is the  token character at the right
end of a minimized window's [..Title Bar]<titlebar> and the  token
character at the right end of a maximized window's
Title Bar. You click the Restore Box to restore the
window to the position and size it had before it was
minimized or maximized.

; -----------------------------------------
<sizebox>
[<<]<restorebox>
Resize Box
The Resize Box is the lower right corner of the
window's border. To change the window's size,
drag the Resize Box. The window's upper left
coordinates remain the same, and the lower right
coordinates change as you drag the mouse around.

; -----------------------------------------
<Menubar>
[<<]<application>
[>>]<Pulldowns>
The Action Bar
To select the action bar, do one of these:
  1. Press F10
  2. Press and release the Alt key
  3. Press Alt+the letter that is highlighted 
     in a menu's title on the action bar. The 
     selected menu will pull down.
  4. Click the action bar. If you click a 
     pull-down menu selection's title, that 
     menu will pull down.

To exit from the action bar and return to the
document or application window, do one of these:
  1. Press Esc
  2. Press and release the Alt key

; -----------------------------------------
;
;  Following are the Help system windows
;
; -----------------------------------------
<HelpHelp>
[<<]<Help>
[>>]<ExtHelp>
Help for Help
Getting Into the Help System
----------------------------
There are three ways to get into the Help system:

 1. Execute commands on the [..Help]<Help> menu
 2. Press F1
 3. Press the Help command button on a dialog box.

Contextual Help (F1)
--------------------
The F1 key provides contextual help--help for the
part of the application that currently has the
focus. You can press F1 with the action bar selected, 
a pull-down menu displayed, a field on a dialog box
selected, or a document window in focus.

The Help Command Button
-----------------------
The Help command button on a dialog box displays
information about the dialog box and its purpose.
The help window that displays when you press F1 with
a dialog box field selected relates to the field
itself.

References to Other Help Windows
--------------------------------
A Help window can include a reference to another
help window. That reference is highlighted like
this: 

    [..Help]<Help>

You can Tab to the highlighted reference and press
the Enter key to select the referenced help window.
You can select it with the mouse by double-clicking
on it.

Definitions
-----------
Some references, such as [**function key]<shortcut>, are
definitions of terms. These definitions are
highlighted the same as references. When you select
the definition, a window displays in the upper left
corner of the desktop. The window contains the
definition of the selected term and stays in view
until you release the Enter key or the mouse
button.

Command Buttons on the Help Windows
-----------------------------------
Each help window contains these [..command buttons]<cmdbuttons>:

  Close  This button closes the help window and
         exits from the help system.
  Back   This button changes to the help window
         that you viewed before the current one.
  Prev   This button changes to the help window
         that logically preceeds the current one.
  Next   This button changes to the help window
         that logically follows the current one.

Exiting from the Help System
----------------------------
You exit from the Help system by closing the current
help window in one of these three ways:

  1. Press the Esc key
  2. Use the Close command button on the Help
     window.
  5. Double click the window's [..Control Box]<controlbox>.
  4. Close the help window from its [..System Menu]<sysmenu>.

; -----------------------------------------
<ExtHelp>
[<<]<HelpHelp>
[>>]<KeysHelp>
Extended Help
Other features Edit has are:

The [..Log Messages]<ID_LOG>
and [..Display]<ID_DISPLAY> selections on the [..Options]<Options> menu are
unique to Edit.

Some of the Display features include:
The [..Title]<ID_TITLE>, [..Border]<ID_BORDER>,
[..Status Bar]<ID_STATUSBAR>, and [..Texture]<ID_TEXTURE> check boxes on the [..Display]<Display>
dialog box.

Edit comes with a lot of features to help
it look as attractive as possible to you.

; -----------------------------------------
<KeysHelp>
[<<]<ExtHelp>
[>>]<HelpIndex>
Keys Help
From the Desktop
----------------
  Alt+Hyphen      Open the desktop's [..SystemMenu]<sysmenu>.
  F10 or Alt      Activate the [..ActionBar]<menubar>.
  Esc             Deactivate the Action Bar.
  Alt+letter      Open the associated [..Pull-down menu]<Pulldowns>.
  Alt+F6          Change focus to another document.
  Alt+X           Exit the application.

From a [..Document Window]<docwindow>
----------------------
  Alt+Spacebar    Open the window's [..System Menu]<sysmenu>
  Alt+S           Save the document to a disk file.

[..Edit Box]<editbox> Keys
-----------
  Arrow keys      Move the cursor one character.
  Ctrl+Left/Right Move the cursor one word.
  Del             Delete character to the right of
                  the cursor. If a [..block]<Block> is marked,
                  delete the block.
  Backspace       Delete character to the left of
                  the cursor. If a block is marked,
                  delete the block.
  Ctrl+Z          Undo the last block deletion
                  (alias: Alt-BackSpace).
  PgUp/PgDn       Scroll forward and back one page.
  Ctrl+PgUp/PgDn  Scroll horizontally one page.
  Home/End        Move the cursor to the beginning
                  and end of the line.
  Ctrl+Home/End   Move the cursor to the beginning
                  and end of the document.
  Alt+P           Form a paragraph from the cursor 
                  position to the next blank line.
  Ctrl+P          The next key which you type after
                  Ctrl-P will be inserted verbatim,
                  even if it is a control character. ; *** ^P ... new 0.7 ***
  Ins             Toggle Insert/Overstrike mode.
  Tab             Tab to the next Tab Stop position.

[..Clipboard]<clipboard> Keys
--------------
  Ctrl+X          [..Cut]<ID_CUT> the marked text to the
                  Clipboard (alias: Shift+Del).
  Ctrl+C          [..Copy]<ID_COPY> the marked text to the
                  Clipboard (alias: Ctrl+Ins).
  Ctrl+V          [..Paste]<ID_PASTE> the contents of the
                  Clipboard into the document
                  (alias: Shift+Ins).

[..Dialog Box]<dialog> Keys
---------------
  Tab             Move to the next control.
  Shift+Tab       Move to the previous control.
  Enter           Execute the control.
  Esc             Close the Dialog Box with no
                  action.

[..Listbox]<listbox> Keys
------------
  Up/down arrows  Move the selection cursor
  Enter           Choose the selected entry
                  or entries.
  Ctrl+F8         Toggle Add mode (not Shift+F8!).
  Spacebar        In Add mode, select/deselect an  
                  entry.
; -----------------------------------------
<HelpIndex>
[<<]<KeysHelp>
Index of Help Titles
Select (Tab then Enter or double-click) from these 
titles to view the help screens related to each one.

  [..Application Window]<Application>
  [..Action Bar]<Menubar>
  [..Pull-down Menus]<Pulldowns>
    [..The File Menu]<File>
    [..The Edit Menu]<Edit>
    [..The Search Menu]<Search>
    [..The Utilities Menu]<Utilities>
    [..The Options Menu]<Options>
    [..The Window Menu]<Window>
    [..The Help Menu]<Help>
  [..Dialog Boxes]<Dialog>
    [..The File Open Dialog Box]<FileOpen>
    [..The Save As Dialog Box]<SaveAs>
    [..The MsgBox Dialog Box]<MsgBox>
    [..The Display Dialog Box]<Display>
    [..The Windows Dialog Box]<Windows>
    [..The Log Dialog Box]<Log>
  [..The Help System]<Help>
    [..Help for help...]<ID_HELPHELP>
    [..Extended help...]<ID_EXTHELP>
    [..Keys help...]<ID_KEYSHELP>
    [..Help index...]<ID_HELPINDEX>
    [..Reload Help Database]<ID_LOADHELP>

; -----------------------------------------
;
;  Following are menu command help windows
;
; -----------------------------------------
<ID_NEW>
[<<]<File>
[>>]<ID_OPEN>
The New Command
This command opens a new, untitled document
window. You can reach this command directly
by pressing Ctrl-N. An untitled document is
one that has not been given a file name.
When you use the [..Save]<ID_SAVE> or [..Save as]<ID_SAVEAS> command on
the File menu the document gets a file name.
; *** ^N new 0.7a ***

; -----------------------------------------
<ID_OPEN>
[<<]<ID_NEW>
[>>]<ID_SAVE>
The Open Command
This command opens an existing document and loads
it into a window. You select the document by
filling in the [..File Open]<FileOpen> dialog box. You can
reach this command directly by pressing Ctrl-O.
; *** ^O new 0.7a ***

; -----------------------------------------
<ID_SAVE>
[<<]<ID_OPEN>
[>>]<ID_SAVEAS>
The Save Command
This command saves the document in the currently
active document window into a disk file. The file
name is the same as when the file was loaded. You
can reach this command directly by pressing Ctrl-S.
If the window contains an untitled document, this
command works just like the [..Save as]<ID_SAVEAS> command.
; *** ^S new 0.7a ***

; -----------------------------------------
<ID_SAVEAS>
[<<]<ID_SAVE>
[>>]<ID_DELETEFILE>
The Save As Command
This command allows you to save the document in the
currently active document window under a new file
name. You specify the file's name by filling in the
fields on the [..Save as]<SaveAs> dialog box. 

The new file name becomes the title of the
currently active document window where the file is
displayed.

; -----------------------------------------
<ID_CLOSE>
[<<]<ID_SAVEAS>
[>>]<ID_PRINT>
The Close Command
Closes the file that you're currently viewing.

If you've changed the file since you've last
saved it, you will be prompted to save it again.
If saving fails, you are prompted again and given
the chance to save under another name.

; -----------------------------------------
<ID_DELETEFILE>
[<<]<ID_SAVEAS>
[>>]<ID_PRINT>
The Delete Command
Use this command to delete the text file displayed
in the active editbox window.

; -----------------------------------------
<ID_PRINT>
[<<]<ID_DELETEFILE>
[>>]<ID_PRINTSETUP>
The Print Command
This command prints the document in the
currently-selected document window.

; -----------------------------------------
<ID_PRINTSETUP>
[<<]<ID_PRINT>
[>>]<ID_DOS>
The Print Setup Command
This command displays the [..Print Setup]<PrintSetup> dialog
box to allow you to change the printer port
and margins for the printout.

; -----------------------------------------
<ID_DOS>
[<<]<ID_PRINT>
[>>]<ID_EXIT>
The DOS Command
This command "shells" out to DOS. You return to the
application from DOS by executing the DOS exit
command at the DOS command line. 

; -----------------------------------------
<ID_EXIT>
[<<]<ID_DOS>
The Exit Command
This command exits to DOS from the application. If
there are any changed documents that you have not
saved, the program will ask if you want to save
them and allow you to do so, one at a time.

; -----------------------------------------
<ID_UNDO>
[<<]<Edit>
[>>]<ID_CUT>
The Undo Command
This command "undoes" the most recent [..Delete]<ID_DELETETEXT> or
[..Clear]<ID_CLEAR> command. The text that was deleted by one of
these commands is written into the document at the
current cursor location.

; -----------------------------------------
<ID_CUT>
[<<]<ID_UNDO>
[>>]<ID_COPY>
The Cut Command
This command is active only when the current
document window has a [..marked block]<Block>. The command
deletes the text in the marked block, copies it to
the [..Clipboard]<Clipboard>, and closes up the space in the
document that the text previously occupied.

; ----------------------------------------- 
<ID_COPY>
[<<]<ID_CUT>
[>>]<ID_PASTE>
The Copy Command
This command is active only when the current
document window has a [..marked block]<Block>. The command
copies the text in the marked block to the 
[..Clipboard]<Clipboard>, and closes up the space in the document 
that the text previously occupied.

; -----------------------------------------
<ID_PASTE>
[<<]<ID_COPY>
[>>]<ID_CLEAR>
The Paste Command
This command is active only when the [..Clipboard]<Clipboard>
contains text. The command inserts the text from the
Clipboard into the currently active document window
at the current cursor location.

; -----------------------------------------
<ID_CLEAR>
[<<]<ID_PASTE>
[>>]<ID_DELETETEXT>
The Clear Command
This command is active only when the current
document window has a [..marked block]<Block>. The command
deletes the block of text, leaving empty space in
the document where the text had been.

You can undo the text deletion with the
[..Undo]<ID_UNDO> command.

; -----------------------------------------
<ID_DELETETEXT>
[<<]<ID_CLEAR>
[>>]<ID_PARAGRAPH>
The Delete Command
This command is active only when the current
document window has a [..marked block]<Block>. The command
deletes the block of text, closing the space in the
document where the text had been.

You can undo the text deletion with the
[..Undo]<ID_UNDO> command.

; -----------------------------------------
<ID_PARAGRAPH>
[<<]<ID_DELETETEXT>
The Paragraph Command
This command reforms a paragraph beginning at the
current keyboard cursor position. The end of the
paragraph is the last line preceding the next blank
line.

; -----------------------------------------
<ID_SEARCH>
[<<]<Search>
[>>]<ID_REPLACE>
The Search Command
This command opens the [..Search Text]<SearchTextDB> Dialog Box to
allow you to search the text for a
matching string.

; -----------------------------------------
<ID_REPLACE>
[<<]<ID_SEARCH>
[>>]<ID_SEARCHNEXT>
The Replace Command
This command opens the [..Replace Text]<ReplaceText> Dialog Box to
allow you to search the text for a
matching string and replace it with a 
different text string.

; -----------------------------------------
<ID_SEARCHNEXT>
[<<]<ID_REPLACE>
The Next Command
This command continues the most recent [..Search]<ID_SEARCH>
command beginning at the current cursor position.

; -----------------------------------------
<ID_INSERT>
[<<]<Options>
[>>]<ID_WRAP>
The Insert Toggle
This [**toggle]<toggle> command turns the editor's insert mode
on and off. When insert mode is on, the editor
inserts the text that you write. Otherwise each
character typed overwrites the one at the current
cursor position.

; -----------------------------------------
<ID_WRAP>
[<<]<ID_INSERT>
[>>]<ID_TABS>
Word Wrap
This [**toggle]<toggle> command turns the editor's word wrap
feature on and off. When word wrap is on, the editor
will wrap words as you type at the right margin of
the document window. When word wrap is off, the
editor will scroll the display horizontally as you
type beyond the right margin. 

; -----------------------------------------
<ID_TAB?>
[<<]<ID_WRAP>
[>>]<ID_DISPLAY>
The Tabs Command
This command allows you to
change the editor's tab settings.

; -----------------------------------------
<ID_DISPLAY>
[<<]<ID_TABS>
[>>]<ID_LOG>
The Display Command
This command displays the [..Display]<Display> dialog box to
allow you to modify the screen's colors and
configuration.

; -----------------------------------------
<ID_LOG>
[<<]<ID_DISPLAY>
[>>]<ID_SAVEOPTIONS>
The Log Messages Command
This command is used primarily for debugging. It
opens the [..Log Message]<Log> dialog box to allow the
programmer to select the Edit messages to log and
to turn message logging on and off.

; -----------------------------------------
<ID_SAVEOPTIONS>
[<<]<ID_LOG>
The Save Options Command
This command saves the current options in a
configuration file that the application reads when
it first starts up.

; -----------------------------------------
<ID_CLOSEALL>
[<<]<Window>
[>>]<ID_WINDOW>
The Close All Command
This command closes all the document windows on the
desktop.

; -----------------------------------------
<ID_WINDOW>
[<<]<ID_CLOSEALL>
[>>]<ID_MOREWINDOWS>
The Open Window List
The [..Window]<Window> menu displays a list of open document
windows. You can select one of them as the current
active window by selecting its title on the Window
menu. When the menu first displays, the active
window has a check mark (û) next to it.
<ID_MOREWINDOWS>
[<<]<ID_WINDOW>
More Windows
This command indicates that there are more open document
windows than the [..Window]<Window> menu can display.
Choose this command to see the [..Windows]<Windows> dialog box.

; -----------------------------------------
<ID_HELPHELP>
[<<]<Help>
[>>]<ID_EXTHELP>
Help for Help
This command describes how to use the Help system.

; -----------------------------------------
<ID_EXTHELP>
[<<]<ID_HELPHELP>
[>>]<ID_KEYSHELP>
Extended Help
Extended Help displays information about the
application.

; -----------------------------------------
<ID_KEYSHELP>
[<<]<ID_EXTHELP>
[>>]<ID_HELPINDEX>
Keys Help
This command displays a help window that shows the
keystrokes that you use to operate the application.

; -----------------------------------------
<ID_HELPINDEX>
[<<]<ID_KEYSHELP>
[>>]<ID_LOADHELP>
Help Index
The Help index lists the subjects covered in the
Help database. You can go directly to a subject from
the index by selecting the subject's name. 

; -----------------------------------------
<ID_LOADHELP>
[<<]<ID_HELPINDEX>
[>>]<ID_ABOUT>
Reload Help Database
This command allows you to reload the Help
database. It is useful when you use the
Edit program to modify its Help database.
You can change and save the EDIT.TXT file,
use this command to reload it, then use the
Help system to view the results. Without this
command, your changes would corrupt the
current Edit's picture of the database
with respect to its pointers.

You must delete the EDIT.HLP compressed
help database in order for this program to
load the most recent changes.

; -----------------------------------------
<ID_ABOUT>
[<<]<ID_LOADHELP>
The About Command
This command displays a message that tells you what
the application is.

; -----------------------------------------
<ID_FILENAME>
[>>]<ID_FILES>
The Filename Field

On the Open File dialog box:
    Enter the name of the file you wish to
    open into a document window, or enter
    the file specification with wild cards
    to display a list of files in the
    [..Files]<ID_FILES> field.

On the Save As dialog box:
    Enter the name with which you wish to
    save the file.
; -----------------------------------------
<ID_FILES>
[<<]<ID_FILENAME>
[>>]<ID_DRIVE>
The Files Field
Select a file from the listbox by using one
of these methods:

Keyboard:  Move the selection cursor to
           the file name and press Enter.

Mouse:     Double-click the file name.

; -----------------------------------------
<ID_DRIVE>
[<<]<ID_FILES>
The Directories Field
Use this listbox to select a different
drive or subdirectory. Select a drive or
subdirectory from the listbox by using one
of these methods:

Keyboard:  Move the selection cursor to
           the drive or subdirectory and 
           press Enter.

Mouse:     Double-click the drive or
           subdirectory.

; -----------------------------------------
<ID_PRINTERPORT>
[<<]<PrintSetup>
[>>]<ID_LEFTMARGIN>
The Printer Port Combo Box
Use this combo box to change the printer
port and to set the report's margins.

; -----------------------------------------
<ID_LEFTMARGIN>
[<<]<ID_PRINTERPORT>
[>>]<ID_RIGHTMARGIN>
The Left Margin Spin Button
Change the left margin by increasing
and decreasing the value in this 
spin box.

; -----------------------------------------
<ID_RIGHTMARGIN>
[<<]<ID_LEFTMARGIN>
[>>]<ID_TOPMARGIN>
The Right Margin Spin Button
Change the right margin by increasing
and decreasing the value in this 
spin box.

; -----------------------------------------
<ID_TOPMARGIN>
[<<]<ID_RIGHTMARGIN>
[>>]<ID_BOTTOMMARGIN>
The Top Margin Spin Button
Change the top margin by increasing
and decreasing the value in this 
spin box.

; -----------------------------------------
<ID_BOTTOMMARGIN>
[<<]<ID_TOPMARGIN>
The Bottom Margin Spin Button
Change the bottom margin by increasing
and decreasing the value in this 
spin box.

; -----------------------------------------
<ID_SEARCHFOR>
[>>]<ID_REPLACEWITH>
The Search For Text Entry Box
Enter the text you want to search for in this
text box. Press Enter or the OK command button
to begin the search. Press Esc to forget it.
Use the [..Match Upper/Lower Case Check Box]<ID_MATCHCASE> to
select whether the search will match only if
the case matches or if the search is insensitive
to the case of the two strings.

; -----------------------------------------
<ID_REPLACEWITH>
[<<]<ID_SEARCHFOR>
[>>]<ID_MATCHCASE>
The Replace With Text Entry Box
Enter the text string that will replace
the matching text string in the
[..Search For Text Entry Box]<ID_SEARCHFOR>.

; -----------------------------------------
<ID_MATCHCASE>
[<<]<ID_REPLACEWITH>
[>>]<ID_REPLACEALL>
The Match Upper/Lower Case Check Box
Use this checkbox to select whether the search 
will match only if the case matches or if the 
search is insensitive to the case of the two 
strings.

; -----------------------------------------
<ID_REPLACEALL>
[<<]<ID_MATCHCASE>
The Replace Every Match Check Box
Use this checkbox to select whether the search 
will replace every match in the document.

; -----------------------------------------
<ID_TITLE>
[<<]<Display>
[>>]<ID_BORDER>
The Title Check Box
Select this Check Box to toggle the application
window's title on and off. Without a title, the
window also loses its [..Control Box]<controlbox>.

; -----------------------------------------
<ID_BORDER>
[<<]<ID_TITLE>
[>>]<ID_STATUSBAR>
The Border Check Box
Select this Check Box to toggle the application
window's border on and off. Without a border, the
window also loses its [..Status Bar]<statusbar>.

; -----------------------------------------
<ID_STATUSBAR>
[<<]<ID_BORDER>
[>>]<ID_TEXTURE>
The Status Bar Check Box
Select this Check Box to toggle the application
window's [..Status Bar]<statusbar> on and off.

; -----------------------------------------
<ID_TEXTURE>
[<<]<ID_STATUSBAR>
[>>]<ID_COLOR>
The Texture Check Box
Select this Check Box to toggle the application
window's background texture on and off.

; -----------------------------------------
<ID_COLOR>
[<<]<ID_TEXTURE>
[>>]<ID_MONO>
The Color Option Button
Select this option for a color display.

; -----------------------------------------
<ID_MONO>
[<<]<ID_COLOR>
[>>]<ID_REVERSE>
The Mono Option Button
Select this option for a monochrome display.

; -----------------------------------------
<ID_REVERSE>
[<<]<ID_MONO>
[>>]<ID_25LINES>
The Reverse Option Button
Select this option for a reverse monochrome
display. You might find that this option
works well with the LCD screens of some laptop
computers, particularly when you turn off the
[..Texture]<ID_TEXTURE> check box.

; -----------------------------------------
<ID_25LINES>
[<<]<ID_REVERSE>
[>>]<ID_43LINES>
The 25 Lines Option Button
Use this button to select a 25-line display.

; -----------------------------------------
<ID_43LINES>
[<<]<ID_25LINES>
[>>]<ID_50LINES>
The 43 Lines Option Button
Use this button to select a 43-line display.
(EGA and VGA)

; -----------------------------------------
<ID_50LINES>
[<<]<ID_43LINES>
[>>]<ID_SNOWY>
The 50 Lines Option Button
Use this button to select a 50-line display.
(VGA only)

; -----------------------------------------
<ID_SNOWY>
[<<]<ID_50LINES>
Snowy Display
Select this check box if your display
(usually a CGA) displays video snow when
you change the screen.

; -----------------------------------------
<ID_LOGLIST>
[<<]<Options>
[>>]<ID_LOGGING>
The Messages Listbox
This is a list of messages that
you can log when the [..Logging]<ID_LOGGING> checkbox is
selected. The list is a [..Multiple-Selection]<MultiSel>
listbox. 

; -----------------------------------------
<ID_LOGGING> [<<]<ID_LOGLIST>
The Logging CheckBox
This checkbox turns message logging on and off.

;-----------------------------------------
<TEXTBOX> The TEXTBOX Window Class

No help available for this command.

; -----------------------------------------
<LISTBOX>
The LISTBOX Window Class

No help available for this command.

; -----------------------------------------
<EDITBOX>
The EDITBOX Window Class

No help available for this command.

; -----------------------------------------
<Pulldowns>
[<<]<menubar>
[>>]<File>
Pull-down Menus
Pull-down menus contain the commands to operate
the program. Read about the [..Action Bar]<menubar> to see
how to select the pull-down menus. Following
is a list of the pull-down menus.

    [..The File Menu]<File>
    [..The Edit Menu]<Edit>
    [..The Search Menu]<Search>
    [..The Options Menu]<Options>
    [..The Window Menu]<Window>
    [..The Help Menu]<Help>

The [..System Menu]<sysmenu> is another kind of pull-down menu.
; -----------------------------------------
<File>
[<<]<Pulldowns>
[>>]<Edit>
The File Menu
The File menu contains commands that
open, save, and print files. The menu
also has the command that exits the
program. Following are the commands
and associated [**function keys]<shortcut>.

    [..New]<ID_NEW>      (Ctrl+N)
    [..Open]<ID_OPEN>     (Ctrl+O)
    [..Save]<ID_SAVE>     (Alt+S or Ctrl+S)
    [..Save as]<ID_SAVEAS>
    [..Print]<ID_PRINT>
    [..Exit]<ID_EXIT>     (Alt+X or Alt+F4)

[**Inactive]<inactive> commands display in a dim font.
; -----------------------------------------
<Edit>
[<<]<File>
[>>]<Search>
The Edit Menu
The Edit menu contains commands that support
text editing. Following are the commands and 
associated [**function keys]<shortcut>.

    [..Undo]<ID_UNDO>         (Ctrl+U)
    [..Cut]<ID_CUT>         (Ctrl+X)
    [..Copy]<ID_COPY>         (Ctrl+K)
    [..Paste]<ID_PASTE>         (Ctrl+V)
    [..Clear]<ID_CLEAR>
    [..Delete]<ID_DELETETEXT>        (Del)
    [..Paragraph]<ID_PARAGRAPH>     (Alt+P)

[**Inactive]<inactive> commands display in a dim font.
; -----------------------------------------
<Search>
[<<]<Edit>
[>>]<Utilities>
The Search Menu
The Search menu allows you to search the text
for a matching string. The commands are:

    [..Search]<ID_SEARCH>
    [..Next]<ID_SEARCHNEXT>    (F3)
; -----------------------------------------
<Utilities>
[<<]<Search>
[>>]<Options>
The Utilities Menu
The Utilities Menu has one command that
demonstrates the use of the PICTUREBOX window
class. It also has a simple ASCII table.
The commands are:

    [..Calendar]<ID_CALENDAR>
    [..ASCII Table]<ID_ASCIITAB>
; -----------------------------------------
<Options>
[<<]<Utilities>
[>>]<Window>
The Options Menu
The Options menu contains commands that let you
control the editor's behavior, the video display
characteristics, and whether to [**log]<logging> messages.
You can save the options in a configuration file.
Following are the commands on the Options menu.

    [..Insert]<ID_INSERT>     (Ins)
    [..Word wrap]<ID_WRAP>
    [..Tabs]<ID_TABS>
    [..Display]<ID_DISPLAY>
    [..Log Messages]<ID_LOG>
    [..Save Options]<ID_SAVEOPTIONS>
; -----------------------------------------
<Window>
[<<]<Options>
[>>]<Help>
The Window Menu
The Window menu has no selections unless the
[..Application window]<Application> has one or more document
windows displayed. When documents are displayed,
the Window menu contains a [..Close All]<ID_CLOSEALL> command
and an entry for the first nine document windows. 
You can select a document window from the Window
menu. If the Application window has more than nine
document windows, the Window menu has the [**More Windows]<MoreWins>
command, which displays the [..Windows]<Windows> dialog box.
; -----------------------------------------
<Help>
[<<]<Window>
The Help Menu
The Help menu provides information about the 
application and the desktop. The selections are:

    [..Help for help...]<ID_HELPHELP>
    [..Extended help...]<ID_EXTHELP>
    [..Keys help...]<ID_KEYSHELP>
    [..Help index...]<ID_HELPINDEX>
    [..About...]<ID_ABOUT>

; -----------------------------------------
<sysmenu>
[<<]<Pulldowns>
[>>]<ID_SYSRESTORE>
The System Menu
Most windows have a system menu. If the window has a
System Menu, the window will have a [..Control Box]<controlbox>. You
can select the System Menu by clicking the control
box or by pressing Alt+Spacebar for the application
window's system menu and Alt+Hyphen for the system
menu of other windows. 

Following are the commands on the System Menu:

    [..Restore]<ID_SYSRESTORE>
    [..Move]<ID_SYSMOVE>
    [..Size]<ID_SYSSIZE>
    [..Minimize]<ID_SYSMINIMIZE>
    [..Maximize]<ID_SYSMAXIMIZE>
    [..Close]<ID_SYSCLOSE>

; -----------------------------------------
<ID_SYSRESTORE>
[<<]<sysmenu>
[>>]<ID_SYSMOVE>
The Restore Command on the System Menu
This command restores a [..Minimized]<ID_SYSMINIMIZE> or [..Maximized]<ID_SYSMAXIMIZE>
window to the size and position it had before it
was minimized or maximized.

You can also restore a minimized or maximized 
window by clicking its [..Restore Box]<restorebox>.
; -----------------------------------------
<ID_SYSMOVE>
[<<]<ID_SYSRESTORE>
[>>]<ID_SYSSIZE>
The Move Command on the System Menu
The Move command lets you move a window with the
keyboard. Select the command from the System Menu. A
movable window frame comes into view over the
window's border. Use the up, down, left, and right
arrow keys to move the frame to the new window
position. Press the Enter key when the movable frame
is where you want to move the window. Press the Esc
key to ignore the movement.

You can move a window with the mouse by clicking on
the window's [..Title Bar]<titlebar> and dragging the window to
the new location. 
; -----------------------------------------
<ID_SYSSIZE>
[<<]<ID_SYSMOVE>
[>>]<ID_SYSMINIMIZE>
The Size Command on the System Menu
The Size command lets you re-size a window with the
keyboard. Select the command from the System Menu. 
A sizeable window frame comes into view over the
window's border. Use the up, down, left, and right
arrow keys to change the frame to the new window
size. Press the Enter key when the sizeable frame
is the size you want for the window. Press the Esc
key to ignore the size change.

You can re-size a window with the mouse by clicking
on the window border's [..Resize Box]<sizebox> and dragging the 
window to the new size.
; -----------------------------------------
<ID_SYSMINIMIZE>
[<<]<ID_SYSSIZE>
[>>]<ID_SYSMAXIMIZE>
The Minimize Command on the System Menu
This command minimizes the window to an icon at the
bottom of the application window.

You can minimize a window with the mouse by clicking
on the window's [..Minimize Box]<minbox>.

The [..Restore]<ID_SYSRESTORE> command restores a minimized window to
the size and position it had before it was
minimized.
; -----------------------------------------
<ID_SYSMAXIMIZE>
[<<]<ID_SYSMINIMIZE>
[>>]<ID_SYSCLOSE>
The Maximize Command on the System Menu
This command maximizes the window to occupy all of
the application window's client area.

You can maximize a window with the mouse by clicking
on the window's [..Maximize Box]<maxbox>.

The [..Restore]<ID_SYSRESTORE> command restores a maximized window to
the size and position it had before it was
maximized.
; -----------------------------------------
<ID_SYSCLOSE>
[<<]<ID_SYSMAXIMIZE>
The Close Command on the System Menu
This command closes the window with which the System
Menu is associated.

You can also close the window by double-clicking the
[..Control Box]<controlbox> or pressing Ctrl+F4.
; -----------------------------------------
;
;  Following are dialog box help windows
;
; -----------------------------------------
<Dialog>
[>>]<cmdbuttons>
Dialog Boxes
Dialog Boxes allow you to enter data into the
application. A Dialog Box consists of these
controls:

    [..Command Buttons]<cmdbuttons>
    [..Check Boxes]<checkboxes>
    [..Option Buttons]<optbuttons>
    [..Edit Boxes]<editboxes>
    [..List Boxes]<listboxes>
    [..Multiple-Selection Listboxes]<MultiSel>
    [..Combo Boxes]<combobox>
    [..Spin Buttons]<spinbutton>

Move from control to control by using the Tab key
or by pressing Alt+ the highlighted character in
the control's label. Execute a control by pressing
the Enter key. 

Exit the Dialog Box and accept its data entries by
executing the OK command button. 

Exit the Dialog Box and reject its data entries by
executing the Cancel command button. 
; -----------------------------------------
<cmdbuttons>
[<<]<Dialog>
[>>]<checkboxes>
Command Buttons
Select a command button to execute its
command by using one of these procedures:

  1. Click the button.
  2. Press Alt+ the shortcut key.
  3. Tab to the button and press Enter.
; -----------------------------------------
<checkboxes>
[<<]<cmdbuttons>
[>>]<optbuttons>
Check Boxes
A check box can be on [X] or off [ ].
Toggle the check box with one of these
procedures:

  1. Click the check box.
  2. Press Alt+ the shortcut key.
; -----------------------------------------
<optbuttons>
[<<]<checkboxes>
[>>]<editboxes>
Option Buttons
Option buttons are in groups of 2 or
more. One option button in a group
is on () and the others are off ( ).
Select the option button with one of
these procedures:

  1. Click the option button.
  2. Press Alt+ the shortcut key.
; -----------------------------------------
<editboxes>
[<<]<optbuttons>
[>>]<listboxes>
Edit Boxes

No help available for this command.

; -----------------------------------------
<listboxes>
[<<]<editboxes>
[>>]<MultiSel>
List Boxes

No help available for this command.

; -----------------------------------------
<MultiSel>
[<<]<listboxes>
[>>]<combobox>
Multiple-Selection Listboxes

No help available for this command.

; -----------------------------------------
<combobox>
[<<]<MultiSel>
[>>]<spinbutton>
Combo Boxes

No help available for this command.

; -----------------------------------------
<spinbutton>
[<<]<combobox>
Spin Buttons

No help available for this command.

; -----------------------------------------
<FileOpen>
The File Open Dialog Box

Opens an existing file or creates a new named file.

   You can use the Files and Directories boxes to select the
    path name for the file.  Or you can type the path name in
    the File Name box.

   If the file doesn't exist, a new empty file is created with
    the specified path name.

; -----------------------------------------
<SaveAs>
The Save As Dialog Box

Saves and names the file you are working on.

   Use this to name a new unnamed file, or to rename an existing
    file.  Use the File Save command to save an existing file
    without renaming it.

   Enter the new path name in the File Name box.  Or you can use
    the Directories and Existing Files boxes to help you select a
    different filename, directory or drive.

   If there's already an existing file with the same name, then
    Edit asks you if you're sure you want to replace it with this
    file.

; -----------------------------------------
<PrintSetup>
The Print Setup Dialog Box

Prints the selected file you are working on.

   To print only part of the file, select the text you want to
    print.  In the Print dialog box, click Selected Text Only.

   To print the whole file, click Complete Document.

; -----------------------------------------
<SearchTextDB>
The Search Text Dialog Box

Finds text in a file.

   To find text that is an entire word and not part of a longer
    word, click Match Whole Word Only.

   To find text with the same combination of uppercase and
    lowercase letters as the find text, click Match Case.

   You can press ESC at any time to cancel the search.

; -----------------------------------------
<ReplaceTextDB>
The Replace Text Dialog Box

Finds specified text and replaces it with new text.

   To confirm each replacement, click the Replace button.

   To replace all occurrences of the text at once, click the
    Replace All button.

   To find text that is an entire word and not part of a longer
    word, click Match Whole Word Only.

   To find text with the same combination of uppercase and
    lowercase letters as the find text, click Match Case.

The first occurrence of the text is selected, and you are
prompted to either Replace this match, or Skip this match
without replacing it, or to Cancel the search.  You can also
press ESC at any time to cancel the search.

; -----------------------------------------
<MsgBox>
The MsgBox Dialog Box

No help available for this command.

; -----------------------------------------
<Display>
The Display Dialog Box

Changes the way Edit looks.

    [..Title]<ID_TITLE>
    [..Border]<ID_BORDER>
    [..Status Bar]<ID_STATUSBAR>
    [..Texture]<ID_TEXTURE>

    [..Color]<ID_COLOR>
    [..Mono]<ID_MONO>
    [..Reverse]<ID_REVERSE>

; -----------------------------------------
<Windows>
The Windows Dialog Box
This dialog box lists all the open windows.
Select one and choose OK to make that window
the active one.
; -----------------------------------------
<Log>
The Log Message Dialog Box

No help available for this command.

; -----------------------------------------
;
;  Following are keyword reference definition windows
;
; -----------------------------------------
<inactive>
An inactive menu command is one that is, for
the moment, not available. The command becomes
active at another time when conditions within
the program require or permit its use.
; -----------------------------------------
<shortcut>
Function keys are key combinations that
you can press to execute a menu command
without selecting the pull-down menu 
itself. Not all menu commands have 
function keys. The most frequently used 
operations do.
; -----------------------------------------
<logging>
The message log is a debug tool. You should
delete it from the system by turning off the
INCLUDE_LOGGING global definition in dflat.h.
You should then eliminate references to it in
the EDIT.TXT help database.
; -----------------------------------------
<MoreWins>
A menu can have only so many selections.
The length of the screen is the limiting
factor. The CUA standard defines nine
windows as the maximum number of windows
that the Window menu can display. The 
Windows menu has the More Windows command 
to provide a way for you to choose from
the rest of the document windows.
; -----------------------------------------
<API>
Applications Program Interface (API):
The functions, messages, macros, and 
data structures that a programmer 
uses to interface with the processes 
of a function library.
; -----------------------------------------
<Block>
Marking Text Blocks
Marked text blocks affect the operation of these
commands:

    [..Cut]<ID_CUT>
    [..Copy]<ID_COPY>
    [..Paste]<ID_PASTE>
    [..Clear]<ID_CLEAR>
    [..Delete]<ID_DELETETEXT>
    [..Paragraph]<ID_PARAGRAPH>

Mark a text block by using one of these operations:

   Keyboard:
   ---------
   Hold the Shift key down and move the
   keyboard cursor. The block will be marked in
   reverse video.

   To clear the marked block, release the Shift 
   key and press any text entry or cursor movement
   key.

   Mouse:
   ------
   Click on the first or last character of the 
   block. Hold the mouse button down and move 
   the mouse cursor around. The marked block
   will follow the mouse cursor.

   To clear the marked block, release the mouse
   cursor and click anywhere.

; -----------------------------------------
<Clipboard>
The Clipboard
The Clipboard is a scratchpad where you can save
text that can be pasted into a different location
in the same or another document. You save text with
the [..Copy]<ID_COPY> and [..Cut]<ID_CUT> commands, and you paste text into
from the Clipboard into a document with the [..Paste]<ID_PASTE>
command. 
; -----------------------------------------
<toggle>
A toggle command is one that is
either on or off. When it is on,
its command on the menu is preceded
by a check mark (û).
<ID_CALENDAR>
Calendar
This command displays a calendar to demonstrate
the use of the PICTUREBOX class to draw line
vectors.
<Calendar>
Calendar
This calendar is an example of a picture box
with line vectors. The PgUp and PgDn keys
will page through the months. You can close 
the window from the [..System Menu]<sysmenu>.
<ID_ASCIITAB>
ASCII Table
This command displays a simple ASCII table. You
can navigate in the table with the cursor keys.
<ASCII Table>
ASCII Table
The ASCII Table window gives a  quick overview of
your screen font. The cursor keys navigate through
the table.  The selected character is highlighted
and the corresponding  decimal,  hexadecimal  and
octal character number are shown. Some characters
have special meanings for DFLAT and are therefore
shown as * (characters 0, 0xae, 0xaf).
; If TAB_TOGGLING is on, also characters 0x89, 0x8c.
You can close the window from the [..System Menu]<sysmenu>.
<end>
