epubgrep/man/epubgrep.1.adoc

1.7 KiB

epubgrep(1) Manual Page

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.

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

SEE ALSO

perlre(1)