document --flat in changelog and man page

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changes
 
+## next
+
+- added `--flat` option to `list` that displays only available sheet names one
+  per line
+
 ## 1.5
 
 - First release to include the man page. Documentation is now published in

docs/source/index.rst

@@ -485,7 +485,7 @@ If you'd prefer to keep record of entries but have them out of the way use
 t list
 ......
 
-``t l|list [-a|--all]``
+``t l|list [-a|--all] [-f|--flat]``
 
 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
@@ -506,6 +506,18 @@ 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.
 
+**unreleased**
+
+Pass ``--flat`` to only display timesheet names one per line. Useful for passing
+the list to other commands (it is used for the different completion scripts).
+
+.. code:: shell-session
+
+   $ t l --flat
+   default
+   foo
+   pink
+
 .. _t-month:
 
 t month