Power GUI Programming with VisualAge C++/powergui.iso/trialva/ibmcppw/help/lpexhelp.hlp

OS/2 Help File | 1996-02-22 | 114.8 KB | 4,100 lines

ΓòÉΓòÉΓòÉ 1. Copyright & Trademarks ΓòÉΓòÉΓòÉ

LPEX (Live Parsing EXtensible editor)

(C) Copyright International Business Machines Corporation 1993, 1995, 1996. All
Rights Reserved.

Note to U.S. Government Users - Documentation related to restricted rights -
Use, duplication or disclosure is subject to restrictions set forth in GSA ADP
Schedule Contract with IBM Corp.

Requests for publications and for technical information about IBM products
should be made to your IBM Authorized Dealer or your IBM Marketing
Representative.

Any reference to an IBM licensed program in this publication is not intended to
state or imply that only IBM's licensed program may be used. Any functionally
equivalent product, program or service that does not infringe any of IBM's
intellectual property rights may be used instead of the IBM product, program,
or service. Evaluation and verification of operation in conjunction with other
products, except those expressly designated by IBM, is the user's
responsibility.

IBM may have patents or pending patent applications covering subject matter in
this document. The furnishing of this document does not give you any license to
these patents. You can send license inquiries, in writing, to the IBM Director
of Licensing, IBM Corporation, 500 Columbus Ave. Thornwood, NY, 10594, USA.

Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independent created
programs and other programs (including this one) and (ii) the mutual use of
information which has been exchanged, should contact IBM Canada Ltd.,
Department 071, 1150 Eglinton Avenue East, North York, Ontario M3C 1H7, Canada.
Such information may be available, subject to appropriate terms and conditions,
including in some cases payment of a fee.

This publication contains examples of data and reports used in daily business
operations.  To illustrate them as completely as possible, the examples include
the names of individuals, companies, bramds, and products. All of these names
are fictitious and any similarity to the names and addresses used by an actual
business is entirely coincidental.

The following terms are trademarks or service marks of IBM Corporation in the
United States or other countries:

 Common User Access
 CUA
 IBM
 Operating System/2
 OS/2
 Personal System/2
 Presentation Manager
 PS/2
 VisualAge
 WorkFrame

 IBM's VisualAge products and services are not associated with or sponsored by
 Visual Edge Software, Ltd..

 Windows is a trademark of Microsoft Corporation.

 Other company, product, and service names, which may be denoted by a double
 asterisk(**), may be trademarks or service marks of others.


ΓòÉΓòÉΓòÉ 2. Reader Comment Form ΓòÉΓòÉΓòÉ

LPEX (Live Parsing EXtensible editor)
Version 1.1

Please use this form only to identify online information errors or to request
changes in this information. Direct any requests for technical questions about
IBM systems, changes in programming support, and so on, to your IBM
representative or to your nearest IBM branch office. You may use this form to
communicate your comments about this information, its organization, or subject
matter.

When you send information to IBM, you grant IBM a non-exclusive right to use or
distribute the information in any ways it feels appropriate without incurring
any obligation to you.

To use this form, print this panel by selecting Print from the Services pop-up
menu in the Help window.  Select This section to have just this form print out.
Mail the completed form to:

IBM Canada Ltd. Laboratory
Information Development
2G/345/1150/TOR
1150 EGLINTON AVENUE EAST
NORTH YORK  ONTARIO  CANADA   M3C 1H7

If your comment does not need a reply (for example, pointing out a typing
error), do not include your name and address below. If your comment is
applicable, we will include it in the next revision of the manual.

If you would like a reply, be sure to print your name and address below.

You can also send your comments by facsimile to [phone] addressed to the
attention of the RCF Coordinator. If you have access, you can send your
comments electronically:

INTERNET, to [e-mail];
IBMLINK, to toribm(torrcf);
IBM/PROFS, to torolab4(torrcf);
IBMMAIL, to ibmmail(caibmwt9).

If you choose to respond through Internet, please include either your entire
Internet network address, or a postal address.

The online help is:
(1=Strongly Agree, 5=Strongly Disagree)

 Clearly organized                     1   2   3   4   5

 Easy to use                           1   2   3   4   5

 Easy to read and understand           1   2   3   4   5

 Complete and technically accurate     1   2   3   4   5

 Written for your technical level      1   2   3   4   5

 Organized for easy reference          1   2   3   4   5

 Your comments:

  (Please indicate which system or feature you are writing about.)

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________

 If you would like a reply, please give your name and address:

  _______________________________________________________

  _______________________________________________________

  _______________________________________________________


ΓòÉΓòÉΓòÉ 3. Using Help ΓòÉΓòÉΓòÉ

How to Get Help for Items in a Window

To get help for any item in the current window, position the cursor on that
item or select it with the mouse, and press the F1 key. Information appears
that describes the item and explains how to use it.

How to Link to Additional Help Information

A highlighted word or phrase in the Help window indicates that additional
information is available about that topic. To view this additional information,
double-click on the word or phrase (or press the Tab key to move the cursor to
it, and press Enter).

How to View Previous Help Texts in the Help Window

To return to the last Help window you viewed, press Esc or select the Previous
push button. Press it again to return to the second-to-last Help window viewed,
and so on.

More about using the Help window...

Press the Esc key to return to the previous window.


ΓòÉΓòÉΓòÉ <hidden> Help Window ΓòÉΓòÉΓòÉ

Use the Help window to view the help. You can also search for specific
information in the help, print it, or copy it to the clipboard.

How to Search for Specific Information

If you need help for a specific item that is not in the current Help window,
use the following pull-down menu choices or push buttons to locate the
information:

Search

Under the Services pull-down menu choice, or select the Search push button.
Searches for occurrences of key words that you specify.

To access the Search function, you must first open a Help window if one is not
already open.

How to Print and Copy the Help

You can print the text in the Help window for future reference, or copy it to
another file and then modify it for other purposes. (The copying function is
particularly useful if you want to copy programming examples in the help for
use in your application.)

First select the help you want, then select from the following choices in the
Services pull-down menu or select the Print push button:

 Print       Prints all or specific sections of the help.

 Copy, Copy to file, Append to file Copies the text from the Help window to
             another source.

 How to Request Help That You Already Viewed

 To return to the last Help window you viewed, either press Esc, select
 Previous from the Options pull-down menu, or select the Previous push button.

 To see a list of all the help windows you previously viewed, select Viewed
 Pages from the Options pull-down menu.

 Press the Esc key to return to the previous window.


ΓòÉΓòÉΓòÉ <hidden> Search ΓòÉΓòÉΓòÉ

To locate a word or phrase in the help, choose one of the following:

 o Select Search from the Services pull-down menu choice of the Help window.
 o Hold down the Ctrl key, and press the S key.
 o Select the Search push button.

 A window appears in which you type in the search string and specify which of
 the following sections of the help should be searched:

 o The current Help window
 o All Help windows for the active program
 o All index entries
 o All help libraries
 o Only the help libraries you marked
 o Only the topics you marked in the table of contents (as explained below).

 Specifying a Search String

 The search function looks for a perfect match to the search string you typed.
 For example, if you specify the string "printing", it will find all
 occurrences of the word "printing", but not the word "print" alone;  if you
 specify the string "print", it will not find the word "printing".

 If you are not sure what your exact search string should be, or if you want to
 find all possible occurrences of it, include an asterisk (*). For example, if
 you want to find occurrences of both "print" and "printing", type "print*".

 Searching the Index

 If you are searching the index entries, you can use the synonyms built into
 them to help you locate the information you want. For example, if an index
 entry print has the synonym spool associated with it, specifying either print
 or spool will return the same entry.

 Searching Selected Topics Only

 To specify a subset of topics to be searched, first select Contents from the
 Options pull-down menu to see the table of contents;  then hold down th Ctrl
 key and select the topics you want to search. When you are done, select Search
 from the Services pull-down menu; then with Marked sections selected, specify
 a string in the Search for field and select Search to perform the search.

 Searching Selected Help Libraries Only

 To search just a subset of help libraries:

 o Select Libraries from the Options pull-down menu to see a list of help
   libraries.
 o Hold down the Ctrl key and select the help libraries you want to search.
 o Select Search from the Services pull-down menu.
 o With Marked libraries selected, specify a string in the Search for field and
   select Search to perform the search.

 Press the Esc key to return to the previous window.


ΓòÉΓòÉΓòÉ <hidden> Print ΓòÉΓòÉΓòÉ

To print text from a Help window, select Print from the Services pull-down menu
or select the Print push button; then select one of the following sections:

 o The Help window currently displayed
 o Only the Help windows you marked in the table of contents
 o All Help windows
 o The list of index entries
 o The help table of contents.

 Printing Selected Topics Only

 To specify a subset of topics to be printed, select Contents from the Options
 pull-down menu to display the table of contents;  then hold down the Ctrl key
 and select the topics you want to print. When you are done, select Print from
 the Services pull-down menu; then select Marked sections to start printing.

 Press the Esc key to return to the previous window.


ΓòÉΓòÉΓòÉ <hidden> Copy, Copy to File, Append to File ΓòÉΓòÉΓòÉ

You can copy the information in a Help window to the clipboard in order to
paste it to another application, or copy it to a temporary file where you can
then edit it to suit your application. (Note that you can copy only the help
from one Help window at a time and you must copy the entire contents of that
window.)

 o To copy it to the clipboard, either:

    - Select Copy from the Services pull-down menu.
    - Hold down the Ctrl key and press Insert.

 o To copy it to a temporary file, either:

    - Select Copy to file from the Services pull-down menu.
    - Hold down the Ctrl key and press F.

 A temporary file called TEXT.TMP is created in your current directory to store
 the copied text.

 The text you are copying to TEXT.TMP replaces any text that was previously
 copied to it. If you want to retain the existing text, append the new text to
 the file instead of copying it. To do this, either:

 o Select Append to file from the Services pull-down menu
 o Hold down the Ctrl key and press A.

 Press the Esc key to return to the previous window.


ΓòÉΓòÉΓòÉ <hidden> Viewed Pages ΓòÉΓòÉΓòÉ

To see a list of the help topics and index entries you have already viewed,
either:

 o Select Viewed pages from the Options pull-down menu.
 o Hold down the Ctrl key and press H.

 If you want to see any topic again, double-click on the associated help topic
 or index entry (or press Tab to move the cursor to it and then press Enter).

 Press the Esc key to return to the previous window.


ΓòÉΓòÉΓòÉ <hidden> Previous ΓòÉΓòÉΓòÉ

To return to the last Help window you viewed, choose one of the following:

 o Press Esc
 o Select Previous from the Options pull-down menu.
 o Select the Previous push button.

 Press the Esc key to return to the previous window.


ΓòÉΓòÉΓòÉ 4. Keys Help ΓòÉΓòÉΓòÉ

Help is provided for the following. Please select the one that is appropriate.

 o Keys for managing windows
 o Keys for the Help window
 o Using Keyboard Mnemonics
 o Keys for text selection and actions
 o Editor window keys


ΓòÉΓòÉΓòÉ 4.1. Managing Windows ΓòÉΓòÉΓòÉ

Where two key names are joined by a plus sign (+), hold down the first key and
press the second.

 F9                 Switch to the Command Log window

 Esc                Cancel a menu or the system menu.

 Ctrl+Esc           Switch to list of active applications.

 Shift+Esc, or      Go to/from system menu.
 Alt+Spacebar

 F10 or Alt         Go to/from menu bar.

 F3                 Close a program window.

 Home               Go to first choice in a menu or move to the beginning of a
                    field.

 End                Go to last choice in a menu or move to the end of a field.

 Arrows             Move between menu bar and menu choices, or within text in a
                    window.

 Spacebar           Select a check box, list item, or push button.

 Alt+Underlined letterSelect associated item on menu bar or menu.

 Alt+F4             Close a window.

 Alt+F10            Maximize a window.

 Alt+F9             Minimize a window.

 Alt+F7             Move a window.

 Alt+F5             Restore a window.

 Alt+F8             Size a window.

 Ctrl+Left          Move to beginning of a field.

 Ctrl+Right         Move to end of a field.

 Tab                Move to next entry field or check box.

 Shift+Tab          Move to previous entry field or check box.

 PgDn               Scroll down one screen page in contents of a window.

 PgUp               Scroll up one screen page in contents of a window.

 Ctrl+PgUp          Scroll left one screen page in contents of a window.

 Ctrl+PgDn          Scroll right one screen page in contents of a window.

 Alt+Tab            Switch to next windowed program.

 Alt+Esc            Switch to next program (including full-screen programs).

 Alt+Shift+Tab      Switch to previous windowed program.

 Press Esc to return to previous panel.


ΓòÉΓòÉΓòÉ 4.2. Selection Keys and Actions ΓòÉΓòÉΓòÉ

Keys and actions you use to select text differ depending on the following:

 o If token highlighting is on, you can select tokens; otherwise, you can
   select character strings (words) delimited by white space or the end-of-line
   (EOL) character.

 o If you have already selected a token, some actions will deselect it and
   select another one. Other actions will expand or contract the selection.

 o If your keyboard is in Insert mode, the cursor will be half of the character
   height.

 o If your keyboard is in Replace mode, the cursor is placed on a character
   (and that character is selected by a block). In Replace mode, selection
   actions may include the character where the cursor is located, as well as a
   selected field which can be a character, a word, or a token.

 The following keys will help you select text in the editor window. Where two
 or more key names are joined by a plus sign (+), hold down the first key and
 press the second, or hold down the first two and press the third.


 Single click,       Move cursor.
 mouse button 1

 Ctrl+Left           Move cursor to start of current or previous token.

 Ctrl+Right          Move cursor to start of next token.


 Click with mouse    Select new text.
 button 1 and drag

 Double click,       Select current word.
 mouse button 1


 Shift+Single Click, Expand or contract the currently
 mouse button 1      selected item to the mouse cursor position.

 Shift+Ctrl+PgUp     Extend selection one screen page to the left.

 Shift+Ctrl+PgDn     Extend selection one screen page to the right.

 Shift+Right         Select or deselect following character.

 Shift+Left          Select or deselect previous character.

 Shift+Ctrl+End      Select or deselect to bottom of file.

 Shift+Down          Select or deselect to column beneath current cursor
                     position.

 Shift+Up            Select or deselect to column above current cursor
                     position.

 Shift+Ctrl+Right    Select or deselect to start of next token.

 Shift+Ctrl+Down     Select or deselect to end of token or word beneath the
                     current cursor position.

 Shift+End           Select or deselect to end of line.

 Shift+Home          Select or deselect to start of line.

 Shift+Ctrl+Left     Select or deselect to start of previous token.

 Shift+Ctrl+Up       Select or deselect to start of token above current cursor
                     position.

 Shift+Ctrl+Home     Select or deselect to top of file.

 Press Esc to return to previous panel.


ΓòÉΓòÉΓòÉ 4.3. Help Window Keys ΓòÉΓòÉΓòÉ

The operations listed below can be performed in any Help window.

Where two key names are joined by a plus sign (+), hold down the first key and
press the second.

 F1              Get help for the currently selected control.

 F1 or Ctrl+H    Get language help for the language keyword at the current
                 cursor position.

 F2              Get extended help (from within any help window).

 F9              Go to a list of keys (from within any help window).

 F11, or         Go to the help index (from within any
 Shift+F1        help window).

 Esc             Cancel current help panel and return to the previous help
                 panel. (Close Help window if no other help panels exist).

 Ctrl+F4         Close the help window.

 Press Esc to return to previous panel.


ΓòÉΓòÉΓòÉ 4.4. Using Keyboard Mnemonics ΓòÉΓòÉΓòÉ

To activate the menu bar in any window, press Alt. Then, use the Right and Left
arrow keys to select an action. Press Enter or the Down arrow key to bring up
the menu of a selected action.

To use shortcut keys to bring up a specific action on the menu bar, press Alt
to go to the menu bar. Then, press the letter on your keyboard that is
underscored for that action to display its menu.

To activate a function in the menu, use the Up and Down arrow keys to select
it, and then press Enter; or press the letter on your keyboard that is
underscored for that function.

Press Esc to return to previous panel.


ΓòÉΓòÉΓòÉ 4.5. Editor Window Keys ΓòÉΓòÉΓòÉ

Warning:  The keys help defines only the default Editor key behaviours, and may
be incorrect if applied to other Editor personalities or customized key
behaviours.

Where two key names are joined by a plus sign (+), hold down the first key and
press the second, or hold down the first two and press the third.

 Alt+Enter           Process prefix area commands.

 Alt+T               Move line with cursor to top focus line of current edit
                     view.

 Ctrl+Home           Move cursor to top of file.

 Ctrl+End            Move cursor to bottom of file

 Ctrl+J              Move cursor to last position.

 End                 Move cursor to end of line.

 Ctrl+Right          Move cursor to start of next word.

 Ctrl+Left           Move cursor to beginning of word or previous word.

 Ctrl+C              Copy selected text to clipboard.

 Ctrl+X              Cut selected text to the clipboard.

 Ctrl+V              Paste text from the clipboard.

 Alt+L               Select a line of text, or extend selected text by
                     additional lines for copying, moving, or deleting (and
                     deselect any text selected from any other edit view).

 Ctrl+T              Select word/token

 Alt+U               Unmark text selected with Alt+L (applies to any edit view
                     of the file).

 Alt+B               Select a block of text.

 Alt+R               Select a rectangular block of text.

 Alt+K               Convert selected text to uppercase.

 Alt+I               Convert selected text to lowercase.

 Alt+C               Copy selected text to the current cursor position.

 Alt+M               Move selected text to the current cursor position.

 Alt+Z               Overlay block.

 Alt+D               Delete block of text (if in the current edit view).

 Ctrl+Shift+Home     Select all text to start of file.

 Ctrl+Shift+End      Select all text to end of file.

 Ctrl+Y              Duplicate line.

 Enter               Split the line at the current cursor position, or insert a
                     new line when at the end of the current line.

 Ctrl+Enter          Create new line without splitting current line and move
                     cursor to new line.

 Alt+S               Split current line at cursor.

 Alt+J               Join next line to current line.

 Ctrl+Delete         Delete to end of line.

 Ctrl+Backspace      Delete entire line.

 Backspace           Delete the character to the left of the cursor.

 Delete              Delete the character to the right of the cursor.

 Ctrl+Z              Undo the last editing change.

 Ctrl+K              Set checkpoint.

 Ctrl+Q              Set quick mark.

 Alt+Q               Find quick mark.

 Ctrl+F              Find text string with the Editor - find and replace
                     window.

 Ctrl+U              Find the previous occurrence of a selected text string.

 Ctrl+D              Find the next occurrence of a selected text string.

 Alt+N               Find the next error.

 Ctrl+O              Open a file for editing.

 Ctrl+S              Save a file.

 Ctrl+I              Display the Include window.

 Ctrl+L              Locate line by line or sequence number. If used when the
                     Line Number window is in focus, focus will be switched
                     back to the Editor window.

 Alt+Right           Go to next view in ring.

 Alt+Left            Go to previous view in ring.

 Ctrl+Alt+Right      Go to next ring.

 Ctrl+Alt+Left       Go to previous ring.

 Ctrl+A              Include all lines of the file into the current edit view.

 Ctrl+Up             Collapse the view so that only commands issued from the
                     command shell are displayed.

 Ctrl+M              Match brackets for C language.

 Ctrl+R              Prototype expansion (template insertion).

 Additional Keys

 o For selecting text
 o For managing windows
 o For the Help window
 o Editor prefix keys.

 Press the Esc key to return to previous panel.


ΓòÉΓòÉΓòÉ 5. Prefix Area Commands ΓòÉΓòÉΓòÉ

The editor allows you to use the prefix commands found in some host editors,
for example, SEU.  Which prefix commands are available depends on which profile
you are using.  When the prefix area is active, you can enter commands from
SEU, XEDIT, and ISPF.  You can also create your own commands by binding any
editor macro or command to your own line commands.

The following table shows the name of the profile associated with each editor:


 Editor          Profile Name

 ISPF            ISPFPRF.LX

 SEU             SEUPRF.LX

 XEDIT           XEDIPRF.LX

See:

 o SEU Commands
 o XEDIT Commands
 o ISPF Commands


ΓòÉΓòÉΓòÉ 5.1. ISPF Commands ΓòÉΓòÉΓòÉ

The following is a list of the ISPF prefix area commands that you can use in
editor. To process them, type the commands that you want over the sequence
numbers in the prefix area, hold down the Alt key, and then press Enter.

 A         Move or copy lines after this line.

 B         Move or copy lines before this line.

 C         Copy this line to the specified target.

 CC        Copy the block of lines between the two CC commands.

 D         Delete this line.

 D n       Delete this and the following n-1 lines.

 DD        Delete all lines between the two DD commands.

 F         Show the first line in an exclude block.

 F n       Show the first n lines in an exclude block.

 I         Insert a blank line after the current line.

 I n       Insert n blank lines after the current line.

 L         Show the last line in an exclude block.

 L n       Show the last n lines in an exclude block.

 LC        Convert the current line to lowercase.

 M         Move a line to the specified target.

 MM        Move all lines between the two MM commands to a specified target.

 O         Overlay this line with the lines defined by the move, copy , or copy
           retain commands.

 OO        Overlay all the lines between the two OO commands with the lines
           defined by the move, copy, or copy retain commands.

 R         Duplicate the current line immediately before the next line.

 R n       Duplicate the current line n times immediately before the next line.

 RR        Duplicate the lines between the two RR commands.

 RR n      Duplicate the lines between the two RR commands n times.

 S         Show all of the significant lines in an exclude group.

 UC        Convert the current line to uppercase.

 X         Exclude this line from the display.

 X n       Exclude this line and the next n-1 lines from the display.

 XX        Exclude all the lines between the two XX commands from the display.

 >         Shift the data in this line one character position to the right.

 > n       Shift. the data in this line n character positions to the right.

 >>        Shift the data between the two >> commands one character position to
           the right.

 >> n      Shift the data between the two >> commands n character positions to
           the right.

 <         Shift the data in this line one character position to the left.

 < n       Shift. the data in this line n character positions to the left

 <<        Shift the data between the two << commands one character position to
           the left.

 << n      Shift the data between the two << commands n character positions to
           the left.

 )         Shift the data in this line one character position to the right.
           Any data that appeared in the last column will be removed.

 ) n       Shift the data in this line n character positions to the right.  Any
           data in the last n columns will be removed.

 ))        Shift the data between the two )) commands one character position to
           the right.  Any data that appeared in the last column will be
           removed.

 )) n      Shift the data between the two )) commands ncharacter positions to
           the right.  Any data in the last n columns will be removed.

 (         Shift the data in this line one character position to the left.  Any
           data that appeared in the first column will be removed.

 ( n       Shift the data in this line n character positions to the left.  Any
           data in the first n columns will be removed.

 ((        Shift the data between the two (( commands one character position to
           the left.  Any data in the first column will be removed.

 (( n      Shift the data between the two (( commands ncharacter positions to
           the left.  Any data in the first n columns will be removed.


ΓòÉΓòÉΓòÉ 5.2. SEU Commands ΓòÉΓòÉΓòÉ

The following is a list of the SEU prefix area commands that you can use in
editor. To process them, type the commands that you want over the sequence
numbers in the prefix area, hold down the Alt key, and then press Enter.

 A         Move or copy lines after this line.

 A n       Move or copy lines after this line and repeat these lines n times.

 B         Move or copy lines before this line.

 B n       Move or copy lines before this line and repeat these lines n times.

 C         Copy this line to the specified target.

 C n       Copy this and the following n-1 lines to the specified target.

 CC        Copy the block of lines between the two CC commands.

 CR        Copy this line to multiple specified targets.

 CR n      Copy this and the following n-1 to multiple specified targets.

 CCR       Copy the block of lines between the two CCR commands to multiple
           specified targets.

 D         Delete this line.

 D n       Delete this and the following n-1 lines.

 DD        Delete all lines between the two DD commands.

 F         When editing RPG, display a format line.

 F?        When editing RPG, Show the Select Format display.  From this display
           choose the format to use.

 I         Insert a blank line after the current line.

 I n       Insert n blank lines after the current line.

 IP        When editing RPG, Insert a blank line and display the line in a
           prompt.

 IS        Insert a line after this line and initialize it to the data saved as
           the skeleton line.

 IS n      Insert n lines after this line and initialize them to the data saved
           as the skeleton line.

 L         Shift the data in this line one character position to the left.

 L n       Shift. the data in this line n character positions to the left.  If
           there is any data in the first n columns, the line will only shift
           up to the start of the data.

 LL        Shift the data between the two LL commands one character position to
           the left.  If there is any data in the first column, the lines will
           shift only up to the start of the data.

 LL n      Shift the data between the two LL commands n character positions to
           the left.  If there is any data in the first n columns, the lines
           will only shift to the start of the data.

 LT        Shift the data in this line one character position to the left.  Any
           data that appeared in the first column will be removed.

 LT n      Shift the data in this line n character positions to the left.  Any
           data in the first n columns will be removed.

 LLT       Shift the data between the two LLT commands one character position
           to the left.  Any data in the first column will be removed.

 LLT n     Shift the data between the two LLT commands n character positions to
           the left.  Any data in the first n columns will be lost.

 M         Move a line to the specified target.

 M n       Move this line and the following n-1 lines to a specified target.

 MM        Move all lines between the two MM commands to a specified target.

 O         Overlay this line with the lines defined by the move, copy , or copy
           retain commands.

 O n       Overlay this line and the following n-1 lines with the lines defined
           by the move, copy, or copy retain commands.

 OO        Overlay all the lines between the two OO commands with the lines
           defined by the move, copy, or copy retain commands.

 P         Display this line in a prompt.

 R         Shift the data in this line one character position to the right.  If
           there is any data in the last column, the line will only shift up to
           the end of the data.

 R n       Shift. the data in this line n character positions to the right.  If
           there is any data in the last n columns, the line will only shift up
           to the end of the data.

 RR        Shift the data between the two RR commands one character position to
           the right.

 RR n      Shift the data between the two RR commands n character positions to
           the right.  If there is any data in the last n columns, the lines
           will only shift to the end of the data.

 RT        Shift the data in this line one character position to the right.
           Any data that appeared in the last column will be removed.

 RT n      Shift the data in this line n character positions to the right.  Any
           data in the last n columns will be lost.

 RRT       Shift the data between the two RRT commands one character position
           to the right.

 RRT n     Shift the data between the two RRT commands n character positions to
           the right.  Any data in the last n columns will be lost.

 RP        Repeat this line once before the next line.

 RP n      Repeat this line n times before the next line.

 RRP       Repeat all lines between the two RRP commands.

 RRP n     Repeat all lines between the two RRP commands n times.

 S         Define this line as a skeleton line.

 SF        Show the first line of the exclude group.

 SF n      Show the first n lines of the exclude group.

 SL        Show the last line of the exclude group.

 SL n      Show the last n lines of the exclude group.

 W         Display the member beginning in column 1.

 W n       Display the member beginning in column n.

 X         Exclude this line from the display.

 X n       Exclude this line and the next n-1 lines from the display.

 XX        Exclude all the lines between the two XX commands from the display.

 +         Roll the member forward one line.

 + n       Roll the member forward n lines.

 -         Roll the member backward one line.

 - n       Roll the member backward n lines.

 n         Type a sequence number to position the line identified by that value
           as the first line on the display.


ΓòÉΓòÉΓòÉ 5.3. XEDIT Commands ΓòÉΓòÉΓòÉ

The following is a list of the XEDIT prefix area commands that you can use in
editor. To process them, type the commands that you want over the sequence
numbers in the prefix area, hold down the Alt key, and then press Enter.

 A         Add a blank line after the current line.

 A n       Move or copy lines after this line and repeat these lines n times.

 C         Copy this line to the specified target.

 CC        Copy the block of lines between the two CC commands.

 D         Delete this line.

 D n       Delete this and the following n-1 lines.

 DD        Delete all lines between the two DD commands.

 F         Copy or move one or more lines to after the current line.

 I         Insert a blank line after the current line.

 I n       Insert n blank lines after the current line.

 M         Move a line to the specified target.

 MM        Move all lines between the two MM commands to a specified target.

 P         Copy or move one or more lines to before the current line.

 S         Show all the hidden lines in an exclude group.

 S*        Show all the hidden lines in an exclude group.

 S n       Show the first n lines in an exclude group.

 S+ n      Show the first n lines in an exclude group.

 S- n      Show the last n lines in an exclude group.

 X         Exclude this line from the display.

 X n       Exclude this line and the next n-1 lines from the display.

 X*        Exclude the lines from the current line to the end of the file from
           the display.

 XX        Exclude all the lines between the two XX commands from the display.

 >         Shift the data in this line one character position to the right.

 > n       Shift. the data in this line n character positions to the right.

 >>        Shift the data between the two >> commands one character position to
           the right.

 >> n      Shift the data between the two >> commands n character positions to
           the right.

 <         Shift the data in this line one character position to the left.

 < n       Shift. the data in this line n character positions to the left

 <<        Shift the data between the two << commands one character position to
           the left.

 << n      Shift the data between the two << commands n character positions to
           the left.

 )         Shift the data in this line one character position to the right.
           Any data that appeared in the last column will be removed.

 ) n       Shift the data in this line n character positions to the right.  Any
           data in the last n columns will be removed.

 ))        Shift the data between the two )) commands one character position to
           the right.  Any data that appeared in the last column will be
           removed.

 )) n      Shift the data between the two )) commands ncharacter positions to
           the right.  Any data in the last n columns will be removed.

 (         Shift the data in this line one character position to the left.  Any
           data that appeared in the first column will be removed.

 ( n       Shift the data in this line n character positions to the left.  Any
           data in the first n columns will be removed.

 ((        Shift the data between the two (( commands one character position to
           the left.  Any data in the first column will be removed.

 (( n      Shift the data between the two (( commands ncharacter positions to
           the left.  Any data in the first n columns will be removed.

 "         Copy this line immediately below itself.

 " n       Copy this line immediately below itself it n times.

 ""        Copy the lines between the two "" commands immediately below itself.

 /         Move the current line to the top of the edit window.


ΓòÉΓòÉΓòÉ 6. Concepts and definitions ΓòÉΓòÉΓòÉ

Click on the plus (+) icon beside this heading in the table of contents, to see
a list of concepts and definitions that provide additional information on an
Editor feature.

To view the information for any entry, double-click on it in the list.

Press Esc to return to the previous panel.


ΓòÉΓòÉΓòÉ 6.1. Clipboard ΓòÉΓòÉΓòÉ

An area of temporary storage provided by the operating system to hold data for
cutting, copying and pasting.

You can place text in the clipboard by selecting the Copy or Cut choices in the
Edit menu of various windows, and can put the contents of the clipboard into a
window at the current cursor position using the Paste choice from the same
menu.

The clipboard can hold only one text string at a time. Any text it contains is
overwritten the next time you use the Cut or Copy choices.

Note

You can copy data (except for graphical data such as bitmaps) from other
applications to the clipboard, and then paste it into a file in the editor
window, or into the command entry area of the Command Log window.

Press the Esc key to return to the previous panel.


ΓòÉΓòÉΓòÉ 6.2. Indent value ΓòÉΓòÉΓòÉ

You can associate an indent value with certain token types in a programming
language to determine how far to the left or to the right of the token the
cursor is placed on a subsequent line when automatic indenting is enabled.
Select Automatic indenting in the Options menu of the editor window to
associate indent values to tokens.

Note:   You can associate indent values to tokens only if the current file is
associated with a language profile that supports automatic indenting. (RPG/400,
for example, does not support automatic indenting.)

Press the Esc key to return to the previous panel.


ΓòÉΓòÉΓòÉ 6.3. Language profile ΓòÉΓòÉΓòÉ

A set of rules that define how a program should be edited and compiled.

Every file you use in your editor session is associated with a language profile
automatically based on its file name, system type, or source type. You can
change how files are associated with language profiles by selecting Associate
from the Options menu.

Your editor session uses the language profile associated with a file to
determine the following information:

 o The programming language of the source program contained in the file.
 o Recognizable tokens of the programming language.
 o The fonts and colors of tokens. You can change this information in the Token
   attributes window, available from the Options pull-down menu.
 o The indent values of tokens. You can change this information in the
   Automatic Indenting window.
 o Tab settings. You can change this information in the Editor Parameters
   window.
 o Functions you set up when you compile files or link object files.

 Default profiles are used for files that are not associated with a language
 profile.

 Press the Esc key to return to the previous panel.


ΓòÉΓòÉΓòÉ 6.4. Language sensitive editing ΓòÉΓòÉΓòÉ

A set of editing functions, that take into account the programming language,
syntax, and environment of source programs while they are being edited.

Language sensitive editing features available within your CODE session include:

 o Token highlighting (to see the structure of programs more easily)

 o Automatic indenting (to move the cursor to the right place on the next line
   more often)

 o Format line display (to help you edit column-sensitive programming
   languages)

 o Language sensitive help (to give you immediate access to online language
   reference help on command syntax, parameter descriptions, usage notes, and
   programming examples).

 Press the Esc key to return to the previous panel.


ΓòÉΓòÉΓòÉ 6.5. Prefix area ΓòÉΓòÉΓòÉ

A distinct area, on the left side of an editor window, that displays sequence
numbers and the date. These numbers are maintained by your editor session.

Press the Esc key to return to the previous panel.


ΓòÉΓòÉΓòÉ 6.6. Source type ΓòÉΓòÉΓòÉ

An attribute of source files that you can define to describe their contents.

Source types may include the following:

 <All files>   Includes all files

 C code        Files you have defined to have an extension of *.C.

 COBOL code    Files you have defined to have an extension of *.CBL.

 PL/I CODE     Files you have defined to have an extension of *.PLI.

 To add or delete source types recognized by the editor, use the Source Types
 window that is accessed by selecting Source types from the Options menu in the
 Editor window.

 Press the Esc key to return to the previous panel.


ΓòÉΓòÉΓòÉ 6.7. Token ΓòÉΓòÉΓòÉ

A string of one or more characters or symbols in a specific format that has
some defined significance in a programming language and can be considered as a
single, logical entity by the compiler.

Some types of typical tokens are:

 o Identifiers
 o Keywords
 o Constants
 o Operators
 o Delimiters
 o Comments.

 Examples

 o In the C statement,

      X = TEMP + 1;

   the following are tokens:

      X    TEMP    1
      =     +      ;

 o In the COBOL statement,

      ADD TEMP 1 GIVING X.

   the following are tokens:

      ADD      1       X
      TEMP   GIVING    .

 o In RPG specification lines, each field is a separate token.

 Press the Esc key to return to the previous panel.


ΓòÉΓòÉΓòÉ 6.8. Token highlighting ΓòÉΓòÉΓòÉ

A function you can select under Language editing in the Options menu, that
allows you to view the token types of the programming language you are using in
different colors and fonts.

Press the Esc key to return to the previous panel.


ΓòÉΓòÉΓòÉ 6.9. View ΓòÉΓòÉΓòÉ

A view of a file in an editor window. You can use this function to display
several views of a file at the same time.  Each edit view of a file is listed
as a separate window in the File List window, available from the Windows
pull-down menu. Changes made in one edit view are reflected in all other open
edit views of a file.

You may want to create several edit views of a file to view different parts of
a file for comparing or editing text.

Press the Esc key to return to the previous panel.


ΓòÉΓòÉΓòÉ <hidden> Editor window ΓòÉΓòÉΓòÉ

Use this window to create, edit, or browse a file.

You can edit or browse programs that reside on your workstation, using
language-sensitive editing features.

Information on the following topics is also available:

 o Editor commands and parameters
 o Keyboard functions

 Menu Bar Summary

 File          Lets you open (or get) a file to edit it, browse it, save it,
               view or change its properties, or open additional views of it.

               Also, lets you exit from the editor.

 Edit          Lets you change, move, copy, or mark text in a file.

 View          Lets you specify lines to be included in the view, select and
               refresh format lines, and set the format line, message line,
               status line, prefix area, and the wrap features on or off.

 Actions       Lets you issue edit commands.

 Options       Lets you customize your editor environment and set options for
               editing.

 Windows       Lets you manage your Editor windows.

 Help          Displays help information.


ΓòÉΓòÉΓòÉ 7. More Editor Information ΓòÉΓòÉΓòÉ

Information on the following is also available.

 o Editor Commands and Parameters
 o Editor How Do I...  (Task Help)
 o Editor Command Line Invocation Reference


ΓòÉΓòÉΓòÉ <hidden> File ΓòÉΓòÉΓòÉ

Select this action to work with files.  You can open and save files, view their
properties, and create more than one view of a file.


ΓòÉΓòÉΓòÉ <hidden> New ΓòÉΓòÉΓòÉ

Select this menu choice to open a new, empty Editor window and to associate a
language profile to the new file. To save the text to a file, select Save or
Save as.


ΓòÉΓòÉΓòÉ <hidden> Open for edit ΓòÉΓòÉΓòÉ

Select this menu choice to display the Open window. This window lets you select
an existing file to load into the Editor for editing.

Note:   The Editor will not try to open a file that is already loaded in the
Editor.


ΓòÉΓòÉΓòÉ <hidden> Open for browse ΓòÉΓòÉΓòÉ

Selecting this menu choice displays the Select window. This window lets you
select an existing file to load into the Editor for browsing.

You can not make editing changes to the file.


ΓòÉΓòÉΓòÉ <hidden> Open new view ΓòÉΓòÉΓòÉ

Select this menu choice to open another Editor window for the current file so
that you can work on several parts of the same file at once.

You may want to use several views of a file to:

 o Edit several parts (using Cut, Copy, and Paste)

 o Compare similar sections to find programming errors.


ΓòÉΓòÉΓòÉ <hidden> Split window ΓòÉΓòÉΓòÉ

Select this menu choice to create a new view of the current document in a new
editing window.  The Editor window is split to accomodate both the new editing
window and any previously-existing editing windows.

The Editor window can be split to hold multiple editing window panes, arranged
either vertically or horizontally. Editing window panes inside a split Editor
window can be resized by dragging selecting and dragging the common border
between an adjacent pair of panes.


ΓòÉΓòÉΓòÉ <hidden> Get file ΓòÉΓòÉΓòÉ

Selecting this menu choice opens the Get window. This window lets you select a
file for insertion into the current document in the Editor.  The document is
inserted at the begining of the line below the current cursor position.

Note:   The Get operation will not load any new profiles along with the file
being inserted.  Profiles already loaded remain in effect and are applied to
the file being inserted.


ΓòÉΓòÉΓòÉ <hidden> Save ΓòÉΓòÉΓòÉ

Select this menu choice to save the current file, including any changes you
have made to it. It remains displayed in the Editor window.

When you save a new file for the first time, you are prompted to give it a name
and specify where you want it to be stored.


ΓòÉΓòÉΓòÉ <hidden> Save as ΓòÉΓòÉΓòÉ

Selecting this menu choice displays the Save as window. This window lets you
specify a file name under which to save the document in the current editing
window.

This window appears whenever you save an unnamed file.

You can also use this window to save an already-named file under a new file
name. You can edit the newly named file in the current Editor window. The
original file is preserved as it was when you last saved it.

You can also use this choice to save a new file that has not yet been named.


ΓòÉΓòÉΓòÉ <hidden> Save all ΓòÉΓòÉΓòÉ

Select this menu choice to save all modified documents open in the Editor.

Files already named are saved under their current name.

For each new, unnamed document open in the Editor, the Save as window appears
prompting you to enter a valid file name.  The document is saved under this
name.


ΓòÉΓòÉΓòÉ <hidden> Properties ΓòÉΓòÉΓòÉ

Select this menu choice to view information about the current file, such as its
fully qualified name and the time of its last modification. You can also view
and change information such as the default source type and subject of a file.


ΓòÉΓòÉΓòÉ <hidden> Close view ΓòÉΓòÉΓòÉ

Select this menu choice to close the current document view.  If this view is
the last view of a given document open in the Editor, the Editor warns you of
unsaved changes and gives you an opportunity to save them.


ΓòÉΓòÉΓòÉ <hidden> Close ring ΓòÉΓòÉΓòÉ

Select this menu choice to close all document views in the current ring.

Documents that do not also have one or more views open in other rings are
closed.  The Editor warns you of unsaved changes to documents and give you an
opportunity to save them.

If the ring being closed is the last ring open in the Editor, the Editor also
closes.


ΓòÉΓòÉΓòÉ <hidden> Exit ΓòÉΓòÉΓòÉ

Select this menu choice to close the Editor and all documents open in the
Editor.  The Editor warns you of unsaved changes to documents and gives you an
opportunity to save them.


ΓòÉΓòÉΓòÉ <hidden> Edit ΓòÉΓòÉΓòÉ

Select this action to select text editing features.


ΓòÉΓòÉΓòÉ <hidden> Undo ΓòÉΓòÉΓòÉ

Select this menu choice to undo the last set of changes made to the current
file.

The number of sets of changes that can be undone is determined by the value of
the history parameter. See history Parameter in the Editor Command Reference
for more information on setting and querying the history parameter.

When no more changes can be undone (that is, when the number of checkpoints
specified by the history parameter is reached), selecting Undo cancels the
previous undo. Further selecting of Undo eventually returns the file to the
state it was in before Undo was first selected.


ΓòÉΓòÉΓòÉ <hidden> Set checkpoint ΓòÉΓòÉΓòÉ

Select this menu choice to record the changes made to a file since the last
checkpoint was taken.

The maximum number of checkpoints that the Editor can store is determined by
the value of the history parameter.  Checkpoints are stored on a first in,
first out basis.  Older checkpoints are discarded as new checkpoints are set.
See history Parameter in the Editor Command Reference for more information on
setting and querying the history parameter.


ΓòÉΓòÉΓòÉ <hidden> Cut ΓòÉΓòÉΓòÉ

Select this menu choice to delete selected text from the Editor window and copy
it to the clipboard. You can then move this text elsewhere in the file by using
Paste.

Note:   You cannot copy rectangular blocks to the clipboard - only character
and line blocks.


ΓòÉΓòÉΓòÉ <hidden> Copy ΓòÉΓòÉΓòÉ

Select this menu choice to copy selected text in the Editor window to the
clipboard. The text in the window is left selected and unchanged.

Note:   You cannot copy rectangular blocks to the clipboard - only character
and line blocks.


ΓòÉΓòÉΓòÉ <hidden> Paste ΓòÉΓòÉΓòÉ

Select this menu choice to insert the text currently in the clipboard at the
current cursor position in the Editor window.

Notes

 o You cannot use this choice when there is no text in the clipboard

 o If you paste text into a file that has a record length shorter than that of
   the text in the clipboard, the text may be truncated when you save the file
   back to its host. You will be warned that the file's record length has been
   exceeded in such a case.


ΓòÉΓòÉΓòÉ <hidden> Find and replace... ΓòÉΓòÉΓòÉ

Select this menu choice to have a window appear which allows you to define and
locate a string of text and, if you want, change it to something else.


ΓòÉΓòÉΓòÉ <hidden> Find next ΓòÉΓòÉΓòÉ

Select this menu choice to find the next occurrence (after the current cursor
position) of a search item previously defined in the Find and replace window.


ΓòÉΓòÉΓòÉ <hidden> Find up ΓòÉΓòÉΓòÉ

Select this menu choice to find the previous occurrence (before the current
cursor position) of a search item previously defined in the Find and replace
window.


ΓòÉΓòÉΓòÉ <hidden> Find selection ΓòÉΓòÉΓòÉ

Select this menu choice to find the character string currently selected in the
Editor window. This character string becomes the new search string in the Find
window.

Note:   If you select more than one line, the editor uses only the text from
the first line.


ΓòÉΓòÉΓòÉ <hidden> Select all ΓòÉΓòÉΓòÉ

Select this menu choice to select all the text in the Editor window.


ΓòÉΓòÉΓòÉ <hidden> Deselect all ΓòÉΓòÉΓòÉ

Select this menu choice to deselect all text currently selected in the Editor
window.


ΓòÉΓòÉΓòÉ <hidden> Block ΓòÉΓòÉΓòÉ

Select this menu choice to mark and unmark blocks of text; copy, overlay, move,
or delete them; or convert all their characters to upper or lower case.

Cascaded menu summary

 Mark line   Marks the line the cursor is on, or if a line is already marked
             extends the selection from the marked line to the current line.

 Mark character Marks all text in the file from where you first select this
             choice, to where you select it a second time.

 Mark rectangle Marks all text in a rectangle from where you first select this
             choice, to where you select it a second time. Note: this choice is
             not available if Wrap from the View menu has been selected.

 Unmark      Clears any currently marked block.

 Copy        Copies the marked text to the cursor position, without erasing it
             from its original place. (To copy a block, mark it in an Editor
             window and move the text cursor to where you want to put it before
             selecting this choice.)

 Overlay     Copies the marked text to the cursor position, overlaying the new
             text over the original text rather than inserting it.

 Move        Moves the currently marked block to the current cursor position,
             thereby erasing it from where it was before. (To move a block,
             mark it in an Editor window and move the text cursor to where you
             want to put it before selecting this choice.)

 Delete      Erases the currently marked block from the current file. Any
             remaining text moves up to fill the gap created.

 Upper case  Converts all characters in the currently marked block to upper
             case.

 Lower case  Converts all characters in the currently marked block to lower
             case.


ΓòÉΓòÉΓòÉ <hidden> Locate ΓòÉΓòÉΓòÉ

Select this menu choice to locate errors; line or sequence numbers; or text.

Cascaded menu summary

 Next error  Finds the next error in the current file, and displays its error
             message in the error list window. (If you excluded error messages
             in the error list, their corresponding errors are ignored if you
             select this choice. However, if you hid any messages, their
             corresponding errors are located by this choice.)

 Line        Displays a window to let you specify the line or sequence number
             you want the cursor positioned at.

 Date        Displays a window to let you specify the date you wish to locate.

 Start of block Moves the cursor to the first character of a marked block.

 End of block Moves the cursor to the last character of a marked block.

 Previous location Locates the last cursor position where text was entered.

 Quick mark  Moves the cursor to the place in the text where you set a quick
             mark.

 Mark        Lets you find a place in the text where you named a mark. A window
             appears listing all marks you set in the text, allowing you to
             select a specific mark.


ΓòÉΓòÉΓòÉ <hidden> Set quick mark ΓòÉΓòÉΓòÉ

Select this menu choice to place a quick mark at the current cursor position.

You can later use the quick mark to return to the current cursor position when
you select Quick mark from the Locate cascaded menu under Edit.

Since you can use one quick mark at a time, any previous quick mark you set is
lost if you select this choice.

Quick marks are not saved with files.


ΓòÉΓòÉΓòÉ <hidden> Name a mark ΓòÉΓòÉΓòÉ

Select this menu choice to name a mark at the current cursor position. (You can
type the name into a window that appears.)

You can later use the mark to return to the current cursor position by
selecting Mark from the Locate cascaded menu under Edit, and typing the name
into the window provided.

Marks are not saved with files.


ΓòÉΓòÉΓòÉ <hidden> View ΓòÉΓòÉΓòÉ

Select this choice to change the contents of the Editor window or how it is
displayed.


ΓòÉΓòÉΓòÉ <hidden> Include ΓòÉΓòÉΓòÉ

Select this menu choice to display in the Editor window only those lines
containing a specified character string.


ΓòÉΓòÉΓòÉ <hidden> Include date ΓòÉΓòÉΓòÉ

Select this menu choice to display in the Editor window only those lines with
dates meeting a given description.


ΓòÉΓòÉΓòÉ <hidden> Include all ΓòÉΓòÉΓòÉ

Select this menu choice to display all lines of the file in the Editor window.


ΓòÉΓòÉΓòÉ <hidden> Format line ΓòÉΓòÉΓòÉ

Select this menu choice to view a format line at the top of the Editor window.
This line provides information to help you edit lines in a file.

Note:   The ruler does not wrap when wrapping is turned on.


ΓòÉΓòÉΓòÉ <hidden> Message line ΓòÉΓòÉΓòÉ

Select this menu choice to view the message line at the bottom of the Editor
window.

The message line displays different information depending on the state of the
editor.


ΓòÉΓòÉΓòÉ <hidden> Status line ΓòÉΓòÉΓòÉ

Select this menu choice to view the status line at the top of the Editor
window.

The status line displays status information such as the line and column of the
cursor position, how many changes have been made, and whether the editor is in
replace or insert mode.


ΓòÉΓòÉΓòÉ <hidden> Sequence numbers ΓòÉΓòÉΓòÉ

Select this menu choice if you want sequence numbers to be displayed in the
prefix area of the Editor window.

In order for sequence numbers to be displayed, you must select to maintain them
at the time that you create a new file or open an existing file that uses them.
Use the New, Open for browse or Open for edit choices in the File menu.


ΓòÉΓòÉΓòÉ <hidden> Date area ΓòÉΓòÉΓòÉ

Select this menu choice if you want the date displayed in the prefix area of
the Editor window.

Note:  In order to use this feature, you must select Maintain sequence numbers
in the Select File window, when you open the file.


ΓòÉΓòÉΓòÉ <hidden> Ring ΓòÉΓòÉΓòÉ

Select this menu choice to perform ring manipulation operations.  A cascade
menu will appear with the following choices:

 Single window   Select this choice to transfer all open documents back into
                 the current ring.  All other rings will be closed.

 New ring        This choice will move the current document into a newly
                 created ring.  A new Editor window will open to accomodate the
                 new ring.

                 If the current document is the only document open in its
                 original ring, a view of that document will also remain in the
                 original ring.  Otherwise, its place in the Editor window of
                 the original ring will be taken by another document residing
                 in that original ring.

 All new rings   Each document open in the Editor will be placed in its own
                 ring.  A separate Editor window will be created for each ring
                 and its document.

 Split ring      This choice will move the current document into a newly
                 created ring.  This new ring and its editing window will share
                 the current Editor window with any other editing windows
                 already open in the Editor window.

                 If the current document is the only document open in its
                 original ring, a view of that document will also remain in the
                 original ring.  Otherwise, its place in the editing window of
                 the original ring will be taken by another document residing
                 in that original ring.

 Configure rings... The choice will let you move documents from their current
                 ring to another ring.

 Default to ring Check this option if you want newly created or opened
                 documents to join the current ring.  If this option is not
                 checked, each new document opened or created will become a
                 member of its own newly created ring.

 Ring selector   Check this option if you want each ring to display its own
                 pulldown document selection list.  The selection list shows
                 the names of all documents open in a given ring.  You can go
                 directly to a document by clicking on an entry in the
                 selection list.


ΓòÉΓòÉΓòÉ <hidden> Split orientation ΓòÉΓòÉΓòÉ

Select this menu choice to change the way the Editor window is split for
multiple editing windows.

Choosing Horizontal causes the Editor window to be split horizontally.  The
borders between editing windows run horizontally across the width of the Editor
window.

Choosing Vertical causes the Editor window to be split vertically.  The borders
between editing windows run vertically within the Editor window.

Changes to your split orientation are reflected immediately in the Editor
window if you are already in split window editing mode.  If you are not, the
new orientation will apply each time you later split an Editor window.


ΓòÉΓòÉΓòÉ <hidden> Wrap ΓòÉΓòÉΓòÉ

Select this menu choice if you want to view long lines of text without having
to scroll horizontally.

Note:

  1. The ruler will not wrap when wrapping is turned on.

  2. Selecting this menu choice will cause the formatter and wrap parameters to
     be set on, and the formwidth parameter to be set to 0, regardless of
     previous state.

  3. Deselecting this menu choice will cause the formatter and wrap parameters
     to be set off, regardless of previous state.  The formwidth parameter is
     not changed, and remains with a value of 0.


ΓòÉΓòÉΓòÉ <hidden> Single window ΓòÉΓòÉΓòÉ

Select this menu choice to collapse all of the views belonging to the current
Editor instance, into a single window.


ΓòÉΓòÉΓòÉ <hidden> Toolbar ΓòÉΓòÉΓòÉ

Select this menu choice to modify the display characteristics of the toolbar.
A cascade menu will appear, from which you can choose how, or if, you want the
toolbar to appear at the top of the current Editor window.


ΓòÉΓòÉΓòÉ <hidden> Commands ΓòÉΓòÉΓòÉ

Select this menu choice to show only those commands that have been issued in
the command shell.


ΓòÉΓòÉΓòÉ <hidden> RPG Filters ΓòÉΓòÉΓòÉ

It is possible to limit the lines displayed to those belonging to one of the
categories listed below. To do this select the category you wish.

 Control     Displays all RPG specifications such as IFEQ, GOTO, CALL, EXSR,
             SELECT (SELEC for OPM RPG), and CAB that affect the flow of
             control in your program.

 Comments    Displays all RPG specifications that contain a comment.

 Subroutines Displays all RPG specifications that contain the BEGSR and ENDSR
             opcodes.

 SQL         Displays all SQL statements.

 Procedures (does not apply to OPM RPG) Displays all procedure specifications,
             that is, those with a P in position 6.


ΓòÉΓòÉΓòÉ <hidden> COBOL Filters ΓòÉΓòÉΓòÉ

It is possible to limit the lines displayed to those belonging to one of the
categories listed below. To do this select the category you wish.

 Comments    Displays all COBOL comment lines.

 Divisions   Displays all lines containing the keywords DIVISION or SECTION.

 Outline     Displays all lines which start in Area A. This will show the
             outline of the COBOL program.

 SQL         Displays all SQL statements.


ΓòÉΓòÉΓòÉ <hidden> COBOL (MVS & VM) Filters ΓòÉΓòÉΓòÉ

It is possible to limit the lines displayed to those belonging to one of the
categories listed below. To do this select the category you wish.

 Comments    Displays all COBOL comment lines.

 Divisions   Displays all lines containing the keywords, DIVISION or SECTION.

 Outline     Displays all lines which start in Area A. This will show the
             outline of the COBOL program.

 SQL&CICS    Displays all SQL & CICS statements.


ΓòÉΓòÉΓòÉ <hidden> C Filters ΓòÉΓòÉΓòÉ

It is possible to limit the lines displayed to those belonging to one of the
categories listed below. To do this select the category you wish.

 Functions     Displays all function definition headers.

 Outline logic Displays a logic outline of the code.  This consists of all
               function definition headers, lines that contain braces, switch
               statements, case and default clauses.

 Errors        Displays all lines that contain lexical errors.


ΓòÉΓòÉΓòÉ <hidden> CL Filters ΓòÉΓòÉΓòÉ

It is possible to limit the lines displayed to those belonging to one of the
categories listed below. To do this select the category you wish.

 Control       Displays all CL statements such as CALL, RETURN, TFRCTL, IF, DO
               and GOTO that affect the flow of control in your CL program.

 Comments      Displays all CL statements which contain comments.

 SQL           Displays all SQL statements.


ΓòÉΓòÉΓòÉ <hidden> PL/I Filters ΓòÉΓòÉΓòÉ

It is possible to limit the lines displayed to those belonging to one of the
categories listed below. To do this select the category you wish.

 All           Displays all PL/I lines in the file.  This is the same as
               Include all (or Ctrl+A), except All causes checking and
               unchecking of the current View selection.

 Errors        Displays only those PL/I lines which are in error.

 Procedures    Displays all lines that contain PL/I procedure keywords or
               procedure labels.

 Outline logic (flow) Displays all lines that contain PL/I control-flow
               language (for example, GOTO).

 Compress spaces Eliminates all blank lines from the current view of a PL/I
               file.

 Comments      Displays all PL/I statements which contain comments. This
               includes both comment lines and lines which contain both code
               and comments.

 Block comments only Displays all PL/I statements which contain comments. This
               includes only comment lines.

 Preprocessor only Displays all PL/I statements which contain preprocessor
               language (for example, %statements).

 Includes      Displays all PL/I statements which contain the INCLUDE keyword.

 Extensions    Displays all PL/I statements which contain keywords outside of
               the current setting of the LANGLVL setting.

 SQL/CICS      Displays all PL/I statements which contain SQL or CICS
               statements (for example, EXEC).


ΓòÉΓòÉΓòÉ <hidden> Actions ΓòÉΓòÉΓòÉ

Use can use this menu to issue edit commands, use the keystroke recorder or
possibly take other actions.


ΓòÉΓòÉΓòÉ <hidden> Issue edit command ΓòÉΓòÉΓòÉ

Select this menu choice to issue an editor command.

A window appears displaying recently used editor commands (if any).  You can
reuse one of these commands, or type a new command.


ΓòÉΓòÉΓòÉ <hidden> Keystroke recorder ΓòÉΓòÉΓòÉ

The keystroke recorder records keystroke input to the RECORD.LX macro file.
This file is found in the directory pointed to by the TMP environment variable.

Menu operations for the recorder are:

 Start          Turns the recorder on, creating a new RECORD.LX macro file in
                which to store keystrokes.

 Halt           Turns the recorder off.

 Playback       Plays the recorded macro back into the Editor.

 Continue recording Turns the recorder on again, appending recorded keystrokes
                at the end of the existing RECORD.LX macro file.

 Load recorder macro file Loads the RECORD.LX file into the Editor for editing.

 For more information, see Keystroke Recorder Overview.


ΓòÉΓòÉΓòÉ <hidden> Keystroke Recorder Overview ΓòÉΓòÉΓòÉ

The keystroke recorder records keystroke input for the current document.
Recorded keystrokes can be played back repeatedly as long as the Editor remains
open.  The recorder is useful for recording sequences of keystrokes that are
frequently reused.

Recorded keystrokes are written to an Editor macro file in a form corresponding
to the equivalent Editor command needed to carry out that action.  This macro
file can be edited directly by the user, which is useful if you want to write
your own editor macros but are unsure of what commands you need to use for
specific editor actions.

Note:

 o Keystroke recorder output is written into the RECORD.LX macro file.  This
   macro file is found in the directory pointed to by the TMP environment
   variable.  The file should be renamed if you want to keep it for later use
   because a subsequent recorder session will overwrite it.

   Renamed and modified macro files should be saved to the basepath\macros
   directory, where they can be found by the macro command.

 o Mouse actions and menu choices are not recorded, nor are paging keys (i.e.,
   Page Up/Down) or any other keys that do not directly affect the area of the
   window which displays the document.


ΓòÉΓòÉΓòÉ <hidden> Stop command ΓòÉΓòÉΓòÉ

Select this menu choice to terminate the current operating system shell
command.


ΓòÉΓòÉΓòÉ <hidden> Options ΓòÉΓòÉΓòÉ

Select this action to customize your editing environment.


ΓòÉΓòÉΓòÉ <hidden> Action keys ΓòÉΓòÉΓòÉ

Select this menu choice to display a scrollable list of the actions assigned to
keys, combinations of keys and mouse buttons, and to change an assigned action.

Keys to which actions have been assigned are Ctrl key combinations, Alt key
combinations and Function keys. The assigned actions are editor commands.


ΓòÉΓòÉΓòÉ <hidden> Automatic indenting ΓòÉΓòÉΓòÉ

Select this menu choice to set the indent values for each programming language
token, and to save them in the current language profile.

To activate automatic indenting after you set features in this window, select
Automatic indenting beneath Language editing in the Options menu.


ΓòÉΓòÉΓòÉ <hidden> Command retrieval ΓòÉΓòÉΓòÉ

Select this menu choice to set the maximum number of retrievable commands, and
which commands are retrievable. A window appears enabling you to enter your
choices for these options.


ΓòÉΓòÉΓòÉ <hidden> Editor parameters ΓòÉΓòÉΓòÉ

Select this menu choice to query and set command parameters.

A window appears listing all the commands which can be queried or set.


ΓòÉΓòÉΓòÉ <hidden> Font ΓòÉΓòÉΓòÉ

Select this menu choice to change the basic font used by the Editor.


ΓòÉΓòÉΓòÉ <hidden> Token attributes ΓòÉΓòÉΓòÉ

Select this menu choice to customize display characteristics of the tokens
defined for the current document type.


ΓòÉΓòÉΓòÉ <hidden> Global variables ΓòÉΓòÉΓòÉ

Select this menu choice to view, change, and set global variables. A window
appears listing each name together with its current value, and enabling you to
change an existing variable or set a new one.


ΓòÉΓòÉΓòÉ <hidden> Language editing ΓòÉΓòÉΓòÉ

Select this menu choice to set options and features described in the language
profile. for editing files.

Note:   The programming language specified by the language profile associated
with the file you are currently editing determines which of these features are
available.

When selected, this choice provides a cascaded menu. You can select or deselect
any or all of the following cascaded menu choices to enable or disable the
features.

Cascaded menu Summary

 Token highlighting Provides highlighting of tokens to let you use
             language-editing features.

 Automatic indenting Provides automatic indenting for the file in the Editor
             window.

 Lexical errors Lets you enable or disable lexical error logging.


ΓòÉΓòÉΓòÉ <hidden> Token highlighting ΓòÉΓòÉΓòÉ

Select this menu choice to enable token highlighting, which is required if you
want to use language-editing features. You can change how each token type is
displayed in the Fonts/Colors window by selecting Fonts/Colors in the Options
menu.

Note:   You may want to disable token highlighting for faster editing and
loading of files.


ΓòÉΓòÉΓòÉ <hidden> Lexical errors ΓòÉΓòÉΓòÉ

Select this menu choice to enable or disable the logging of lexical errors.  By
default this choice is checked and lexical errors are logged.


ΓòÉΓòÉΓòÉ <hidden> Automatic indenting ΓòÉΓòÉΓòÉ

Select this menu choice to enable automatic indenting. Lines following a
recognized token are indented by the value chosen in the Indent value field of
the Automatic Indenting window accessible from Automatic indenting in the
Options menu.


ΓòÉΓòÉΓòÉ <hidden> Auto uppercasing ΓòÉΓòÉΓòÉ

Select this menu choice to have all RPG elements that require to be in
uppercase converted to uppercase.


ΓòÉΓòÉΓòÉ <hidden> Source types ΓòÉΓòÉΓòÉ

Select this menu choice to add or delete source types associated with files.


ΓòÉΓòÉΓòÉ <hidden> Synonyms ΓòÉΓòÉΓòÉ

Select this menu choice to display, set or change synonyms.

The window that appears lists each currently set synonym together with the
minimum number of characters which must be entered and its editor command. The
window also enables you to change a current synonym or add a new one.


ΓòÉΓòÉΓòÉ <hidden> Key behaviours ΓòÉΓòÉΓòÉ

Select this menu choice to define the behaviour of certain keyboard keys in
Editor, for example, the Enter, Delete, and Backspace keys.  You can select one
of the existing editor personalities with which you might already be familiar,
such as EPM or SEU, or define your own by selecting the Customize... choice.
These settings will only affect the current Editor session.  To make the
customization permanent select the Save key behaviour choice.

Warning:  The keys help defines only the default Editor key behaviours, and may
be incorrect if applied to other Editor personalities or customized key
behaviours.


ΓòÉΓòÉΓòÉ <hidden> Profiles ΓòÉΓòÉΓòÉ

Select this menu choice to open an edit window on the selected profile. The
Editor startup profile is executed when an editor session is started and before
any documents are open.  The File load profile is executed whenever a file is
loaded into the editor. Language load: X files are executed whenever a file is
opened with the X language profile (for example, a C file would execute the C
language load file). The User preferences file is the profile used for
customizing the editor after all other profiles have executed.

Note:   The order in which the profiles appear on the cascade menu indicates
the order in which the profiles were executed, for example, Editor startup is
always executed first and User preferences is always executed last.

If you have created your own LXU profiles, they will also appear on this menu.
They are always executed immediately after the profile to which they
correspond, for example, C.LXU will be executed after the C language profile,
if the document being opened has a filename extension of C.

Selecting All active opens an Editor window for each of the profiles listed on
the menu.

Once you have opened a profile, you are able to view and edit it. The View menu
shows a list of SET/QUERY editor parameters that can be used to filter out all
other statments in the profile. This feature is useful for quickly locating,
for example, all the FONT settings in the profile, making it easy to examine
and change them.

If you are not sure how to enter a particular setting, you can use the
"Prototye" feature. Type the word "set" on any line and then press Ctrl-R. Then
type one of the set members and press Ctrl-R again. Now simply replace any ?s
with your setting.


ΓòÉΓòÉΓòÉ <hidden> Automatic scrolling ΓòÉΓòÉΓòÉ

Select this menu choice to change the mode used to log text in the document.
If automatic scrolling is on, then the document will always scroll to the
bottom when something new is logged.


ΓòÉΓòÉΓòÉ <hidden> Undo ΓòÉΓòÉΓòÉ

Select this menu choice to enable or disable the undo function, set manual or
automatic checkpointing, or change the maximum number of checkpoints saved by
the Editor.


ΓòÉΓòÉΓòÉ <hidden> Windows ΓòÉΓòÉΓòÉ

Select this action to manage your Editor windows.


ΓòÉΓòÉΓòÉ <hidden> Macro log ΓòÉΓòÉΓòÉ

Select this menu choice to view a log containing messages from editing commands
used in your Editor session.

This log is contained in a file called MESSAGE.LOG. A separate Editor window
appears containing this file. You can use basic editing features to view or
change the file.


ΓòÉΓòÉΓòÉ <hidden> Collapse editor ΓòÉΓòÉΓòÉ

Select this menu choice to minimize all Editor windows into a single icon.

To restore all windows to their original state, double-click on the icon
produced by this action.


ΓòÉΓòÉΓòÉ <hidden> File list ΓòÉΓòÉΓòÉ

Select this menu choice to get a list of all documents open in the Editor other
than that displayed in the current editing window.

To go to one of these other documents, click on that document's name in the
list.


ΓòÉΓòÉΓòÉ <hidden> Next in ring ΓòÉΓòÉΓòÉ

Select this menu choice to bring the next document in the current ring into the
editing window.


ΓòÉΓòÉΓòÉ <hidden> Previous in ring ΓòÉΓòÉΓòÉ

Select this menu choice to bring the previous document in the current ring into
the editing window.


ΓòÉΓòÉΓòÉ <hidden> Next ring ΓòÉΓòÉΓòÉ

Select this menu choice to make the editing window of the next ring in the
Editor ring sequence the active editing window.


ΓòÉΓòÉΓòÉ <hidden> Previous ring ΓòÉΓòÉΓòÉ

Select this menu choice to make the editing window of the previous ring in the
Editor ring sequence the active editing window.


ΓòÉΓòÉΓòÉ <hidden> Close editor ΓòÉΓòÉΓòÉ

Select this menu choice to end your editor session and remove all of its
windows.


ΓòÉΓòÉΓòÉ <hidden> Next view ΓòÉΓòÉΓòÉ

Select this menu choice to view the next view of the current file as determined
by the current listing of windows in the window list.

Note:   You can select this choice only if you have created other edit views of
the current file. Minimized or hidden windows will not be displayed.


ΓòÉΓòÉΓòÉ <hidden> Previous view ΓòÉΓòÉΓòÉ

Select this menu choice to view the previous view of the current file as
determined by the current listing of windows in the window list.

Note:   You can select this choice only if you have created other edit views of
the current file. Minimized or hidden windows will not be displayed.


ΓòÉΓòÉΓòÉ <hidden> Next file ΓòÉΓòÉΓòÉ

Select this menu choice to view the next file being edited in an active Editor
window as determined by the current listing of windows in the window list.

Note:   You can select this option only if there are other files being edited.
Minimized or hidden windows will not be displayed.


ΓòÉΓòÉΓòÉ <hidden> Previous file ΓòÉΓòÉΓòÉ

Select this menu choice to view the previous file being edited in an active
Editor window as determined by the current listing of windows in the window
list.

Note:   You can select this choice only if there are other files being edited.
Minimized or hidden windows will not be displayed.


ΓòÉΓòÉΓòÉ <hidden> Command shell ΓòÉΓòÉΓòÉ

Select this menu choice to start a command shell within an Editor window.
Commands can be entered into the Editor window and output from the commands
will be logged in the Editor window.


ΓòÉΓòÉΓòÉ <hidden> Help ΓòÉΓòÉΓòÉ

Use this menu bar choice to get access to help information.


ΓòÉΓòÉΓòÉ <hidden> Help index ΓòÉΓòÉΓòÉ

Select this menu choice to see a list of index entries in the help.
Alternatively, press the F11 key while in any Help window associated with the
current window.

To display the information associated with an entry, double-click on the entry
(or press Tab to move the cursor to the entry, and then press Enter).


ΓòÉΓòÉΓòÉ <hidden> General Help ΓòÉΓòÉΓòÉ

Select this menu choice to get general information about the current window.
Alternatively,

 o Press F1 in the current window when no item in the window is selected, or

 o If you selected an item and pressed F1 to get specific help for that item,
   press F2 from the Help window that is displayed.


ΓòÉΓòÉΓòÉ <hidden> Using help ΓòÉΓòÉΓòÉ

Select this menu choice to find out how to use the help in CODE.

To get help for any item in the window, select the item and press F1.

To get other types of help information, select a choice from the Help menu.


ΓòÉΓòÉΓòÉ <hidden> Keys help ΓòÉΓòÉΓòÉ

Select this menu choice to see information about the function keys and shortcut
keys used in the current window, and about basic mouse and keyboard
manipulations.  Alternatively, press F9 in any Help window associated with the
current window.


ΓòÉΓòÉΓòÉ <hidden> Table of contents ΓòÉΓòÉΓòÉ

Shows the topics in the order in which the help is organized, so you can learn
about the structure of the help.

The table of contents can be expanded or contracted. If a plus sign (+)
precedes a topic, click on it (or move the cursor to the topic and then press
(+)) to see all sub-topics under it. If a minus sign (-) precedes it, click on
it (or move the cursor to the topic and then press (-) to close the sub-topics
under it). To view all sub-topics under each topic, select Expand all from the
Options menu or hold down Ctrl and press (*).

To view a topic, double-click on it (or press Tab to move the cursor to the
topic, and then press Enter).


ΓòÉΓòÉΓòÉ <hidden> Editor reference ΓòÉΓòÉΓòÉ

Select this menu choice to get help for the commands supported by your editor,
as well as instructions on customizing the editor


ΓòÉΓòÉΓòÉ <hidden> How Do I... ΓòÉΓòÉΓòÉ

Select this menu choice to get How Do I... task help for the Editor.


ΓòÉΓòÉΓòÉ <hidden> Product information ΓòÉΓòÉΓòÉ

Select this menu choice to see the product name and version number as well as
copyright information.


ΓòÉΓòÉΓòÉ <hidden> Action Keys ΓòÉΓòÉΓòÉ

Use this window to view and change the actions assigned to keys, combinations
of keys, and mouse buttons.

The assigned action defaults are determined by the profiles used when a file is
opened.


ΓòÉΓòÉΓòÉ <hidden> Action Keys ΓòÉΓòÉΓòÉ

This list shows the actions assigned to keys.

To change an assigned action, select the required action, and then select
Change. Use the Change Action Key window to enter the new action.

To set a new action key, select Add. Use the Add an Action Key window to enter
the required name and value.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 Change      Display the Change Action Key window, in which you type the new
             action for the selected action key.

 Add         Display the Add an Action Key window, in which you type the new
             name and value.

 OK          Close the Action Keys window and return to the file with which you
             were working. Any changes you have made are saved.

 Help        Display online help information for the item where the cursor is
             positioned. To display general help for the entire window, press
             F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Change Action Key ΓòÉΓòÉΓòÉ

Use this window to type the new value for the action key selected in the Action
Keys window.

Type the new value for the action key in the field provided, and then select
one of the following push buttons:

 OK          Save the changes you have made in the Change Action Key window,
             and return to the Action Keys window.

 Cancel      Close the Change Action Key window without applying any of the
             changes you have made, and return to the Action Keys window.

 Help        Displays online help information.


ΓòÉΓòÉΓòÉ <hidden> Add an Action Key ΓòÉΓòÉΓòÉ

Use this window to enter the required name and value for a new action key.

Type the new value for the action key in the field provided, and then select
one of the following push buttons:

 OK          Save the changes you have made in the Add an Action Key window,
             and return to the Action Keys window.

 Cancel      Close the Add an Action Key window without applying any of the
             changes you have made, and return to the Action Keys window.

 Help        Display online help information.


ΓòÉΓòÉΓòÉ <hidden> Automatic Indenting ΓòÉΓòÉΓòÉ

Use this window to specify the position where the cursor will be placed on the
next line after you type a token and press Enter. If you type a line that does
not contain a token, the first non-blank character in that line determines
where the cursor will be placed on the next line.

If you select the Save settings check box, the information you type here will
be stored for future editor sessions in the language profile associated with
the current file.

Output Fields

The Language profile field shows the name of the language profile associated
with the current file.

Notes

 o Automatic indenting is not supported for RPG/400 or CL.

 o To enable or disable automatic indenting, select Automatic indenting under
   Language editing in the Options menu.

 o Automatic indenting is not supported beyond column 256.

 o If lines are going to exceed the record length of a file and be truncated,
   the automatic indenting feature will not indent them fully, but will
   right-justify them with the record length.


ΓòÉΓòÉΓòÉ <hidden> Tokens ΓòÉΓòÉΓòÉ

This list contains all tokens supported by the programming language specified
in the language profile that is associated with the file you are currently
editing. It also displays the indent value associated with each token.

Select one or more entries to change the indent value associated with them.


ΓòÉΓòÉΓòÉ <hidden> Change to ΓòÉΓòÉΓòÉ

Use this field to change the indent value for any tokens you have selected in
the Tokens list. Select the arrows adjacent to the spin button to scroll
through the available choices, or type a value directly into the field.

You can choose from the following values:

 1 through 20
     Starts a line typed after a token 1 through 20 spaces to the right of the
     token.
 -1 through -20
     Starts a line typed after the token 1 through 20 spaces to the left of the
     token. The line will start at the first column rather than to the left of
     the first column.
 0 or -0
     Starts a line typed after a token immediately underneath the token.

 Notes

 o To enable or disable automatic indenting, select Automatic indenting under
   Language editing in the Options menu.

 o You must move the cursor manually to place subsequent tokens at the columns
   where they belong.

 o This field is set initially at 0.

 o Automatic indenting is not supported beyond column 256, and any lines that
   are supposed to start to the right of this value will start at it instead.

 o If lines are going to exceed the record length of a file and be truncated,
   the automatic indenting feature will not indent them fully, but will
   right-justify them with the record length.

 Example:

 Suppose automatic indenting is enabled from the Language editing choice in the
 Options menu and the cursor is currently at the sixth column.

  1. If you type a line containing a token with an indent value of 2, the
     cursor will be positioned automatically on the next line at the eighth
     column.

  2. If you then type a line containing no token, the cursor will be positioned
     automatically on next line again at the eighth column.

  3. If you then type a line containing a token with an indent value of -3, the
     cursor will be positioned automatically on the next line at the fifth
     column.

  4. If you then type a line containing a token with an indent value of -6, the
     cursor will be positioned automatically on the next line at the first
     column (since you can't go to the left of the first column).


ΓòÉΓòÉΓòÉ <hidden> Save settings ΓòÉΓòÉΓòÉ

Select this check box to save your changes permanently to the current language
profile.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Save any changes you have made to the indent values associated
             with tokens, and return to the editor window.
 Change      Change the indent value of all tokens selected in the Tokens field
             to the value selected in the Change to field.
 Defaults    Reset the values in the Automatic indenting window to default
             values that were shipped with the editor product at the time of
             its installation.
 Cancel      Close the Automatic Indenting window without applying any of the
             changes you have made, and return to the Editor window.
 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Command Retrieval ΓòÉΓòÉΓòÉ

Use this window to set the maximum number of retrievable commands, and to
specify the commands that are retrievable. If an identical command already
exists in the buffer, only one copy is retained.

By default, the twelve most recent distinct commands issued through the command
line are available for later retrieval.


ΓòÉΓòÉΓòÉ <hidden> Number of Retrievable Commands ΓòÉΓòÉΓòÉ

Initially, this field displays the default number of unique commands that are
available at one time. Type a value for the number of retrievable commands.


ΓòÉΓòÉΓòÉ <hidden> Retrieve Commands Options ΓòÉΓòÉΓòÉ

Select one or more of these check boxes to choose the commands that are
retrievable.

 Command Line      Retrieves commands that were issued through the command
                   line.

 Menu Options      Retrieves commands that were issued by selecting menu
                   choices.

 Action Keys       Retrieves commands that were issued by pressing action keys.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Save the changes you have made in the Command Retrieval window,
             and return to the window in which you were working.

 Cancel      Close the Command Retrieval window without applying any of the
             changes you have made, and return to the window in which you were
             working.

 Help        Display online help information for the item where the cursor is
             positioned. To display general help for the entire window, press
             F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Display Messages ΓòÉΓòÉΓòÉ

This window displays the messages returned by the syntax checker.


ΓòÉΓòÉΓòÉ <hidden> Message list ΓòÉΓòÉΓòÉ

This list displays messages returned by the syntax checker, and their
corresponding text.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Exit the Display Messages window, and return to the editor window.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Find ΓòÉΓòÉΓòÉ

Use this window to search for or change strings of text in an active window.
You can get more information on the items listed below by double clicking on
any item in the list.

 o Find
 o Replace with
 o Replace this occurrence
 o Replace, then find next
 o Replace all occurrences
 o Case sensitive
 o Pattern match
 o Wrap
 o Push buttons


ΓòÉΓòÉΓòÉ <hidden> Find ΓòÉΓòÉΓòÉ

Type the text you want to find or change.

Note:  If the Case sensitive check box is selected, uppercase and lowercase
characters in the text you type must match exactly the text you are looking
for.


ΓòÉΓòÉΓòÉ <hidden> Replace with ΓòÉΓòÉΓòÉ

Type the text that you want used to replace the text specified in the Find
field.

Note:   If this field is left empty and the Replace push button is selected,
any or all occurrences of the text specified in the Find field will be deleted
according to the find options set.


ΓòÉΓòÉΓòÉ <hidden> Replace - ΓòÉΓòÉΓòÉ

The Editor gives you control over how it searches for and replaces text. Select
one of the replace actions described below by clicking on the corresponding
radio button in the Editor - find and replace window.

 Replace this occurrence
             Select this radio button if you want only the next occurrence of
             the search

 Replace, then find next
             Select this radio button if you want to replace the next
             occurrence of the search item.  If the search item is found, it is
             replaced with the specified text and the Editor then looks for the
             next occurrence of the search item.

 Replace all occurrences
             Select this radio button if you want all occurrences of the search
             item to be replaced with the specified text.


ΓòÉΓòÉΓòÉ <hidden> Case sensitive ΓòÉΓòÉΓòÉ

Use this check box to specify whether the find feature is to respect or ignore
case.

If this check box is selected, only those character strings that exactly match
the text in the Find  field (including uppercase and lowercase characters) will
be found.

If this check box is not selected, all character strings matching the text in
the Find  field will be found, regardless of whether individual characters are
in uppercase or lowercase.


ΓòÉΓòÉΓòÉ <hidden> Pattern match ΓòÉΓòÉΓòÉ

Select this check box to specify that the entry in the Find text entry field is
a regular expression search pattern. The search will try to locate any
expression that matches the regular expression.

See Using Regular Expression Patterns. for more information.


ΓòÉΓòÉΓòÉ <hidden> Using Regular Expression Patterns to Find Text ΓòÉΓòÉΓòÉ

A regular expression consists of a combination of ordinary and special
characters, and bracket expressions.  Together, these elements can be used to
specify a search expression with flexibility and power far greater than that
afforded by a simple text search.

For more information, see:

 o Regular Expression Character Set
 o Bracket Expressions
 o Regular Expression Syntax
 o Operator Orders of Precedence


ΓòÉΓòÉΓòÉ <hidden> Regular Expression Character Set ΓòÉΓòÉΓòÉ

You can use any single-byte character in your regular expression, subject to
the following rules:

 o Special characters in regular expressions are:


         .     [     \     *     ^     $

         (     )     +     ?     {     |

 o An ordinary character matches itself.  A simple regular expression could
   consist of a string of ordinary characters which would be treated as a
   literal-text search item.

   An ordinary character is any single-byte character that is not a special
   character.

 o A special character, preceded by a backslash (\), matches itself.

 o A period (.), not preceded by a backslash (\), matches any single character.

 o Characters are case-sensitive only if you select the Case sensitive
   check-box in the Editor - find and replace window.

 For more information about regular expression search patterns, see:

 o Bracket Expressions
 o Regular Expression Syntax
 o Operator Orders of Precedence


ΓòÉΓòÉΓòÉ <hidden> Bracket Expressions ΓòÉΓòÉΓòÉ

A bracket expression can contain one or more expressions that match characters,
collating symbols, equivalence or character classes, or ranges of characters.
Bracket expressions are case-sensitive only if you select the Case sensitive
check-box in the Editor - find and replace window.

The basic forms of a bracket expression are:

 [string ]             Matches any of the characters specified in string.  For
                       example, [set] matches the next instance of characters
                       s, e, or t.

                       Note:   If you want to match a hyphen (-), the hyphen
                       must appear as either the first or last character in the
                       string.

 [^string ]            Does not match any of the characters specified in
                       string.

 [symbol1-symbol2 ]    Matches all collating elements that fall between the two
                       specified collating symbols, inclusive.  The symbols
                       must be different, with symbol2 higher in the collating
                       sequence than symbol1. For example, [d-f] will match the
                       next instance of characters d, e, or f.

 [[.symbol .]]         Matches the collating element specified by the symbol,
                       which can be single or multiple character collating
                       symbol.  For example, if ch is the collating symbol for
                       ch in the current locale, [[.ch.]] matches the character
                       sequence ch.

                       The bracket expression is considered invalid if symbol
                       is not valid in the current locale, or no characters are
                       associated with symbol.

 [[=symbol =]]         Matches all characters that have equal weight in the
                       equivalence class to which the character(s) symbol
                       belongs.  For example, if the characters a, с, and т
                       belong to the same equivalence class, [[=a=]] will match
                       any of the three characters. If symbol has no
                       equivalents, it is treated as a simple collating symbol.

 [[.class.]]           Matches any characters that belong to the class
                       specified by class.  Valid classes and their meanings
                       are:

    alpha   Alphabetic characters
    digit   Numeric digits
    lower   Lowercase characters
    punct   Puncutation symbols
    space   The space character, or blank
    upper   Uppercase characters.

 Note:   You can use a right bracket (]) as an ordinary character in a bracket
 expression only if you specify it as the first character following the left
 bracket ([) or caret (^) symbols.

 For more information about regular expression search patterns, see:

 o Regular Expression Character Set
 o Regular Expression Syntax
 o Operator Orders of Precedence


ΓòÉΓòÉΓòÉ <hidden> Regular Expression Syntax ΓòÉΓòÉΓòÉ

You can combine characters, special characters, and bracket expressions to form
regular expressions that match multiple characters and character patterns.
Basic syntax elements for regular expressions are:

 (expr )         Matches whatever expr matches.  Place an expression in
                 parenthesis if you want to apply an operator on it, such as +
                 or *.

 expr*           Matches zero or more consecutive occurrences of the pattern
                 specified by expr.  For example, [so]* matches the text
                 patterns so, soso, and sososo

 expr {n }       Matches exactly n occurrence(s) of the pattern specified by
                 expr.  For example, [so]{2} matches the text pattern soso, but
                 not so or sososo.

 expr {n ,}      Matches at least n occurrence(s) of the pattern specified by
                 expr.  For example, [so]{2,} matches the text patterns soso
                 and sososo, but not so.

 expr {n1, n2 }  Matches between n1 and n2 occurrence(s) inclusive of the
                 pattern specified by expr.  For example, [so]{1,2} matches the
                 text patterns so and soso, but not sososo.

 ^expr           Matches the pattern specified by expr only if it occurs at the
                 very start of a line.

 expr $          Matches the pattern specified by expr only if it occurs at the
                 very end of a line.

 ^expr $         Matches the pattern specified by expr only if it comprises the
                 entire line.

 expr ?          Matches zero or more occurrences of the pattern specified by
                 expr.

 expr +          Matches one or more occurrences of the pattern specified by
                 expr.

 expr1 |expr2    Matches the pattern specified by either expr1 or expr2. For
                 example, s|o matches both characters s and o.

 For more information about regular expression search patterns, see:

 o Regular Expression Character Set
 o Bracket Expressions
 o Regular Expression Syntax
 o Operator Orders of Precedence


ΓòÉΓòÉΓòÉ <hidden> Operator Orders of Precedence ΓòÉΓòÉΓòÉ

Regular expression elements are process in a specific order. The order of
precedence is described below.  Element categories with higher precedence
appear closer to the top of the list. Within each category, higher precedence
is to the left.

 Operators               Category Description

 [==] [::] [..]          Collation-related bracket symbols

 \special                Special characters preceded by a backslash

 [                       Bracket expressions

 ()                      Grouping of expressions

 * + ? {n} {n,} {n1,n2}  Pattern repetition

 (none)                  Concatenation of expressions

 ^ $                     Anchoring of pattern to start or end of line

 |                       Alternate match patterns

 For more information about regular expression search patterns, see:

 o Regular Expression Character Set
 o Bracket Expressions
 o Regular Expression Syntax


ΓòÉΓòÉΓòÉ <hidden> Wrap ΓòÉΓòÉΓòÉ

Select this check box if you want to search all text in the active window,
including that preceding the cursor position.  If you do not select this check
box, text is searched, depending on search direction, only until the beginning
or end of file.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons to search for and change text.

 Find        Search for the next occurrence of the text you specify in the Find
             field.

 Replace     Change an occurrence of the text specified in the Find field to
             the text specified in the Replace with field.

             Note:    If the Replace with field is empty, any found text will
             be deleted.

 Options     Display the Find and replace - options window. This window lets
             you set the scope of the search, search direction within a
             document, and specify Editor actions after a search item is found.

 Cancel      Close the Find window without performing any further action, and
             return to the window you were working in.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Find and replace - options ΓòÉΓòÉΓòÉ

Use this window to restrict the text you want to change or search to selected
text or column numbers.

This window is accessible only, from the Options push button of the Editor -
find and replace window.

Changes made in this window will expire at the end of the current editing
session.


ΓòÉΓòÉΓòÉ <hidden> Restrict search to ΓòÉΓòÉΓòÉ

Select the scope of your search by selecting one of the radio buttons described
below:

 o All documents - look for the search item in all documents currently open in
   the Editor.

 o Current document - look for the search item only in the current document
   view.

 o Selection, if exists - look for the search item only in the marked text
   selection of the current document view.  If no text is selected, the find
   operations tries to find the search item in the current document view.


ΓòÉΓòÉΓòÉ <hidden> Columns ΓòÉΓòÉΓòÉ

Select the Columns check box to restrict the search and change operations to
certain columns only.

Type in a value, or select the up or down arrows to scroll through a list of
available values, for the following:

 Between     Indicates the first column search and change operations apply to.

 And         Indicates the last column search and change operations apply to.


ΓòÉΓòÉΓòÉ <hidden> Direction ΓòÉΓòÉΓòÉ

Select a radio button to specify whether you want to find character strings
occurring before or after the current cursor position.

 Forward     Locates the next occurrence in the current file of the character
             string you typed in the Find  field.

 Backward    Locates the previous occurrence in the current file of the
             character string you typed in the Find field.


ΓòÉΓòÉΓòÉ <hidden> Mark found text ΓòÉΓòÉΓòÉ

Select this check box to mark the text found by the Find feature. Any
previously marked text will no longer be marked.


ΓòÉΓòÉΓòÉ <hidden> Cancel after find ΓòÉΓòÉΓòÉ

Select this check box if you want the Find and replace window to close after
the search item has been found.

If you do not select this check box, the Find and replace window remains open
until you explicitly close it by clicking on the Cancel push button.


ΓòÉΓòÉΓòÉ <hidden> Shift data on replace ΓòÉΓòÉΓòÉ

Select this check box if you want your replacement text to replace only the
search item.  If the replacement text has a different length than the search
item, other text following the search item shifts  either left or right as
needed to accomodate the length of the replacement text.  The length of the
line containing the search item changes if the search item and the replacement
text are of different lengths.

If you do not check this option, and the length of your replacement text is,
when compared to the length of the search item:

 longer      the replacement text overwrites the search item and text following
             the search item as needed to place the entire replacement text
             into your document.  The overall length of the line is not
             changed.

 shorter     The search item is replaced with the replacement text and trailing
             spaces to a total length of the orginal search item.  The overall
             length of the line is not changed.


ΓòÉΓòÉΓòÉ <hidden> Update find list ΓòÉΓòÉΓòÉ

Select this check box if you want this find operation recorded in the find
event history log.


ΓòÉΓòÉΓòÉ <hidden> Find list maximum size ΓòÉΓòÉΓòÉ

To change the size of the find events history log, type the desired number
directly into the text entry field, or use  the and down arrows to change the
value in the field. change the


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Save the find and replace options, and change return to the Editor
             - find and replace window.

 Defaults    Reset options to their default installation values.

 Cancel      Close the Find and replace - options window without saving changed
             options, and return to the Editor - find and replace window.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Font ΓòÉΓòÉΓòÉ

Use this window to change the base font for the Editor.

Controls found in this window are listed below.  For more information, double
click on any entry in this list.

 o Name
 o Size
 o Display - not applicable to the Editor.
 o Printer - not applicable to the Editor.
 o Outline - Not applicable to the Editor.
 o Underline - Not applicable to the Editor.
 o Strikeout - Not applicable to the Editor.
 o Sample


ΓòÉΓòÉΓòÉ <hidden> Name ΓòÉΓòÉΓòÉ

Initially, this list displays the font name used in the current window.

To choose another font , click on the down arrow to scroll through the list of
available fonts, and select an entry. An example of the type appearance will
appear in the Sample field.


ΓòÉΓòÉΓòÉ <hidden> Size ΓòÉΓòÉΓòÉ

Initially, this list displays the font size used in the current window.

To choose another size, click on the down arrow to scroll through the list of
available sizes, and select an entry. An example of the resulting type
appearance will appear in the Sample field.


ΓòÉΓòÉΓòÉ <hidden> Not applicable ΓòÉΓòÉΓòÉ

This field has no effect on the Editor.


ΓòÉΓòÉΓòÉ <hidden> Sample ΓòÉΓòÉΓòÉ

This area displays how the current font selection will appear.  You can not
enter information into this area.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Apply changes you have made in the Font  window, then returns you
             to the Editor.

 Cancel      Close the Font window without applying any of the changes you have
             made, and return to the Editor.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Global Variables ΓòÉΓòÉΓòÉ

Use this window to view and change all currently set global variables.


ΓòÉΓòÉΓòÉ <hidden> Variables ΓòÉΓòÉΓòÉ

This list displays the name and value of each variable.

To change a variable, select its name, and then select Change. Use the Change
Global Variable window to type the new value for the variable.

To set a new variable, select Add. Use the Add a Global Variable window to type
the required name and value.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 Change      Display the Change Global Variable window, in which you type the
             new value for the selected variable.

 Add         Display the Add a Global Variable window, in which you type a
             variable name and value.

 OK          Close the Global Variables window and return to the editing window
             in which you were working. Any changes you have made are saved.

 Help        Display online help information for the item where the cursor is
             positioned. To display general help for the entire window, press
             F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Change Global Variable ΓòÉΓòÉΓòÉ

Use this window to type the new value for the selected variable.

Type the new value for the selected variable in the field provided, and then
select one of the following push buttons:

 OK          Save the changes you have made in the Change Global Variable
             window, and returns to the Global Variables window.

 Cancel      Close the Change Global Variable window without applying any of
             the changes you have made, and return to the Global Variables
             window.

 Help        Display online help information.


ΓòÉΓòÉΓòÉ <hidden> Add a Global Variable ΓòÉΓòÉΓòÉ

Use this window to add a variable name and value.

Type the new value for the selected variable in the field provided, and then
select one of the following push buttons:

 OK          Save the changes you have made in the Add a Global Variable
             window, and return to the Global Variables window.

 Cancel      Close the Add a Global Variable window without applying any of the
             changes you have made, and return to the Global Variables window.

 Help        Display online help information.


ΓòÉΓòÉΓòÉ <hidden> Include ΓòÉΓòÉΓòÉ

Use this window to display only those lines containing a particular character
string.


ΓòÉΓòÉΓòÉ <hidden> Include all lines with this string ΓòÉΓòÉΓòÉ

Initially, this field is blank, indicating that all lines of a file will be
included in the editor window.

To include only those lines of the file containing a particular character
string, type the string in this field.


ΓòÉΓòÉΓòÉ <hidden> Case ΓòÉΓòÉΓòÉ

Select a radio button to specify if the include feature respects or ignores
case.

Radio button summary

 Respect     Only those character strings that exactly match the text in the
             Include lines with this string field (including uppercase and
             lowercase characters) are included.

 Ignore      All character strings matching the text in the Include lines with
             this string field are found, regardless of whether individual
             characters are uppercase or lowercase.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 Include     Include only those lines in the editor window that contain the
             character string specified in the Include lines with this string
             field.

 Cancel      Close the Include window without performing any further action,
             and return to the window you were working in.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Include Date ΓòÉΓòÉΓòÉ

Use this window to include only those lines with a particular date, as
described in the window.

You can include lines with dates that are:

 o Previous to the specified date, if you select the Less than radio button and
   then type the date in the Date entry field.

 o Equal to the specified date, if you select the Equal to radio button and
   then type the date in the Date entry field.

 o Subsequent to the specified date, if you select the Greater than radio
   button and then type the date in the Date entry field.

 o With a range of dates, if you select the Range radio button and then type
   the dates in the Date and To entry fields.

 Push Buttons

 OK          Include the appropriate lines, then dismiss the Include Date
             window.

 Cancel      Dismiss the window without taking action.

 Help        Display online help information.


ΓòÉΓòÉΓòÉ <hidden> Issue edit command ΓòÉΓòÉΓòÉ

Use this window to create and issue Editor commands.


ΓòÉΓòÉΓòÉ <hidden> Commands ΓòÉΓòÉΓòÉ

Initially, this field displays the last command issued. If no command has been
issued, the field is blank.

To issue a new Editor command, type the command in this field and click on the
OK push button.

You can see a list of previously-issued commands by clicking on the down-arrow
button.  Clicking on one of these commands will transfer that command to the
command entry field.  To run the command in this field, click on the OK push
button.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Process the command you have selected in the command entry field,
             and returns the window in which you were working.

 Cancel      Close the Issue edit command window without processing a command,
             and return to the editing window in which you were working.

 Help        Display online help information for the item where the cursor is
             positioned. To display general help for the entire window, press
             F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Locate Date ΓòÉΓòÉΓòÉ

Use this window to move the cursor to the beginning of a line with a particular
date, as described in the window.

You can locate a date that is:

 o Previous to the specified date, if you select the Less than radio button and
   then type the date in the Date entry field.

 o Equal to the specified date, if you select the Equal to radio button and
   then type the date in the Date entry field.

 o Subsequent to the specified date, if you select the Greater than radio
   button and then type the date in the Date entry field.

 o With a range of dates, if you select the Range radio button and then type
   the dates in the Date and To entry fields.

 You can have the found line marked by selecting the Mark found line check box.

 Push Buttons

 OK          Locate the next appropriate line.

 Cancel      Dismiss the window without taking action.

 Help        Display online help information.


ΓòÉΓòÉΓòÉ <hidden> Locate - line ΓòÉΓòÉΓòÉ

Use this window to move the text cursor to the beginning of the nth line or
sequence number in the file.

You can locate a line by:

 o Line number, if you select the Line number radio button and type the desired
   line number into the adjacent text entry field.

 o Sequence number, if you select the Sequence number radio button and type the
   desired sequence number in the adjacent text entry field.

 You can mark the requested line by selecting the Mark found line check box.

 Push Buttons

 OK          Locate the specified line.

 Cancel      Close the Locate Line window without locating a line.

 Help        Display online help information.


ΓòÉΓòÉΓòÉ <hidden> Locate - mark ΓòÉΓòÉΓòÉ

This window contains a list of all marks currently set in the text.  Select a
mark from this list by clicking on the chosen mark's name, and then click on
the appropriate push button.

Push Buttons

 OK          Go to the location indicated by the named mark.

 Cancel      Cancel this operation, and return to the editing window.

 Help        Display this help panel.


ΓòÉΓòÉΓòÉ <hidden> Name a Mark ΓòÉΓòÉΓòÉ

Use this window to place and name a mark in the text, at the position of the
text cursor. Type the name of the mark into the name entry field provided, and
then click on the appropriate push button.

Push Buttons

 OK          Mark the location using the name specified in the name entry
             field.

 Cancel      Cancel this operation, and return to the editing window.

 Help        Display this help panel.


ΓòÉΓòÉΓòÉ <hidden> Open window ΓòÉΓòÉΓòÉ

Use this window to open an existing file.

Note:   The Editor will not try to open a file that is already loaded in the
Editor.

For further information, see:

 o Open filename
 o Type of file
 o Drive
 o File
 o Directory
 o Profiles
 o Linebreak mode
 o Push buttons


ΓòÉΓòÉΓòÉ <hidden> New window ΓòÉΓòÉΓòÉ

Use this window to open a new Editor window.

For further information, see:

 o Profiles
 o Linebreak mode
 o Push buttons


ΓòÉΓòÉΓòÉ <hidden> Save As window ΓòÉΓòÉΓòÉ

Use this window to save a file under a new name.

For further information, see:

 o Save as filename
 o Save file as type
 o Drive
 o File
 o Directory
 o Rename document
 o Linebreak mode
 o Push buttons


ΓòÉΓòÉΓòÉ <hidden> Get file window ΓòÉΓòÉΓòÉ

Use this window to insert an existing file at the current cursor position.

Note:   The Get operation will not load any new profiles along with the file
being inserted.  Profiles already loaded remain in effect and are applied to
the file being inserted.

For further information, see:

 o Open filename
 o Type of file
 o Drive
 o File
 o Directory
 o Linebreak mode
 o Push buttons


ΓòÉΓòÉΓòÉ <hidden> Open filename ΓòÉΓòÉΓòÉ

You can type the name of the file you wish to open directly into this text
entry field.  It also displays any file you select from the File list box.


ΓòÉΓòÉΓòÉ <hidden> Save as filename ΓòÉΓòÉΓòÉ

You can type the name of the file you wish to save directly into this text
entry field.  It also displays any file you select from the File list box.


ΓòÉΓòÉΓòÉ <hidden> Open filename ΓòÉΓòÉΓòÉ

You can type the name of the file you wish to get directly into this text entry
field.  It also displays any file you select in the File list box.


ΓòÉΓòÉΓòÉ <hidden> Type of file ΓòÉΓòÉΓòÉ

Select the down arrow to the right of the Type of file field to display the
available file types.


ΓòÉΓòÉΓòÉ <hidden> Save as file type ΓòÉΓòÉΓòÉ

Select the down arrow to the right of the Save as file type field to display
the available file types.


ΓòÉΓòÉΓòÉ <hidden> Drive ΓòÉΓòÉΓòÉ

The Drive list displays the drives on your system. Select the drive that
contains the files you want to open, insert or create.


ΓòÉΓòÉΓòÉ <hidden> File ΓòÉΓòÉΓòÉ

The File list displays all the files in the directory you selected from the
Directory list.  Select the file you want to open, insert or overwrite.


ΓòÉΓòÉΓòÉ <hidden> Directory ΓòÉΓòÉΓòÉ

The Directory list displays the directories on the selected drive.  Select a
directory to display the list of files from that directory in the File list
box.


ΓòÉΓòÉΓòÉ <hidden> Profiles ΓòÉΓòÉΓòÉ

You can select which profiles you want run when you load or create the file.

+-----------------------------------------+
|Selection         |Macro                 |
|------------------+----------------------|
|User Profile      |PROFILE Macro         |
|------------------+----------------------|
|Language Profile  |xxx.LXL (Load) Macro  |
+-----------------------------------------+

For more information on these profiles, see How Do I... Write Macros for the
Editor.


ΓòÉΓòÉΓòÉ <hidden> Linebreak mode ΓòÉΓòÉΓòÉ

You can select which linebreak options is used.  This is used to determine how
lines are to be defined.  The default mode is DOS, which requires that both CR
and LF are present and are adjacent in that order.  The UNIX mode requires only
LF.  CRLF mode is the same as DOS mode and LF mode is equivalent to UNIX mode.


ΓòÉΓòÉΓòÉ <hidden> Rename document ΓòÉΓòÉΓòÉ

Select this option to change the name of the file currently loaded into the
editor.  If you select Save As without this option checked a copy of the
current file will be saved with the given name but copy in the editor will not
be renamed.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Select this push button if you wish to load the file currently
             displayed in the Open filename entry field.

 Cancel      Close the Open window without applying any of the changes you have
             made, and return to the Editor window.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 New         Select this push button if you are ready to open a new, empty
             Editor window with the properties selected.

 Cancel      Close the New window without applying any of the changes you have
             made, and return to the Editor window.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Select this push button if you wish to load the file currently
             displayed in the Open filename entry field, with the linebreak
             mode currently selected.

 Cancel      Close the Get window without applying any of the changes you have
             made, and return to the Editor window.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Select this push button if you wish to save the current file with
             the filename displayed in the Save as filename entry field.

 Cancel      Close the Save as window without applying any of the changes you
             have made, and return to the Editor window.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Selection List ΓòÉΓòÉΓòÉ

The selection list shows the names of files that have been modified since the
last save.  Initially, all file names shown are highlighted, indicating that
changes will be saved for every file in the list when you press the Continue
button.

To toggle highlighting of a file name on or off, place the mouse pointer over
the name of the file in the selection list, and press mouse button 1.


ΓòÉΓòÉΓòÉ <hidden> Save before action ΓòÉΓòÉΓòÉ

File names highlighted in the selection list will have their changes saved when
you press the Continue push button.

For more information about the controls in this window, see:

 o Selection List
 o Push Buttons


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 Continue    Save changes to all file names highlighted in the selection list.

 Cancel      Cancel the save operation.

 Help        Display this help panel.


ΓòÉΓòÉΓòÉ <hidden> Editor Parameters ΓòÉΓòÉΓòÉ

Use this window to query and set commands.

All the commands that can be queried or set are listed in the window.

To query a command setting, select its entry in the list. The selected command
and its current setting are displayed in the read-only field underneath the
list.

To change a command setting, select its entry in the list and then select
Change. Change the setting in the window provided, and then select OK.

To turn a setting on or off (if possible), select its entry in the list and
then select Inverse. Its current status is displayed in the read-only field
underneath the list.


ΓòÉΓòÉΓòÉ <hidden> Commands ΓòÉΓòÉΓòÉ

This list shows all the commands that can be queried or set.

To query a command setting, select the command in the list. The selected
command and its current setting are displayed below the command list.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 Change      Display the Set Option window, from which you can change the
             selected command.

 Inverse     Change the setting for the selected command to its inverse. For
             example, if a command is set to ON, selecting Inverse changes its
             setting to OFF.

 OK          Close the Parameters window and return to the window in which you
             were working. Any changes you have made are saved.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Set Option ΓòÉΓòÉΓòÉ

Use this window to change a command setting.

Type the new value for the command in the New value field.

Then, select one of the following push buttons:

 OK          Save the changes you have made in the Set Option window, and
             return to the Editor Parameters window.

 Cancel      Close the Set Option window without applying any of the changes
             you have made, and return to the Editor Parameters window.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Progress Indicator ΓòÉΓòÉΓòÉ

This window informs you that your editor session is currently processing a
file.

Output Fields

To scroll through the information in the Description or Text fields, click on
them and scroll with the Left Arrow, Right Arrow, Home, and End keys.

The Description field shows how your system is processing the file (for
example, saving or loading it).

The Elapsed time field shows how many minutes and seconds the system has been
processing the file.

The Status field gives more information on the activities of the system.

Push buttons

You may select one of the following push buttons:

 Close     Dismisses the Progress Indicator window without affecting the
           process in progress.

 Stop  Not always available. Halts the process in progress and dismisses the
           Progress Indicator window.
 ============================================================================


ΓòÉΓòÉΓòÉ <hidden> Ring Selector List ΓòÉΓòÉΓòÉ

Use this window to transfer documents from one ring to another.  Window
controls are listed below.  Double click on any entry in the list  to get more
information on that entry.

 o Ring select
 o Document list
 o Document transfer buttons
 o Push buttons


ΓòÉΓòÉΓòÉ <hidden> Ring select ΓòÉΓòÉΓòÉ

Click on the down arrow button to see a list of rings currently used by the
Editor.

Click on any entry in this ring list to select that ring.  The window below
will change to reflect the document views available in your chosen ring.


ΓòÉΓòÉΓòÉ <hidden> Document list ΓòÉΓòÉΓòÉ

This window displays all document views available in its corresponding ring.
You can select one or more views in this list by clicking on the desired view
names.

Clicking on an already selected view will deselect that view.


ΓòÉΓòÉΓòÉ <hidden> Transfer buttons ΓòÉΓòÉΓòÉ

Select one of these buttons to move selected document views into a newly
selected ring.

The direction of the arrows denotes the direction of the document view
transfer.

Transfers between rings are not actually performed until the OK push button is
selected.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

 OK          Transfer the marked views to the designated rings, then return to
             the Editor.

 Cancel      Close the Configure rings window without transferring views to
             other rings, and return to the Editor..

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Define Command Synonyms ΓòÉΓòÉΓòÉ

Use this window to display, set or change synonyms for editor commands you
commonly use.


ΓòÉΓòÉΓòÉ <hidden> Synonyms ΓòÉΓòÉΓòÉ

This list displays each currently set synonym, the minimum number of characters
that must be entered, and the corresponding editor command.

To change a synonym, select its name, and then select Change. Use the Change
Synonym window to type the new value for the synonym.

To set a new synonym, select Add. Use the Add a synonym window to type the
required name and value.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 Change      Display the Change synonym window, in which you type the new value
             for the selected synonym.

 Add         Display the Add a synonym window, in which you type the synonym
             name and value.

 OK          Close the Synonyms window. Any changes you have made are saved.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Change Synonym ΓòÉΓòÉΓòÉ

Use this window to type the new value for the selected synonym, and then select
one of the following push buttons:

 OK          Save the changes you have made in the Change Synonym window, and
             return to the Define Command Synonyms window.

 Cancel      Close the Change Synonym window without applying any of the
             changes you have made, and return to the Define Command Synonyms
             window.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Add a Synonym ΓòÉΓòÉΓòÉ

Use this window to enter the required synonym name and value, and then select
one of the following push buttons:

 OK          Save the changes you have made in the Add a Synonym window, and
             return to the Define Command Synonyms window.

 Cancel      Close the Add a Synonym window without applying any of the changes
             you have made, and return to the Define Command Synonyms window.

 Help        Display online help information.


ΓòÉΓòÉΓòÉ <hidden> Tab Settings ΓòÉΓòÉΓòÉ

Use this window to set tabs.


ΓòÉΓòÉΓòÉ <hidden> Tabs set at ΓòÉΓòÉΓòÉ

Type the column numbers where you want tab stops to be placed in the editor.
Separate each number by a blank space. You can enter up to 50 tab stop entries,
between the values of 1 and 2499.

The default values displayed in this field depend on the language profile
associated with the current file.

Once the cursor is to the right of all values displayed in this field, the tab
key will move the cursor by the number of spaces specified in the And then
every field.


ΓòÉΓòÉΓòÉ <hidden> And then every ΓòÉΓòÉΓòÉ

Type a value from 1 to 2499 for the number of spaces you want the cursor to
move when you press the Tab key.

The default value displayed in this field depends on the language profile
associated with the current file.

The tab interval you type in this field applies only when the cursor is to the
right of all applicable tab settings on a line (as displayed in the Tabs set at
field).


ΓòÉΓòÉΓòÉ <hidden> Save settings ΓòÉΓòÉΓòÉ

Select this check box to save your changes to the current language profile for
subsequent editing sessions.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

 OK          Save the changes you have made in the Tab Settings window, and
             return to the editor.

 Cancel      Close the Tab Settings window without applying any of the changes
             you have made, and return to the Editor window.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Token attributes ΓòÉΓòÉΓòÉ

Use this window to change the display attributes assigned to the tokens
available in the current editing window.

Controls found in this window are listed below.  For more information, double
click on any entry in this list.

 o Token type
 o Foreground
 o Background
 o Change all backgrounds
 o Type style
 o Save settings
 o Push buttons


ΓòÉΓòÉΓòÉ <hidden> Token type ΓòÉΓòÉΓòÉ

Changes that you make to color and display attributes apply only to the token
type displayed in this field.

If you want to change the attributes for another type of token, click on the
down arrow to scroll through a list of token types recognized by the language
profile associated with the file in the current editing window.

Note:   The list includes a default token type, which represents any other
tokens not listed.


ΓòÉΓòÉΓòÉ <hidden> Foreground ΓòÉΓòÉΓòÉ

Select this radio button to see the foreground color used for the current token
type.  The name of the current token type is shown in the Token type field.

Available colors are shown in the Color palette display area, with the button
corresponding to the current foreground color outlined in black.  Also, a text
sample using the current foreground and background colors appears in the Sample
text display area.

To choose a different foreground color for the selected token type, click on
one of the color buttons in the Color palette. Text shown in the Sample text
display area changes to show the new foreground color.

To choose a foreground color for a different token type, you must first select
the desired token type from the Token type field.


ΓòÉΓòÉΓòÉ <hidden> Background ΓòÉΓòÉΓòÉ

Select this radio button to see the background color used for the current token
type.  The name of the current token type is shown in the Token type field.

Available colors are shown in the Color palette display area, with the button
corresponding to the current background color outlined in black.  Also, a text
sample using the current foreground and background colors appears in the Sample
text display area.

To choose a different background color for the selected token type, click on
one of the color buttons in the Color palette. Text shown in the Sample text
display area changes to show the new background color.

To choose a background color for a different token type, you must first select
the desired token type from the Token type field.

If you want the background color chosen for the current token type applied to
all other token types, press the Change all backgrounds push button.


ΓòÉΓòÉΓòÉ <hidden> Change all backgrounds ΓòÉΓòÉΓòÉ

Push this button to change the background color of all token types to the
background color of the currently-selected token.


ΓòÉΓòÉΓòÉ <hidden> Type style ΓòÉΓòÉΓòÉ

Select one or more of the following check boxes to set type styles for the item
selected in the Token type list:

 o Reverse
 o Bold
 o Italic
 o Underline.

 To see an example of the type styles you choose, look at the Sample field.


ΓòÉΓòÉΓòÉ <hidden> Save settings ΓòÉΓòÉΓòÉ

Select this check box to save your changes to apply to future files, and to
associate them with the language profile displayed in the Language profile
output field.


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Applys the changes you have made in this window, and return to the
             Editor.

 Test        Apply the changes you have made to the Editor, but do not close
             the Token attributes window. You can still cancel these changes if
             you want, by clicking on the Cancel push button.

 Cancel      Close this window without applying any of the changes you have
             made, and return to the Editor.

 Help        Display help for the item where the cursor is positioned. To get
             general help for the entire window, press F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Undo Options ΓòÉΓòÉΓòÉ

Use this window to specify the number of checkpoints that (up to 15) are undone
when you select Undo, and how you want to set checkpoints.


ΓòÉΓòÉΓòÉ <hidden> Maximum Number of Checkpoints ΓòÉΓòÉΓòÉ

Initially, this field displays the maximum number of checkpoints that can
stored by the Editor, as set by the current value of the history parameter.

Type an integer value from 0 to 15 inclusive to specify the maximum number of
checkpoints that the Editor can store.

If the value in this field is zero, you will not be able to use the Undo
feature.


ΓòÉΓòÉΓòÉ <hidden> Checkpointing ΓòÉΓòÉΓòÉ

Select one radio button to specify how checkpointing is enabled:

 Automatic checkpoint Checkpoints are set automatically by your editor session.

 Manual checkpoint You set checkpoints when you want.

 No checkpointing Checkpoints are not set, and you cannot undo them.

 For more information about checkpoints, refer to the following items in the
 Editor Command Reference.

 o autocheck Parameter
 o check Command
 o history Parameter


ΓòÉΓòÉΓòÉ <hidden> Push buttons ΓòÉΓòÉΓòÉ

Select one of the following push buttons:

 OK          Save the options you have selected, and close the Undo options
             window.

 Cancel      Close the Undo options window without applying any of the options
             you have selected.

 Help        Display online help information for the item where the cursor is
             positioned. To display general help for the entire window, press
             F2 from the Help window.


ΓòÉΓòÉΓòÉ <hidden> Customize keys ΓòÉΓòÉΓòÉ

Use this window to define the behavior of certain keyboard keys in the editor.
To do this, follow these steps:

  1. Select a personality from the Base behavior drop-down list.

  2. Select a key from the Select a key list.

  3. Select one of the predefined behaviors for the currently selected key from
     the Select an action list.

  4. The Make accelerator push button is enabled for any predefined behavior
     that can also be invoked from the Editor menu bar. Click on this push
     button to define a key or key combination as the accelerator for such
     predefined behaviors.

  5. Repeat the previous steps for any other key behaviors you wish to modify.

  6. Select the OK push button to bestow the new definitions upon the keys for
     the current editor session.  To make the definitions permanent select the
     Save key behavior choice, under the key behavior choice in the Options
     pull-down menu.

 Warning:  The keys help defines only the default Editor key behaviours, and
 may be incorrect if applied to other Editor personalities or customized key
 behaviours.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

The directories in which the Editor files are installed vary by the product it
accompanies. Current products and their base directories are:

 CODE                \code\lpex
 VisualAge C++       \ibmcppw