Document searching by database id

[m_librarian.git] / docs / command_line.rst

diff --git a/docs/command_line.rst b/docs/command_line.rst
index 0289a1e21228a3a678cd832d39c142e22eacb5fa..6aec9f83c545250952de87ee0e5c24fa7c96f562 100644 (file)
--- a/docs/command_line.rst
+++ b/docs/command_line.rst
@@ -10,7 +10,7 @@ Command-line scripts
 ml-initdb.py
 ------------
 
 ml-initdb.py
 ------------
 

-Initialize database and import genres list. Doesn't really needed as
+Initialize database and import genres list. Isn’t really needed as

 the next script does all that too.
 
 
 the next script does all that too.
 
 


@@ -22,7 +22,7 @@ Usage::
     ml-import.py [file.inpx ...]
 
 Initialize database, import genres list and import a list of INPX files
     ml-import.py [file.inpx ...]
 
 Initialize database, import genres list and import a list of INPX files

-listed in the command line. On subsequent runs doesn't destroy DB or
+listed in the command line. On subsequent runs doesn’t destroy DB or

 reimport genres; it also skips already import books but import new ones.
 
 
 reimport genres; it also skips already import books but import new ones.
 
 


@@ -31,7 +31,7 @@ ml-search.py
 
 Usage::
 
 
 Usage::
 

-    ml-search.py [-i] [-I] [-t] [-s] [-f] ...
+    ml-search.py [-i] [-I] [-t] [-s] [-f] [-d] [-c] ...

 
 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.


@@ -39,11 +39,14 @@ search authors by name.
 Global options::
 
     -i, --ignore-case     ignore case (default is to guess)
 Global options::
 
     -i, --ignore-case     ignore case (default is to guess)

-    -I, --case-sensitive  don't ignore case
+    -I, --case-sensitive  don’t ignore case

     -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
     -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

+    -d, --details         Output more details about found objects;
+                          repeat for even more details
+    -c, --count           Output count of found objects

 
 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


@@ -90,16 +93,18 @@ Example::
 
     ml-search.py -i author -s duck -n mack
 
 
     ml-search.py -i author -s duck -n mack
 

-Search and print a list of authors whose surname starts with "duck", and
+Search and print a list of authors whose surname starts with "duck" and

 name starts with "mack", case insensitive.
 
 name starts with "mack", case insensitive.
 

+With one option `-d` it also prints database id.
+

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

-    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] [--gname name] [--gtitle title] [-l lang]
+    ml-search.py [-i/-I] [-t/-s/-f] books [-t title] [-s series] [-a archive] [-f file] [--id id] [--surname name] [--name name] [--misc-name name] [--fullname name] [--aid aid] [-e ext] [--eid eid] [--gname name] [--gtitle title] [--gid gid] [-l lang] [--lid lid]

 
 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.
 


@@ -109,24 +114,27 @@ Options::
     -s, --series series    Search by series
     -a, --archive archive  Search by archive (zip file)
     -f, --file file        Search by file name (without extension)
     -s, --series series    Search by series
     -a, --archive archive  Search by archive (zip file)
     -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
+    --id id                Search by database id
+    --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
+    --aid aid              Search by author’s id

     -e, --ext ext          Search by file extension
     -e, --ext ext          Search by file extension

-    --gname name           Search by genre's name
-    --gtitle title         Search by genre's title
+    --eid eid              Search by extension’s id
+    --gname name           Search by genre’s name
+    --gtitle title         Search by genre’s title
+    --gid gid              Search by genre’s id

     -l, --lang lang        Search by language
     -l, --lang lang        Search by language

+    --lid lid              Search by language’s id

 
 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 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.
+option `-d` it also prints database id, 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
 
 
 Extension search


@@ -138,6 +146,8 @@ Usage::
 
 Search and print a list of extensions by name.
 
 
 Search and print a list of extensions by name.
 

+With one option `-d` it also prints database id.
+

 
 Genres search
 ^^^^^^^^^^^^^
 
 Genres search
 ^^^^^^^^^^^^^


@@ -153,6 +163,8 @@ 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
 

+With one option `-d` it also prints database id.
+

 
 Language search
 ^^^^^^^^^^^^^^^
 
 Language search
 ^^^^^^^^^^^^^^^


@@ -163,4 +175,6 @@ Usage::
 
 Search and print a list of languages by name.
 
 
 Search and print a list of languages by name.
 

+With one option `-d` it also prints database id.
+

 .. vim: set tw=72 :
 .. vim: set tw=72 :