~1~
Search String Specification
---------------------------

You are being prompted to enter a string of characters which will specify
the search target in the current buffer.

You have four options at this point:

      1. Enter a normal search string and press RETURN, or
      2. Press PF1, enter a control character search string and press RETURN, or
      3. Press KP7, enter a pattern search string and press RETURN, or
      4. Abort the search operation by pressing ^Z (or any other standard
         terminator, such as RETURN).

There are three modes of string searching in this editor:

      1. Normal

          Any printable (of ASCII value 32 through 126) character can be a
          component of a normal search string. This is the default mode,
          and the one for which you are currently being prompted.

      2. Control

          In addition to the above set of characters, control characters
          (of ASCII value 0 through 31) may be included in this mode's
          search string.

          A control character is preceeded by the caret (^) character,
          followed by the printable character whose "control" version
          would represent the actual item. For example:

              a. A tab (ASCII value is nine) is represented as ^I
              b. A form feed is specified as ^L

          Normal and control characters may be mixed in this mode:

              ^[Y would be read as "<Escape>Y"

          The only printable character which can not be specified while
          in this mode is the caret.

          To enter control search mode from your present state, exit this
          window and press PF1 on the application keypad.

      3. Pattern

          This very powerful method allows specification of wildcards
          and Boolean operations for search operations.

          Operations supported are:

              *   multiple character wildcard
              %   single character wildcard
              \   forces next character to be treated as a literal
              &   AND
              |   OR (vertical bar)
              (   begins association
              )   ends assocation

          Examples:

              DU*[                would match DU[
                                              DU:[
                                              DUA:[
                                              DUA0:[

              DU%%%[              would match DUA0:[
                                              DUA1:[
                                              DUB2:[

              *DUA0:              would match from the beginning of the line
                                  to the location within the same line where
                                  the string "DUA0:" is found

              DUA0:*              would match from the string "DUA0:" to the end
                                  of that line

              DUA0|DQA0|DRA0      would match DUA0
                                              DQA0
                                              DRA0

              DUA(0|1|2|3)        would match DUA0    Note that "&" is implicit
                                              DUA1
                                              DUA2
                                              DUA3

              D%A(0|1)            would match DUA0
                                              DUA1
                                              DQA0
                                              DQA1
                                              DRA0
                                              DRA1

              \(between \)        forces a search for the string "(between)"

              *between*           would match any entire line with "between"

              *                   would match the entire current line


          There is one major type of operation which is not supported. It
          consists of a pattern which contains a wildcard, followed immediately
          by a special pattern character, such as:

              AB*(CD|EF)

          Wildcards with OR operations are still permitted, as long as you have
          at least one regular character after the "*":

              AB*1(CD|EF)

          One thing to keep in mind is the method of search employed (most often
          it is seek searching). Just remember that once a match is found,
          the next search resumes (except in special cases) from that point.
          Thus, when one is employing special OR patterns, you may not get what
          you quite expect (because the search will not restart at the original
          position if a match has been made).

          Control characters may not be used in pattern searching (that is,
          "^I" will be interpreted as two characters, "^" and "I", not as
          ASCII nine).
~2~
Search String Specification
---------------------------

You are being prompted to enter a string of characters which will specify
the control character search target in the current buffer.

You have two options at this point:

      1. Enter a control character search string and press RETURN, or
      2. Abort the search operation by pressing ^Z (or any other standard
         terminator, such as RETURN).

In addition to the normal set of characters, control characters
(of ASCII value 0 through 31) may be included in this mode's
search string.

A control character is preceeded by the caret (^) character,
followed by the printable character whose "control" version
would represent the actual item. For example:

      a. A tab (ASCII value is nine) is represented as ^I
      b. A form feed is specified as ^L

Normal and control characters may be mixed in this mode:

      ^[Y would be read as "<Escape>Y"

The only printable character which can not be specified while
in this mode is the caret.
~3~
Search String Specification
---------------------------

You are being prompted to enter a string of characters which will specify
the pattern search target in the current buffer.

You have two options at this point:

      1. Enter a pattern search string and press RETURN, or
      2. Abort the search operation by pressing ^Z (or any other standard
         terminator, such as RETURN).


Pattern searching is a very powerful method which allows specification
of wildcards and Boolean operations for search operations.

Operations supported are:

      *   multiple character wildcard
      %   single character wildcard
      \   forces next character to be treated as a literal
      &   AND
      |   OR (vertical bar)
      (   begins association
      )   ends assocation

Examples:

      DU*[                would match DU[
                                      DU:[
                                      DUA:[
                                      DUA0:[

      DU%%%[              would match DUA0:[
                                      DUA1:[
                                      DUB2:[

      *DUA0:              would match from the beginning of the line
                          to the location within the same line where
                          the string "DUA0:" is found

      DUA0:*              would match from the string "DUA0:" to the end
                          of that line

      DUA0|DQA0|DRA0      would match DUA0
                                      DQA0
                                      DRA0

      DUA(0|1|2|3)        would match DUA0    Note that "&" is implicit
                                      DUA1
                                      DUA2
                                      DUA3

      D%A(0|1)            would match DUA0
                                      DUA1
                                      DQA0
                                      DQA1
                                      DRA0
                                      DRA1

      \(between \)        forces a search for the string "(between)"

      *between*           would match any entire line with "between"

      *                   would match the entire current line


There is one major type of operation which is not supported. It
consists of a pattern which contains a wildcard, followed immediately
by a special pattern character, such as:

      AB*(CD|EF)

Wildcards with OR operations are still permitted, as long as you have
at least one regular character after the "*":

      AB*1(CD|EF)

One thing to keep in mind is the method of search employed (most often
it is seek searching). Just remember that once a match is found,
the next search resumes (except in special cases) from that point.
Thus, when one is employing special OR patterns, you may not get what
you quite expect (because the search will not restart at the original
position if a match has been made).

Control characters may not be used in pattern searching (that is,
"^I" will be interpreted as two characters, "^" and "I", not as
ASCII nine).
~4~
Replacement String Specification
--------------------------------

You are being prompted to enter a string of characters to be used in replacing
an occurence of the earlier-specified target in the current buffer.

You have three options at this point:

      1. Enter a normal replacement string and press RETURN, or
      2. Press PF1, enter a control character string and press RETURN, or
      3. Abort the search operation by pressing ^Z (or any other standard
         terminator, such as RETURN).

A control character is one that falls in the range of ASCII zero through
ASCII 31.

A control character is preceeded by the caret (^) character,
followed by the printable character whose "control" version
would represent the actual item. For example:

      a. A tab (ASCII value is nine) is represented as ^I
      b. A form feed is specified as ^L

Normal and control characters may be mixed in control character mode:

      ^[Y would be read as "<Escape>Y"
~5~
Replacement String Specification
--------------------------------

You are being prompted to enter a string of control and normal characters to be
used in replacing an occurence of the earlier-specified target in the current
buffer. 

You have two options at this point:

      1. Enter a replacement string and press RETURN, or
      2. Abort the search operation by pressing ^Z (or any other standard
         terminator, such as RETURN).

A control character is one that falls in the range of ASCII zero through
ASCII 31.

A control character is preceeded by the caret (^) character,
followed by the printable character whose "control" version
would represent the actual item. For example:

      a. A tab (ASCII value is nine) is represented as ^I
      b. A form feed is specified as ^L

Normal and control characters may be mixed in this mode:

      ^[Y would be read as "<Escape>Y"
~6~
Replacement Mode
----------------

You are being prompted as to the desired action to be applied to the hi-lighted
field in the current buffer.

The string on the left side of the last line represents the current search
string.

There are several options available to you:

      1. Press RETURN and the currently hi-lighted field will be replaced
         with the middle string shown on the bottom line of the screen.

         The middle string represents the quantity loaded as the primary
         replacement string.

      2. Enter a normal string and press RETURN. The hi-lighted field will
         be replaced with the characters you just entered.

         This entry is not saved for repeated replacements; rather, it
         represents the capability of temporarily altering the primary
         replacement field.

      3. Press PF3. The alternate string (shown on the last line of the
         screen on the right) will replace the hi-lighted field.

      4. Enter a normal string and press PF3. The quantity will become the
         alternate replacement string. In addition, this new entry will
         replace the hi-lighted quantity.

      5. Press ENTER, placing yourself into a temporary alternate replacement
         field redefinition mode.

         In this mode, you can redefine the alternate replacement field
         in terms of control characters, as well as normal characters
         (or a combination of both).

         Enter a normal replacement string and press RETURN. This field will
         become the alternate replacement string, and will also replace the
         hi-lighted field.

         Or, press PF1 and then enter a control character replacement string
         (or a combination of control and normal characters). Again, this
         field will become the alternate replacement string, and will also
         replace the hi-lighted field.

      6. Press (keypad) MINUS. The hi-lighted field will be deleted.

      7. Press KP1. The hi-lighted field's case will be inverted.

      8. Press KP2. The hi-lighted field will be set to lower case.

      9. Press KP3. The hi-lighted field will be set to upper case.

     10. Press PF4. All remaining search string matches in the path of the
         current direction within the buffer will have the last action
         committed applied as the replacement action.

         For example, if the last keystroke in the current find-and-replace
         session was to press KP2 to set the target field to lower case, then
         all remaining matches in the buffer (in the current direction) will
         have their fields set to lower case.

     11. Press KP4 to force the search direction to be FORWARD. The first
         match field in the new direction is located and hi-lighted.

     12. Press KP5 to force the search direction to be REVERSE. The first
         match field in the new direction is located and hi-lighted.

     13. Press any other application keypad key (such as KP8), and the
         currently hi-lighted field will be left intact.

     14. Enter ^Z (<ctrl>Z) and the find-and-replace session will be aborted.
         The cursor will be left at the position of the previously visited
         match, unless it was the only match, in which case the cursor
         will be positioned to the location it occupied at the start of
         the operation.

As an aid to keeping the right hand on the keypad, KP9 performs the same
action as the RETURN key.
