X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs%2Fcommand_line.rst;h=53fe92664797c1129b8ce15cf97bc77f0a8c2535;hb=6bd9bb41bc381bb2b30290f0135e96c5ff0911c4;hp=6347dff93f5241c56356427e0027b7ef6d076194;hpb=b1657c852615f0deac00c879d4f69a3166d6fcdf;p=m_librarian.git diff --git a/docs/command_line.rst b/docs/command_line.rst index 6347dff..53fe926 100644 --- a/docs/command_line.rst +++ b/docs/command_line.rst @@ -10,7 +10,7 @@ Command-line scripts 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. @@ -22,7 +22,7 @@ Usage:: 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. @@ -31,7 +31,7 @@ ml-search.py Usage:: - ml-search.py [-i] [-I] [-t {exact,start,substring}] ... + ml-search.py [-i] [-I] [-t] [-s] [-f] [-d] [-c] ... Search through the database and display results. Currently can only search authors by name. @@ -39,10 +39,14 @@ search authors by name. Global options:: -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. + -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 + -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 @@ -50,15 +54,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. -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). +* full - search for exact match, compare the entire strings; + i.e. searching for "duck" returns results for "duck" but not for + "duckling"; Author search @@ -66,9 +71,9 @@ Author search Usage:: - ml-search.py [-i] [-I] [-t ...] author [-s surname] [-n name] [-m misc-name] + 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. +Search and print a list of authors by surname/name/misc name/full name. Options:: @@ -88,7 +93,83 @@ Example:: 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. +With one option `-d` it also prints database id. + + +Book search +^^^^^^^^^^^ + +Usage:: + + ml-search.py [-i/-I] [-t/-s/-f] books [-t title] [-s series] [-a archive] [-f file] [--surname name] [--name name] [--misc-name name] [--fullname name] [-e ext] [--gname name] [--gtitle title] [-l lang] + +Search and print a list of books by title, series, archive or file name. + +Options:: + + -t, --title title Search by title + -s, --series series Search by series + -a, --archive archive Search by archive (zip file) + -f, --file file Search by file name (without extension) + --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 + --gname name Search by genre’s name + --gtitle title Search by genre’s title + -l, --lang lang Search by language + +By default the program prints only titles of the found book. With one +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 +^^^^^^^^^^^^^^^^ + +Usage:: + + ml-search.py [-i/-I] [-t/-s/-f] ext [name] + +Search and print a list of extensions by name. + +With one option `-d` it also prints database id. + + +Genres search +^^^^^^^^^^^^^ + +Usage:: + + ml-search.py [-i/-I] [-t/-s/-f] genres [-n name] [-t title] + +Search and print a list of genres by name and title. + +Options:: + + -n, --name name Search by name + -t, --title title Search by title + +With one option `-d` it also prints database id. + + +Language search +^^^^^^^^^^^^^^^ + +Usage:: + + ml-search.py [-i/-I] [-t/-s/-f] lang [name] + +Search and print a list of languages by name. + +With one option `-d` it also prints database id. + .. vim: set tw=72 :