File psl-1983/3-1/doc/nmode/nm-searching.ibm artifact a1fc13b41f part of check-in f16ac07139


,MOD
- R 44X (11 April 1983) <PSL.NMODE-DOC>NM-SEARCHING.ibm
PLA 97_LAS 80 0_FIR 2_INT 1 6.0_TYP 160 163 162 193_INP 12 101_MAR 2
,END
,PRO
201 OUT 160_202 OUT 163_203 OUT 162_204 OUT 193
205 INP 12 101_206 INP 12 102
,END
,DEFINE
 UNIT SPACE
 FUNCTION
,END

          201/NMODE Manual (Searching)                                          Page 12-1


          202/12.  Searching

            201/Like other editors, NMODE has commands for searching for an occurrence of
          a string.  The search command is unusual in that it is 202/incremental201/; it begins
          to search before you have finished typing the search string.  As you type in
          the search string, NMODE shows you where it would be found.  When you
          have typed enough characters to identify the place you want, you can stop.
          Depending on what you will do next, you may or may not need to terminate
          the search explicitly with an Escape (Execute on the hp9836) first.

                  C-S        Search forward.
                  C-R        Search backward.

            The command to search is C-S (203/incremental-search-command201/).  C-S reads in
          characters and positions the cursor at the first occurrence of the characters
          that you have typed.  If you type C-S and then F, the cursor moves right
          after the first "F".  Type an "O", and see the cursor move to after the first
          "FO".  After another "O", the cursor is after the first "FOO" after the place
          where you started the search.  At the same time, the "FOO" has echoed at
          the bottom of the screen.

            If you type a mistaken character, you can delete it.   After the FOO,
          typing a Backspace makes the "O" disappear from the bottom of the screen,
          leaving only "FO".  The cursor moves back to the "FO".  Deleting the "O"
          and "F" moves the cursor back to where you started the search.

            When you are satisfied with the place you have reached, you can type an
          Escape, which stops searching, leaving the cursor where the search brought
          it.   Also, any command not specially meaningful in searches stops the
          searching and is then executed.  204/1 201/Thus, typing C-A would exit the search
          and then move to the beginning of the line.  escape is necessary only if the
          next command you want to type is a printing character, Rubout, Backspace,
          Escape, C-Q, or another search command, since those are the characters that
          have special meanings inside the search.

            Sometimes you search for "FOO" and find it, but not the one you expected
          to find.  There was a second FOO that you forgot about, before the one you
          were looking for.  Then type another C-S and the cursor will find the next
          FOO.  This can be done any number of times.  If you overshoot, you can
          delete the C-S's.

            After you exit a search, you can search for the same string again by
          typing just C-S C-S: one C-S command to start the search and then another
          C-S to mean "search again".


          ______________________________

          201/ 1.  A few other commands are not executed after a search.  Most special
          function keys send commands which begin with Escape.  This escape is taken
          as terminating the search, and the rest of the command is then executed.
          ESC-A, for instance, will terminate the search and insert A, instead of
          terminating the search and jumping up a line.
          201/Page 12-2                                          NMODE Manual (Searching)


            If your string is not found at all, the echo area says "Failing I-Search".
          The cursor is after the place where NMODE found as much of your string as
          it could.  Thus, if you search for FOOT, and there is no FOOT, you might
          see the cursor after the FOO in FOOL.   At this point there are several
          things you can do.  If your string was mistyped, you can rub some of it out
          and correct it.  If you like the place you have found, you can type Escape
          or some other NMODE command to "accept what the search offered".  Or you
          can type C-G, which throws away the characters that could not be found (the
          "T" in "FOOT"), leaving those that were found (the "FOO" in "FOOT").  A
          second C-G at that point undoes the search entirely.

            The C-G "quit" command does special things during searches; just what,
          depends on the status of the search.  If the search has found what you
          specified and is waiting for input, C-G cancels the entire search.   The
          cursor moves back to where you started the search.  If C-G is typed while
          the search is actually searching for something or updating the display, or
          after search failed to find some of your input (having searched all the way to
          the end of the file), then only the characters which have not been found are
          discarded.  Having discarded them, the search is now successful and waiting
          for more input, so a second C-G will cancel the entire search.  Make sure
          you wait for the first C-G to ring the bell before typing the second one; if
          typed  too  soon,  the  second  C-G may be confused with the first and
          effectively lost.

            You can also type C-R at any time to start searching backwards.  If a
          search fails because the place you started was too late in the file, you should
          do this.  Repeated C-R's keep looking for more occurrences backwards.  A
          C-S starts going forwards again.  C-R's can be rubbed out just like anything
          else.  If you know that you want to search backwards, you can use C-R
          instead  of  C-S  to  start  the  search,  because  C-R  is  also a command
          (203/reverse-search-command201/) to search backward.

            All sorts of searches in NMODE normally ignore the case of the text they
          are searching through; if you specify searching for FOO, then Foo and foo
          are also considered a match.

REDUCE Historical
REDUCE Sourceforge Project | Historical SVN Repository | GitHub Mirror | SourceHut Mirror | NotABug Mirror | Chisel Mirror | Chisel RSS ]