mirror of
https://git.notmuchmail.org/git/notmuch
synced 2024-12-27 20:01:42 +01:00
d6cbb24fcf
To describe the script and config file format, so folks don't have to dig through NEWS or the script's source to get that information. The Makefile and conf.py are excerpted from the main doc/ directory with minor simplifications and adjustments. The devel/nmbug/ scripts are largely independent of notmuch, and separating the docs here allows packagers to easily build the docs and install the scripts in a separate package, without complicating notmuch's core build/install process.
54 lines
1.1 KiB
ReStructuredText
54 lines
1.1 KiB
ReStructuredText
==============
|
|
notmuch-report
|
|
==============
|
|
|
|
SYNOPSIS
|
|
========
|
|
|
|
**notmuch-report** [options ...]
|
|
|
|
DESCRIPTION
|
|
===========
|
|
|
|
Generate HTML or plain-text reports showing query results.
|
|
|
|
OPTIONS
|
|
=======
|
|
|
|
``-h``, ``--help``
|
|
|
|
Show a help message, including a list of available options, and
|
|
exit.
|
|
|
|
``--text``
|
|
Output plain text instead of HTML.
|
|
|
|
``--config`` <PATH>
|
|
Load config from given file. The format is described in
|
|
**notmuch-report.json(5)**. If this option is not set,
|
|
**notmuch-report** loads the config from the Git repository at
|
|
``NMBGIT``. See :ref:`NMBGIT <NMBGIT>` for details.
|
|
|
|
``--list-views``
|
|
List available views (by title) and exit.
|
|
|
|
``--get-query`` <VIEW>
|
|
Print the configured query for view matching the given title.
|
|
|
|
ENVIRONMENT
|
|
===========
|
|
|
|
.. _NMBGIT:
|
|
|
|
``NMBGIT``
|
|
If ``--config PATH`` is not set, **notmuch-report** will attempt
|
|
to load a config file named ``notmuch-report.json`` from the
|
|
``config`` branch of the ``NMBGIT`` repository (defaulting to
|
|
``~/.nmbug``).
|
|
|
|
SEE ALSO
|
|
========
|
|
|
|
**notmuch(1)**, **notmuch-report.json(5)**, **notmuch-search(1)**,
|
|
**notmuch-tag(1)**
|
|
|