mirror of
https://github.com/GothenburgBitFactory/timewarrior.git
synced 2025-07-27 12:16:25 +02:00
36 lines
1.2 KiB
Text
36 lines
1.2 KiB
Text
= timew-report(1)
|
|
|
|
== NAME
|
|
timew-report - run an extension report
|
|
|
|
== SYNOPSIS
|
|
[verse]
|
|
*timew* [*report*] _<report>_ [_<range>_] [_<tag>_**...**]
|
|
*timew* [*report*] _<report>_ _<id>_**...**
|
|
|
|
== DESCRIPTION
|
|
Runs an extension report, and supports filtering data.
|
|
The 'report' command itself is optional, which means that these two commands are equivalent:
|
|
|
|
$ timew report foo :week
|
|
$ timew foo :week
|
|
|
|
This does however assume there is a 'foo' extension installed.
|
|
|
|
The return code is the return code of the extension.
|
|
If the extension produces no output and a non-zero rc, then 255 is returned.
|
|
|
|
Filtering is either possible by range and/or tags, or by ids.
|
|
|
|
== CONFIGURATION
|
|
|
|
**reports.range**::
|
|
Sets the default date range for all reports.
|
|
The value has to correspond to a range hint, see **timew-hints**(7).
|
|
Defaults to `all`
|
|
|
|
**reports.**__<name>__**.range**::
|
|
Set the date range for report _name_, used if no _range_ is given on the command line.
|
|
Here, _name_ is the name of the report executable without its extension (i.e. a report executable 'foo.py' is referred to by 'foo').
|
|
The value has to correspond to a range hint, see **timew-hints**(7).
|
|
Defaults to the value of **reports.range**.
|