- Area: BLUEWAVE --------------------------------------------------------------
  Msg#: 528                                          Date: 24 Feb 97 13:02:02
  From: Don Alt                                      Read: Yes   Replied: No
    To: All                                          Mark:                  
  Subj: BWave Keywords
-------------------------------------------------------------------------------
                           Revised: January 21, 1995

                               Blue Wave Keywords
                               ~~~~~~~~~~~~~~~~~~

     Note:  This FAQ file was written for Blue Wave v2.12 and lower, but the
     principles explained in this file still apply to all newer versions of
     Blue Wave although some of the commands -might- have been changed or
     modified.  It's the "concept" I'm trying to teach here that is
     important.

     Keywords are words that you want included in message packets you
     download from BBSes.  Doing a keyword search of an echo eliminates all
     messages in that echo _except_ the matches the keyword search finds,
     plus messages addressed to you. (Your name).

     There are two places we can do keyword searches.
     (1). While online the BBS in the Blue Wave door, via macros. (See next
          message). This is done prior to downloading a mail packet to reduce
          the amount of messages the mail packet contains.
     (2). The second place we use keywords is when we are offline and using
          the Blue Wave reader.

     The Blue Wave reader will do keyword searches in mail packets created by
     Blue Wave mail doors and any QWK mail door.

     By keyword searching echoes, we accept only the keyword matches found
     and reject all other messages in the echoes searched.  Therefore, we
     don't need to use a "Filter-word" to filter out unwanted messages from
     the echo areas we keyword search.

     In the Blue Wave mail door keyword searching is done only in the message
     header (From, To, & Subject fields).

     In the Blue Wave reader keyword searches are done in both the message
     header and in the message text (body of message). At the present time,
     the ! @ # keyword commands do not work in the Blue Wave doors. In fact,
     the optional ! in the door means something much different, it means,
     "start bundling immediately."  (This might be changed in newer versions
     of the Blue Wave doors).

                                Keyword Commands
                              for Blue Wave Reader

                  Presently used only in the Blue Wave reader.
          Below keyword symbols do not yet work in any Blue Wave door.

    (Bundling Command Macros are different and used in the Blue Wave door).
                               (See next Message)


     !  - this command searches: message text only.
          Finds: whole words and words-in-words.
          If a match is found it is highlighted only in the message text.

     @  - this command searches: the message headers only.
          Finds: whole words and words-in-words.
          If a match is found it is highlighted in both the message header
          and in the message text.

     #  - this command searches: message headers & message text.
          Finds: whole words only.
          If a match is found it is highlighted in both the message header
          and in the message text.

Note: A "word-in-word" is like the word "all" in: call, scallop, tally,
      called, specifically, generally, and etc.


                                Keyword Examples


Example 1a.  ----> Leah        \    Finds: "Leah" only.
Example 1b.  ----> Rozhon       }   Finds: "Rozhon" only.
Example 1c.  ----> Leah Rozhon /    Finds: "Leah Rozhon" only. *

Example 1 above, searches: message header and text. Notice that no keyword
commands were used.

Example 2a.  ----> #Leah        \    Finds: "Leah" only.
Example 2b.  ----> #Rozhon       }   Finds: "Rozhon" only.
Example 2c.  ----> #Leah Rozhon /    Finds: "Leah Rozhon" only. *

Example 2 above, searches: message header and text. It's the same as the
above except it finds "whole" words only. Thus, words-in-words aren't found.

Example 3a.  ----> @Leah        \    Finds: "Leah" only.
Example 3b.  ----> @Rozhon       }   Finds: "Rozhon" only.
Example 3c.  ----> @Leah Rozhon /    Finds: "Leah Rozhon" only. *

Example 3 above, searches: message header only. If a match is found it's
highlighted in both the message header and in the message text.

Example 4a.  ----> !Leah        \    Finds: "Leah" only.
Example 4b.  ----> !Rozhon       }   Finds: "Rozhon" only.
Example 4c.  ----> !Leah Rozhon /    Finds: "Leah Rozhon" only. *

Example 4 above, searches: only in the message text. If a match is found
it's highlighted in only the message text.

Example 5a.  ----> @#Leah        \    Finds: "Leah" only.
Example 5b.  ----> @#Rozhon       }   Finds: "Rozhon" only.
Example 5c.  ----> @#Leah Rozhon /    Finds: "Leah Rozhon" only. *

Example 5 above, searches: message header only, but for whole words. If
a match is found it's highlighted in both the message header and text.

* Note: In all examples, "Leah Rozhon" is considered 1 word, not two.
        Using "Leah Rozhon" as one keyword does not find either "Leah" or
        "Rozhon" individually. It only finds "Leah Rozhon" when separated
        by a space, because it is considered as being one (key)word.

           These shown below do NOT work due to conflicting commands.

Example 6a. ----> !@   -or- @!  + Keyword does _not_ work!
Example 6b. ----> !@#  -or- !#@ + Keyword does _not_ work!
Example 6c. ----> @!#  -or- @#! + Keyword does _not_ work!
Example 6d. ----> #!@  -or- #@! + Keyword does _not_ work!

                             Hope this helps!(tm),

                                      Don

     <Internet Email: Don.Alt@a20.gryn.org> * <Fido Netmail: 1:114/271.10>

... "Blue Wavers" are folks who love Blue Wave Offline Mail Products!
--- OMX/Blue Wave/DOS v2.30
 * Origin: The ALTernate Point! - Peoria, Arizona USA (1:114/271.10)

