document t-list and t-now

This commit is contained in:
Abraham Toriz 2022-09-26 23:45:51 -04:00
parent bd1785058e
commit 41a414d6d2
No known key found for this signature in database
GPG Key ID: D5B4A746DB5DD42A
1 changed files with 38 additions and 0 deletions

View File

@ -346,6 +346,27 @@ If you'd prefer to keep record of entries but have them out of the way use
t-list
......
``t l|list [-a|--all]``
Lists existing timesheets. Pass ``--all`` to also list hidden (archived) ones.
The output includes 4 columns: the name of the timesheet, the elapsed time of
the running entry, the accumulated time for the day and the total time (sum of
all entries per timesheet).
.. code:: text
Timesheet Running Today Total Time
default 0:00:00 0:00:00 2:39:38
- foo 0:00:00 0:30:01 0:30:01
* pink 0:00:00 0:05:04 0:05:04
--------------------------------------------
0:00:00 0:35:06 3:14:44
An asterisk (*) at the left will indicate the current timesheet and a dash (-)
indicates the previously used one. This is relevant for :ref:`t-sheet` where you
can use - as the timesheet name to just switch to the previous one.
t-month
.......
@ -359,12 +380,29 @@ Just like ``t-display`` this accepts ``--grep``, ``--ids``, and ``--format``.
t-now
.....
``t n|now``
Show only timesheets with running entries. Since every timesheet can only have
one running entry at a time this command displays its note.
.. code:: text
Timesheet Running Activity
* default 0:00:01 reading
- pink 0:00:21 gardening
Just like :ref:`t-list` it displays an asterisk for the current timesheet and a
dash for the previous one.
t-out
.....
t-resume
........
.. _t-sheet:
t-sheet
.......