OS/2 Shareware BBS: 5 Edit/05-Edit.zip/bedit2.zip/BEDIT2.HLP

OS/2 Help File | 1995-09-07 | 12KB | 341 lines

ΓòÉΓòÉΓòÉ 1. File ΓòÉΓòÉΓòÉ

The File menu contains commands that you use to open a new file, save the
current file or save the current file with a new name.

 New
     Closes the current and allows you to open a new file for editing

 Save
     Saves the current file

 Save As
     Allows you to save the current file with a new name

 Exit
     Quits Bedit2. You will be prompted to save or abandon the changes if
     changes have been made to the file since the last save.


ΓòÉΓòÉΓòÉ 1.1. File Open ΓòÉΓòÉΓòÉ

This menu choice closes the current file and allows you to select a new file
for editing. If any changes have been made in the current file since the last
time the file was saved, you will be prompted to save or discard the changes.

To open a file, do the following:

     Select the File menu and choose the New command.

     Select the file from the File Open dialog box.

 The File Open dialog box appears, showing you a list of files in the current
 directory. Use the dialog box to select the path and file name of the file you
 wish to edit. Bedit2 will not create a new file.


ΓòÉΓòÉΓòÉ 1.2. File Save ΓòÉΓòÉΓòÉ

You use the Save command to save the changes in the current file. The contents
of the file before the changes were made will be saved with a '~' as the first
character of the file extension.


ΓòÉΓòÉΓòÉ 1.3. File Save As ΓòÉΓòÉΓòÉ

You use the Save As choice to save the current file with a new name. If a file
of the new name exists, the old file will be overwritten.


ΓòÉΓòÉΓòÉ 1.4. File Exit ΓòÉΓòÉΓòÉ

You quit the application by using the Exit command.

If changes have been made which have not been saved, you will be prompted to
save or discard the changes.


ΓòÉΓòÉΓòÉ 2. Edit ΓòÉΓòÉΓòÉ

The Edit menu contains commands that you use to access the various editing
commands supported by Bedit2.

The following commands appear in the Edit menu:

 Mark            Toggles Bedit2 in and out of mark mode

 Delete          Delete the marked area

 Insert          Insert a file or a series of bytes/integers at the current
                 locataion

 Replace         Replace one series of bytes with another

 Goto            Enter an address at which to place the cursor

 Overwrite       Enter a series of bytes to overwrite the bytes in the file at
                 the current cursor location


ΓòÉΓòÉΓòÉ 2.1. Edit Mark ΓòÉΓòÉΓòÉ

Use the Mark menu item to toggle in and out of Mark Mode. While in Mark Mode
you can select an area of the file to be deleted. In general the marking is
done on a two click rotation. The first click starts the mark region, the
second click completes the mark. Clicking again will clear the previous mark
and start another one. Once a mark has been started, any of the cursor
placement features may be used to locate the end mark including the Goto and
Search features.

While in Mark Mode you can also mark a region by dragging the mouse. The drag
operation is counted as the first click so that you can continue the mark by
using other cursor movement features if necessary.

When you leave Mark Mode the mark is cleared.

While in Mark Mode the Mark menu item will be checked.


ΓòÉΓòÉΓòÉ 2.2. Edit Delete ΓòÉΓòÉΓòÉ

Use the Delete menu item to delete a marked section of the file. If not in Mark
Mode this menu item is disabled.


ΓòÉΓòÉΓòÉ 2.3. Edit Insert ΓòÉΓòÉΓòÉ

The Insert menu item allows you to enter a pattern to be inserted at the
current cursor location or enter a file name whose contents will be inserted at
the current cursor location.

Patterns for insertion may be entered as ASCII text, integers, or hexadecimal
values.

Integers and hex values are seperated by spaces.


ΓòÉΓòÉΓòÉ 2.4. Insert File ΓòÉΓòÉΓòÉ

This menu item displays the File Open dialog box so that you may select a file
for insertion.


ΓòÉΓòÉΓòÉ 2.5. Insert Text/Value ΓòÉΓòÉΓòÉ

This menu choice displays a dialog box with an entry field where you can enter
the pattern you want inserted. The dialog box also contains radio buttons to
select the entry type. The type can be ASCII text, integer values, or
hexadecimal values.

Integers and hex values are seperated by spaces.


ΓòÉΓòÉΓòÉ 2.6. Edit Replace ΓòÉΓòÉΓòÉ

The Replace menu item pops up a dialog box which allows you to enter a search
pattern and a replacement pattern and execute a search and replace operation.
The patterns can be entered as ASCII text, integers values, or hexadecimal
values. Until the Done button is pushed or the end of the file is reached, the
dialog box will stay open allowing you to continue the search and replace
operation.

To execute a search and replace operation, enter the Search and Replace
patterns, select the appropriate type, then choose the Find push button. The
cursor will advance to the first occurance of the pattern starting from the
cursor's current position. At this point you may choose the Change pushbutton
to affect the change, the Find Next button to skip the occurance, or the Change
All button to cause all of the occurances of the pattern from the cursor to the
end of the file to be changed. To change all of the occurances of a pattern in
a file the cursor position must before the first occurance of the pattern in
the file.

In general the Find button finds the first occurance of a pattern from the
current cursor location and the Find Next button finds the next occurance
starting from the previous found pattern.

The dialog box will be dismissed when the end of file is reached, the Done
button is selected, or is closed through the system menu.

This menu selection has the same effect as the Search menu item.

Integers and hex values are seperated by spaces.


ΓòÉΓòÉΓòÉ 2.7. Edit Goto ΓòÉΓòÉΓòÉ

The Goto menu selection displays a dialog box with an entry field where you can
enter the offset into the file where you want the cursor to be placed. The
address must be a hexadecimal value.


ΓòÉΓòÉΓòÉ 2.8. Edit Overwrite ΓòÉΓòÉΓòÉ

The Overwrite menu choice displays a dialog box with an entry field where you
enter a pattern to be placed into the file. The bytes of the file will be
overwritten byte for byte by the pattern you entered starting at the cursor
location. The dialog box also contains radio buttons to indicate if the pattern
was entered as ASCII characters, integers, or hexadecimal values.

Integers and hex values are seperated by spaces.


ΓòÉΓòÉΓòÉ 3. Search ΓòÉΓòÉΓòÉ

The Search menu item pops up a dialog box which allows you to enter a search
pattern. You can also enter a replacement pattern and execute a search and
replace operation from this dialog box. The pattern(s) can be entered as ASCII
text, integers values, or hexadecimal values. Until the Done button is pushed
or the end of the file is reached, the dialog box will stay open allowing you
to continue the search operation.

To execute a search and replace operation, enter the Search and Replace
patterns, select the appropriate type, then choose the Find push button. The
cursor will advance to the first occurance of the pattern starting from the
cursor's current position. At this point you may choose the Change pushbutton
to affect the change, the Find Next button to skip the occurance, or the Change
All button to cause all of the occurances of the pattern from the cursor to the
end of the file to be changed. To change all of the occurances of a pattern in
a file the cursor position must before the first occurance of the pattern in
the file.

In general the Find button finds the first occurance of a pattern from the
current cursor location and the Find Next button finds the next occurance
starting from the previous found pattern.

The dialog box will be dismissed when the end of file is reached, the Done
button is selected, or is closed through the system menu.

Integers and hex values are seperated by spaces.


ΓòÉΓòÉΓòÉ 4. Preferences ΓòÉΓòÉΓòÉ

Preferences allows you to select the font size you want and to save you choice
so that Bedit2 will use your choice as the default font. The default font is
Courier 8 point. Fonts are limited to fixed space bitmap fonts.


ΓòÉΓòÉΓòÉ 4.1. Preferences Fonts ΓòÉΓòÉΓòÉ

The Fonts menu item brings up the system Font Selection dialog box. You can
change the font Bedit2 uses by making a selection from this dialog box. After
you have made your selection, Bedit2 will resize the screen and refresh the
text using the new font.

Fonts are limited to fixed space bitmap fonts so that the columns will line up
properly and refresh rates will be quick.


ΓòÉΓòÉΓòÉ 4.2. Preferences Save font settings ΓòÉΓòÉΓòÉ

Save font settings allows you to save the current font as the default font
Bedit2 will use.


ΓòÉΓòÉΓòÉ 5. General help ΓòÉΓòÉΓòÉ

Bedit2 is a binary file editor that allows you to insert, delete,
search/replace and perform other editor functions on a file in binary mode. The
display is divided into three sections. On the left is the offset into the file
on 16 byte boundaries, the middle section is a hexadecimal representation of
the data, and the right section contains the ASCII representation of the data.
A cursor is provided in both of the data sections and cursor placement and
marking can be done from either section. Changes to the file can be entered as
HEX values, ASCII text, or integers.

Cursor control is provided through the arrow keys, the Page Up, Page Down,
Home, and End keys, and through the mouse. Placing the mouse pointer on the
desired character and clicking the left mouse button will place the cursor at
that location. Otherwise, you can move the cursor with the keys.

You can enter patterns to insert into the file being edited or you can insert
the contents of another file.

With Bedit2 the size of the file can be changed so care must be used when
working with files, such as executables, that use addresses within the file.


ΓòÉΓòÉΓòÉ 6. Keys help ΓòÉΓòÉΓòÉ

The following is a list of accelerator keys.

 Alt+G
   Goto
 Alt+X
   Exit
 Alt+I
   Insert
 Alt+O
   Overwrite
 Alt+D
   Delete
 Alt+S
   Search
 Alt+R
   Replace
 Enter
   In Mark Mode, the same as clicking the left mouse button


ΓòÉΓòÉΓòÉ 7. Help Menu ΓòÉΓòÉΓòÉ

Use the choices on the Help pull-down to display:

 Help index
      Displays the index of help menu.

 General Help
      Displays an overview of Bedit2's features and how to use them

 Keys Help
      Displays a list of keys usage.

 Using Help
      Provides detailed information on the kinds of help available and how to
      use help.

 Product information
      Displays the Bedit2 copyright information


ΓòÉΓòÉΓòÉ 7.1. Help for menuitem "Help index..." ΓòÉΓòÉΓòÉ

Selecting this menuitem will display a help index.


ΓòÉΓòÉΓòÉ 7.2. Help for menuitem "General help..." ΓòÉΓòÉΓòÉ

Selecting this item displays the general help panel.


ΓòÉΓòÉΓòÉ 7.3. Help for menuitem "Using help..." ΓòÉΓòÉΓòÉ

This menuitme displays the system help panel on how to use help.


ΓòÉΓòÉΓòÉ 7.4. Help for menuitem "Keys help..." ΓòÉΓòÉΓòÉ

This menuitem displays a list of accelerator keys


ΓòÉΓòÉΓòÉ 7.5. Help for "Product information..." ΓòÉΓòÉΓòÉ

This menuitem displays the product information dialog box.


ΓòÉΓòÉΓòÉ 8. File open dialog box ΓòÉΓòÉΓòÉ

Select the file you wish to view from the File: list box or type the name in
the Open filename: entry field.

If the file you want is not in the current directory, you can change the drive
and directory with the Drive: and Directories: list boxes. You can also enter a
fully qualified file name in the Open filename: entry field.


ΓòÉΓòÉΓòÉ 9. Message box help ΓòÉΓòÉΓòÉ

This application demonstrates the use of the Help Manager to provide online
help for an application. Help for both menuitems and message boxes is
demonstrated.