Using the Text Editor

Hpeesofeedit is a general-purpose ASCII text editor capable of editing one file at a time. It enables you to cut and paste, search for text, replace text, and go to a specific line of text. You can access Hpeesofeedit from the Tools menu in the Main window or you can start it from any command shell. The topics described here are:

• Starting the Text Editor Program
• Text File Management
• Editing Text Files
• Performing Search and Replace Operations
• Keyboard Mappings

Starting the Text Editor Program

To start the text editor program:

• Choose File > New > Text Editor in the Main window.
  or
• Type hpeesofeedit in any command shell, and press Return.

The Hpeesofeedit window appears.

The status bar displays warnings, the status of the search/replace operation, and the current line number and character position. The copyright message is displayed in the status bar until you begin typing. The text entry portion of the edit window displays all text you type or paste into the window.

Command Line Options

The Hpeesofeedit program accepts most standard X/Xt command line options. These options are listed in the table below. For more information on these options, refer to your UNIX documentation.

Command Line Options

Option	Argument	Example
-background, -bg	color_name	-bg white
-foreground, -fg	color_name	-fg blue
-display	display_name	-display unix:0
-geometry	geometry string	-geometry 300×400+10+30
-iconic
-xrm	X-resource	-xrm "*background:blue"

To start the Hpeesofeedit program with a command line option:
In any command shell, type hpeesofeedit <desired option> and press Return.

Alternatively, any of these resources can be specified in your resource file using Hpeesofeedit as the class name. Hpeesofeedit is also the resource filename for the program.

Note Any option not preceded by a dash (-) is treated as a filename and the program will attempt to open a file by this name. If a file by this name does not exist, a new file is created.

Text File Management

Basic file operations include creating new files, opening existing files, inserting existing files into other files, and printing and saving files.

Creating a Text File

To crete a new text file:

1. Choose File > New. If there is currently any text in the window, you are prompted Text exists, clear?
   • To avoid clearing the text in the window, click No and then take the desired action.
   • To clear it and start a new file, click Yes.
2. When the window is empty and labeled untitled, type the desired text (You assign a name to the file when you save it.)

Opening an Existing File

To open an existing file:

1. Choose File > Open. If there is currently any text in the window, you are prompted Text exists, clear?
   • To avoid clearing the text in the window, click No and then take the desired action.
   • To clear it and open a file, click Yes, and a dialog box appears.
     The default file filter is an asterisk (*) so all files in the current directory are listed.
2. Select the desired file and click Open. The file appears in the Hpeesofeedit window for editing.

Inserting One Text File into Another

The Insert command enables you to insert a text file, in its entirety, into another text file.

To insert a text file into the currently open file:

1. Select File > Insert. A dialog box appears.
2. Select the desired file and click Insert. The selected file is inserted at the current cursor position in the currently open file.

Saving Text Files

The File menu contains two commands related to saving files: Save and Save As.

• The Save command enables you to save changes to an existing file.
• The Save As command enables you save a new file, and name it in the process, or save an existing file with a new name. For example, if you would like a copy of an existing file so that you can make changes to it while preserving the original, you can use the Save As command to create a copy of the file with another name.

To save an existing file:
Choose File > Save. The file is saved and the number of bytes and path/filename are displayed in the status bar.

To save a new file or to save an existing file with a new name:

1. Choose File > Save As and a dialog box appears.
2. Adjust the path, if desired.
3. Enter a name for the file in the Selection field.
4. Choose Save As. The file is saved.

Printing Text Files

To print a text file:
Choose File > Print. The file is sent to the printer and a status window appears briefly displaying the status of the print request and noting which printer was used.

Note The setting of the environment variable PRINTER determines which printer is used. If this variable is not set, the default printer is used.

Exiting the Text Editor

To exit the program:
Choose File > Quit. If the file has been modified since the last save, you are prompted, File Modified, exit anyway?

• To exit without saving the file, click Yes.
• To cancel so that you can save the file, click No.

Editing Text Files

The Edit menu enables you to copy, cut, paste, and delete text.

To copy text from one location to another:

1. Select the text you want to copy.
2. Choose Edit > Copy. The selected text is copied to the buffer.
3. Position the cursor in the desired location (in any window) and select Paste.

To move text from one location to another:

1. Select the text you want to move.
2. Choose Edit > Cut. The selected text is removed from that location and placed in the buffer.
3. Position the cursor in the desired location (in any window) and select Paste.

To paste text currently being held in the buffer:

1. Position the cursor in the desired location (in any window).
2. Choose Edit > Paste. The contents of the buffer appear at the current cursor location.

To delete text:

1. Select the text you want to delete.
2. Choose Edit > Delete. The selected text disappears.

Performing Search and Replace Operations

The Search menu contains commands to enable you to jump to a specified line number in the text file and to search for and replace specified text strings.

To jump to a specific line number in the file:

1. Choose Search > Go To and a dialog box appears.
2. Type the desired line number and click OK. The cursor jumps to that line number in the file.

To perform the search and replace operation:

1. Choose Search > Search/Replace and a dialog box appears. In the Search String field, type the string of characters you want to search for, including wildcard characters, if desired (If you use wildcard characters, you must check the box labeled Regular Expression.)
   
2. In the Replace String field, type the string of characters you want to use to replace the Search String characters.
   
3. Optionally, check this box if you want to search backward from the current cursor position.
   
4. Optionally, check this box if you want to include wildcard characters in your search.
   

   Note For details on including Regular Expressions in your search, refer to your UNIX documentation.

5. Click Search. If the requested text is found, it is highlighted; if it is not found, a pop-up appears and displays the message String not found.
6. If you want to replace the highlighted occurrence with the contents of the Replace String field, click Replace. The highlighted text is replaced.

   Hint To clear the highlight from text at any time, simply click somewhere inside the text editor window.

7. If you want to replace every occurrence of the specified search string at once, click Replace All. Every occurrence is replaced.
8. When you are through using the Search and Replace function, click Cancel to clear any remaining highlights from text and dismiss the dialog box.

Keyboard Mappings

The text entry area in the editor supports the complete Motif set of keyboard mappings. These mappings are primarily controlled by the XKeysymDB file (or its equivalent), which is typically found in /usr/lib/X11. The table below on Keyboard Mappings describes the mapping of the Sun keyboard (The mappings for the HP platform follows the Sun's mappings with few exceptions.) Note that the Meta keys are labeled differently on different keyboards, but are always the keys on either side of the space bar.

Keyboard Mappings

Keyboard or Mouse Operation	Action
Copy	Copies selected text to the clipboard
Paste	Pastes text from the clipboard to current insertion point
Cut	Cuts selected text to the clipboard
Arrow Keys	Moves the insertion point cursor/scrolls window
Shift Arrow Keys	Moves insertion point, selects text
Page Up/Down	Moves the window up/down by the number of visible lines
Home/End	Moves cursor to beginning/ending of current line
Ctrl Home/End	Moves cursor to first/last visible line in window
Back Space	Deletes text to left of the insertion cursor
Meta Ctrl left arrow	Moves cursor backward one word
Meta Ctrl right arrow	Moves cursor forward one word
Meta Ctrl down arrow	Moves cursor down one paragraph
Meta Ctrl up arrow	Moves cursor up one paragraph
Left mouse button down/move	Selects text range
Shift left mouse button down/move	Extends selected text range