Update docs

doc/markam.texi

@@ -62,21 +62,51 @@ The document was typeset with
 @node Usage, Copying This Manual, Top, Top
 @chapter How to use
 
-Markam can be run either as a script, or compiled to a binary.
+For the moment markam is a simple program, it has 3 functions.
-Compiling to binaries is recommended, but running is a script might be
-easier when debugginng/developing.
 
-For the moment markam is a simple program, it has 2 functions.  In
+@menu
-order to view a list of all your bookmarks you can use:
+* List::                        List all
+* Search::                      Search
+* Add::                         Add/Store/Save
+@end menu
+
+@node List, Search, Usage, Usage
+@section List all
+
+In order to view a list of all your bookmarks you can use:
 
 @example
 markam
 @end example
 
+@noindent
 This will show the list of all stored bookmarks, showing the URL, name
 and description.  This list is unsorted and unpaged.
 
-The other function is to add a new bookmark, which can be done with:
+@node Search, Add, List, Usage
+@section Search
+
+You can also search through your stored bookmarks by using the
+@code{search} command:
+
+@deffn Command search STRING
+Search through the database for any bookmarks that either have
+@var{string} as a tag or have @var{string} somewhere in its title.
+@end deffn
+
+@noindent
+To perform a search for any bookmarks that have ``markam'' as a tag
+and also any that have ``markam'' anywhere in their title you should
+use:
+
+@example
+markam search markam
+@end example
+
+@node Add,  , Search, Usage
+@section Add/Store/Save
+
+The last function is to add a new bookmark, which can be done with:
 
 @example
 markam http://example.org Example \
@@ -84,6 +114,7 @@ markam http://example.org Example \
        example some more tags
 @end example
 
+@noindent
 This will store the bookmark with the URL of ``http://example.org'',
 name ``Example'', description ``Some description about Example'' and
 the tags ``example'', ``some'', ``more'' and ``tags''.  Any arguments