add manpage entry for fietsctl track add

2 files changed, 21 insertions, 3 deletions

diff --git a/doc/man/fietsctl.rst b/doc/man/fietsctl.rst
index 1d30b20..8a91408 100644
--- a/doc/man/fietsctl.rst
+++ b/doc/man/fietsctl.rst
@@ -186,6 +186,26 @@ For each track, the following information is shown:
 * The track's owner (both name and email address)
 * The track's title.
 
+ADDING A TRACK
+##############
+
+.. code-block:: text
+
+    fietsctl track add [-c CONFIG] [-i/--id ID] [-e/--email] [--visibility PRIVATE|FRIENDS|FRIENDS_TAGGED|LOGGED_IN|PUBLIC] [--track-type ORGANIC|SYNTHETIC] FILENAME...
+
+Adds a track to the system. You specify the owner via the ``--id`` or
+``--email`` options, similar to the ``user modify`` command.
+
+One or multiple ``FILENAME`` might be given. Any supported input format may be
+used.
+
+The titles and dates are attempted to be read from the files. Other metadata
+(tags, images, ...) is left empty. The ``--visibility`` and ``--track-type``
+options can be used to set the visibility and type of the added tracks.
+
+For each file read, the resulting ID in the database is printed. If an error
+occurs for one file, the error is shown and the next track is read.
+
 REMOVING A TRACK
 ################
 
diff --git a/fietsboek/scripts/fietsctl.py b/fietsboek/scripts/fietsctl.py
index 7702f05..bd6aae8 100644
--- a/fietsboek/scripts/fietsctl.py
+++ b/fietsboek/scripts/fietsctl.py
@@ -412,9 +412,7 @@ def cmd_track_add(
 ):
     """Add a track.
 
-    The track is added for the specified user.
-
-    The track type is set to "organic" and the visibility to "private".
+    The track is added for the specified user (via --id/--email).
     """
     env = setup(config)
     if id_ is not None: