(empty message)

cfgs/config/goldhelp.cfg

@@ -331,41 +331,91 @@ Here is a small "ruler" for the actual definitions below:
 
 *B 3006,Find String
 
- You can enter several strings, separated by the '|' search string separator
- character like this:
+ * Four different pattern matching algorithms to chose from:
+   Plain (same as always).
+   Shell-style wildcard matching (using * and ?).
+   Regex. Uses the FSF extended regular expression library.
+   Fuzzy matching. Like plain, but allows one or more mismatches.
 
-   Odinn|GoldED
+ * Logic expressions with "and", "or", "not" can be used.
 
- By default, GoldED searches forward (next messages), but by preceeding the
- search string with a '-', the search goes backwards (previous messages).
+ * Spaces and option characters can be included in patterns.
 
- Besides the backward search, there are a number of other search command
- characters. Here is the complete list:
+ * Exclude or include kludges, tagline, tearline, origin, signature.
 
-   -   Search backward.
-   +   Search forward. (Just for completeness).
-   <   Search the From: field.
-   >   Search the To: field.
-   :   Search the Subj: field.
-   =   Case-sensitive search.
-   !   Reverse - Stop/mark when the search string(s) are NOT found.
-*P
+ -   Search backward.          Must be first character, if used.
+ +   Search forward (default). Must be first character, if used.
+ !   Logic not (match when NOT found).
+ &   Logic and (match this AND that).
+ |   Logic or (match this OR that).
+ <   Match "from" header field.
+ >   Match "to header field.
+ :   Match "subject" header field.
+ #   Match message body (but not any control lines).
+ .   Match tagline.
+ _   Match tearline.
+ *   Match origin line.
+ @   Match signature.
+ %   Match kludges/headerlines.
+ =   Match case-sensitive (defaults to not case-sensitive).
+ '   Do not match. Place after an option.
+ ^^   Toggle match. Place after an option.
+ ?p  Plain search (default).
+ ?r  Regex search.
+ ?w  Wildcard search.
+ ?f  Fuzzy search with one mismatch allowed.
+ ?f2 Fuzzy search with two mismatches allowed.
+ ?f3 Fuzzy search with three mismatches allowed.
 
- By default the '<', '>' and ':' search commands are enabled, so that GoldED
- searches all header fields. However, when one of these options are actually
- used, the search is limited to those only.
+ You can enclose a pattern string with double ("") or single ('') quotes if
+ you want to match a sentence with spaces or which contains option
+ characters.
 
- Examples:
+ The backslash is a literal-escape character. If a backslash is found, the
+ next character is treated as part of the pattern, not as an option
+ character. Use this for example to search for a sentence with quotes and
+ spaces.
 
-   <Odinn      Searches in the From: field only.
-   <>Odinn     Searches in From: and To:, but not Subj:.
-   :tagline    Search for "tagline" in the Subj: field only.
+ Spaces are used as separation characters and are ignored, except when
+ enclosed in quotes.
 
- The search command characters are stripped before the search is started. If
- you need to search for a string that begins with a search command character,
- you must precede it with the search string separator, like this:
+ The first set of option characters on a search expression line is used as
+ the "global default". The next set of option characters is bound to the
+ following pattern. A pattern is completed by the end of the line or by the
+ logic options '&' or '|'.
 
-   -|++        Search backwards for the string "++".
+ If none of the options '<', '>' or ':' are used in the global default part,
+ the default is to search all three.
+
+ Some examples:
+
+ To search for the authors name, allowing most common misspellings:
+   ?f1 odinn     (matches odin, odinn, oddin, odiin etc)
+
+ To search for OS/2 and Warp 4:
+   OS/2 & "Warp 4"
+
+ To search for any occurrance of Odinn or Dirk in the from-line:
+   < Odinn | Dirk
+
+ To search for zip file announcements using wildcard matching:
+   ?w "*.zip*"
+
+ To search case-sensitive for some string:
+   = "All Comes To Those Who Wait"
+
+ Some regular expression searches:
+   ?r "Warp *4"    (matches both "Warp 4" and "Warp4")
+   ?r "OS/*2" & "Warp *4"
+
+ NOTE: A common mistake is to forget to escape or quote-enclose option
+       characters in pattern strings. For example, what's wrong with this,
+       if you want to search for zip files:
+
+          ?w *.zip*
+
+       Nothing, but the first '*' is interpreted as if you want to search
+       in origin lines, which is not what you want.
 
  See also ^Marking String^.
 *E
@@ -650,6 +700,28 @@ Here is a small "ruler" for the actual definitions below:
 
 --------------------------------------------------------------------------------
 
+*B 6000,Addressbook
+
+ Esc            Abort addressbook browsing
+ Home           First node
+ End            Last node
+ Right          Next node
+ Left           Previous node
+ Enter          Select or edit node (depending on the mode)
+ Del            Soft delete node
+ Alt-P          Zap deleted entries
+*E
+
+--------------------------------------------------------------------------------
+
+*B 6001,Addressbook Editor
+
+ To save changes press Ctrl-Enter or press Enter at the bottom field, to
+ discard changes press Esc.
+*E
+
+--------------------------------------------------------------------------------
+
 *B 9001,Out Of Memory
 
  GoldED just ran out of memory. There is nothing you can do now except press