80 lines
1.7 KiB
Plaintext
80 lines
1.7 KiB
Plaintext
= epubgrep(1)
|
|
:doctype: manpage
|
|
:Author: tastytea
|
|
:Email: tastytea@tastytea.de
|
|
:Date: 2021-05-23
|
|
:Revision: 0.0.0
|
|
:man source: epubgrep
|
|
:man manual: General Commands Manual
|
|
|
|
== NAME
|
|
|
|
epubgrep - Search tool for EPUB ebooks.
|
|
|
|
== SYNOPSIS
|
|
|
|
*epubgrep* [_OPTION_]… _PATTERN_ [_FILE_]…
|
|
|
|
== DESCRIPTION
|
|
|
|
*epubgrep* searches EPUB files in a similar way as grep. It uses the same names
|
|
for command line switches.
|
|
|
|
== OPTIONS
|
|
|
|
*-h*, *--help*::
|
|
Display a short help message and exit.
|
|
|
|
*V*, *--version*::
|
|
Show version, copyright and license.
|
|
|
|
*-E*, *--extended-regexp*::
|
|
_PATTERN_ is extended regular expression.
|
|
|
|
*-P*, *--perl-regexp*::
|
|
_PATTERN_ is Perl regular expression.
|
|
|
|
*-i*, *--ignore-case*::
|
|
Ignore case distinctions in pattern and data.
|
|
|
|
*-e* _PATTERN_, *--regexp* _PATTERN_::
|
|
Use _PATTERN_ for matching.
|
|
|
|
*-I* _FILE_, *--input-file* _FILE_::
|
|
Input file. Can be used more than once.
|
|
|
|
// == USAGE
|
|
|
|
// === Configuration
|
|
|
|
// == EXAMPLES
|
|
|
|
== FILES
|
|
|
|
*Configuration file*::
|
|
* If `XDG_CONFIG_HOME` is defined: `${XDG_CONFIG_HOME}/epubgrep.conf`
|
|
* If `HOME` is defined: `${HOME}/.config/epubgrep.conf`
|
|
* Otherwise: `epubgrep.conf`
|
|
|
|
|
|
== KNOWN BUGS
|
|
|
|
EPUB files with non-ASCII file names only work reliably when the system locale
|
|
uses an encoding which has the necessary characters. Technically EPUBs must use
|
|
UTF-8 for file names but it is usually recommended to only use ASCII (ASCII is
|
|
valid UTF-8). If your system locale is not UTF-8, files may be silently skipped.
|
|
You can work around this by calling epubgrep like this:
|
|
`LC_ALL="C.UTF-8" epubgrep`
|
|
|
|
== REPORTING BUGS
|
|
|
|
Bugtracker: https://schlomp.space/tastytea/epubgrep/issues
|
|
|
|
E-mail: tastytea@tastytea.de
|
|
|
|
== SEE ALSO
|
|
|
|
*perlre*(1)
|
|
|
|
// LocalWords: epubgrep
|