aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/man/fietsctl.rst20
-rw-r--r--fietsboek/scripts/fietsctl.py4
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: