Search books by author's names

[m_librarian.git] / docs / command_line.rst

diff --git a/docs/command_line.rst b/docs/command_line.rst
index 0e63d97acd8b1d72fd34510848b54ca9fcd15acf..1739afc9b19491acc8ad5d141425a6548fbed1a9 100644 (file)
--- a/docs/command_line.rst
+++ b/docs/command_line.rst
@@ -31,7 +31,7 @@ ml-search.py
 
 Usage::
 
 
 Usage::
 

-    ml-search.py [-i] [-I] [-t {exact,start,substring}] ...
+    ml-search.py [-i] [-I] [-t] [-s] [-f] ...

 
 Search through the database and display results. Currently can only
 search authors by name.
 
 Search through the database and display results. Currently can only
 search authors by name.


@@ -40,9 +40,10 @@ Global options::
 
     -i, --ignore-case     ignore case (default is to guess)
     -I, --case-sensitive  don't ignore case
 
     -i, --ignore-case     ignore case (default is to guess)
     -I, --case-sensitive  don't ignore case

-    -t, --search-type {exact,start,substring}
-        search type: exact match, substring at the start (this is the default),
-        substring anywhere.
+    -t, --start           search type: substring at the start
+                          (this is the default)
+    -s, --substring       search type: substring anywhere
+    -f, --full            search type: match the full string

 
 Options ``-i/-I`` cannot be used together as they are the opposite. In
 case none of them are used the program guesses case-sensitivity by
 
 Options ``-i/-I`` cannot be used together as they are the opposite. In
 case none of them are used the program guesses case-sensitivity by


@@ -50,15 +51,16 @@ looking at the arguments. If all arguments are lowercase the program
 performs case-insensitive search. If there are UPPERCASE or MixedCase
 arguments the program performs case-sensitive search.
 
 performs case-insensitive search. If there are UPPERCASE or MixedCase
 arguments the program performs case-sensitive search.
 

-Option ``-t/--search-type`` defines the search type. Search types are:
+Options ``-t/-s/-f`` define the search type. Search types are:

 
 

-* exact - search for exact match; i.e. searching for "duck" returns
-  results for "duck" but not for "duckling";

 * start - search for substring at the start of the search field; for
   example searching for "duck" returns results for "duck" and "duckling"
   but not for "McDuck"; this is the default search type.
 * substring - search for any substring; "duck" => "duck", "duckling",
   "McDuck" (except for case-sensitive search, of course).
 * start - search for substring at the start of the search field; for
   example searching for "duck" returns results for "duck" and "duckling"
   but not for "McDuck"; this is the default search type.
 * substring - search for any substring; "duck" => "duck", "duckling",
   "McDuck" (except for case-sensitive search, of course).

+* full - search for exact match, compare the entire strings;
+  i.e. searching for "duck" returns results for "duck" but not for
+  "duckling";

 
 
 Author search
 
 
 Author search


@@ -66,7 +68,7 @@ Author search
 
 Usage::
 
 
 Usage::
 

-    ml-search.py [-i] [-I] [-t ...] author [-s surname] [-n name] [-m misc-name] [fullname]
+    ml-search.py [-i/-I] [-t/-s/-f] author [-s surname] [-n name] [-m misc-name] [fullname]

 
 Search and print a list of authors by surname/name/misc name/full name.
 
 
 Search and print a list of authors by surname/name/misc name/full name.
 


@@ -91,12 +93,13 @@ Example::
 Search and print a list of authors whose surname starts with "duck", and
 name starts with "mack", case insensitive.
 
 Search and print a list of authors whose surname starts with "duck", and
 name starts with "mack", case insensitive.
 

+

 Book search
 ^^^^^^^^^^^
 
 Usage::
 
 Book search
 ^^^^^^^^^^^
 
 Usage::
 

-    ml-search.py [-i] [-I] [-t ...] books [-t title] [-s series] [-a archive] [-f file] [-d]
+    ml-search.py [-i/-I] [-t/-s/-f] books [-t title] [-s series] [-a archive] [-f file] [-d] [--surname name] [--name name] [--misc-name name] [--fullname name] [-e ext] [-l lang]

 
 Search and print a list of books by title, series, archive or file name.
 
 
 Search and print a list of books by title, series, archive or file name.
 


@@ -108,25 +111,38 @@ Options::
     -f, --file file        Search by file name (without extension)
     -d, --details          Output more details about books;
                            repeat for even more details
     -f, --file file        Search by file name (without extension)
     -d, --details          Output more details about books;
                            repeat for even more details

+    --surname surname      Search by author's surname
+    --name name            Search by author's name
+    --misc-name misc. name Search by author's misc. name
+    --fullname name        Search by author's full name
+    -e, --ext ext          Search by file extension
+    -l, --lang lang        Search by language

 
 By default the program prints only titles of the found book. With one
 
 By default the program prints only titles of the found book. With one

-option `-d` it also prints the list of authors.
+option `-d` it also prints the list of authors and genres, and also
+series the book belongs to (if any) and the serial number of the book in
+the series. With two options `-d` (`-d -d` or simply `-dd`) it also
+prints the file date and language. With three `-d` it prints archive
+name, file name, extension and size, and flag if the book is marked to
+be deleted.
+

 
 Extension search
 ^^^^^^^^^^^^^^^^
 
 Usage::
 
 
 Extension search
 ^^^^^^^^^^^^^^^^
 
 Usage::
 

-    ml-search.py [-i] [-I] [-t ...] ext [name]
+    ml-search.py [-i/-I] [-t/-s/-f] ext [name]

 
 Search and print a list of extensions by name.
 
 
 Search and print a list of extensions by name.
 

+

 Genres search
 ^^^^^^^^^^^^^
 
 Usage::
 
 Genres search
 ^^^^^^^^^^^^^
 
 Usage::
 

-    ml-search.py [-i] [-I] [-t ...] genres [-n name] [-t title]
+    ml-search.py [-i/-I] [-t/-s/-f] genres [-n name] [-t title]

 
 Search and print a list of genres by name and title.
 
 
 Search and print a list of genres by name and title.
 


@@ -135,12 +151,13 @@ Options::
     -n, --name name    Search by name
     -t, --title title  Search by title
 
     -n, --name name    Search by name
     -t, --title title  Search by title
 

+

 Language search
 ^^^^^^^^^^^^^^^
 
 Usage::
 
 Language search
 ^^^^^^^^^^^^^^^
 
 Usage::
 

-    ml-search.py [-i] [-I] [-t ...] lang [name]
+    ml-search.py [-i/-I] [-t/-s/-f] lang [name]

 
 Search and print a list of languages by name.
 
 
 Search and print a list of languages by name.