diff --git a/docs/source/index.rst b/docs/source/index.rst index 5c97bf4..4473e56 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -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 ..............................