t-out, t-resume and t-sheet documented

This commit is contained in:
Abraham Toriz 2022-09-27 21:42:49 -04:00
parent 22510dfcd2
commit f3b4c99760
No known key found for this signature in database
GPG Key ID: D5B4A746DB5DD42A
1 changed files with 60 additions and 0 deletions

View File

@ -398,14 +398,69 @@ dash for the previous one.
t-out
.....
``t o|out [--at TIME]``
End the active entry in the current timesheet, if any. End time is set as the
current time unless ``--at`` is passed, case in which the specified time is set
as end time for the entry. See :ref:`specifying-times` to learn the accepted
formats.
t-resume
........
``t r|resume [OPTIONS]``
If called without arguments this command will start a new entry with the same
note as the last started entry in the current sheet. It is an easy way of
continuing with a task that was suspended.
To restart an entry with one of the last 10 unique notes pass ``--interactive``
which will show an UI like this:
.. code:: text
Latest entries of sheet 'dafault':
# Note Total time Last started
5 try to find a pair for this sock 11:35:35 1 week ago
4 pensar en la inmortalidad del cangrejo 1:31:09 1 week ago
3 cook fried rice 0:50:03 4 days ago
2 investigate quantum mechanics 10:59:17 11 hours ago
1 turn lead into gold 1:24:14 10 hours ago
enter number or q to cancel
>>
The number of unique entries shown is configurable with the
:ref:`interactive_entries` setting. To proceed pass any of the shown numbers of
the left column and press intro or enter q or Ctrl+D to exit.
To restart an entry whose ID you know pass ``--id ID``.
**Options**
-i, --interactive
Select one of the latest unique entries interactively
--id ID
Resume entry by its ID
.. _t-sheet:
t-sheet
.......
``t s|sheet [SHEET]``
Switch to a timesheet with name ``SHEET``, creating it if it doesn't exist. If
used without arguments this command is an alias to :ref:`t-list` so you can see
what timesheets you have.
``tiempo`` remembers the last sheet you used (unless it doesn't exist anymore),
so you can switch quickly between the current and the previous one passing ``-``
(a dash) as the sheet name.
t-today
.......
@ -457,6 +512,11 @@ append_notes_delimiter
require_note
............
.. _interactive_entries:
interactive_entries
...................
Per command default formatters
..............................