From ef2ba0943d941b080946f85993e4383cd5e0b1a3 Mon Sep 17 00:00:00 2001
From: Wolfgang Müller
Date: Sat, 26 Oct 2024 21:21:54 +0200
Subject: Allow manually creating watch_later entries

This commit introduces the "add" command which allows the user to create
watch_later entries manually. Make sure to silently ignore entries that
already exist - we'll print the entire list of entries subsequently
anyway. Also, make explicitly specifying "add" optional if there's any
remaining arguments in argv.
---
 later.1 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

(limited to 'later.1')

diff --git a/later.1 b/later.1
index a4be6b0..b9f38b4 100644
--- a/later.1
+++ b/later.1
@@ -8,6 +8,10 @@
 .Nm
 .Op options
 .Op Ic list
+.Nm
+.Op options
+.Op Ic add
+.Ar item ...
 .Sh DESCRIPTION
 .Nm
 is a program to manage watch_later entries as created by
@@ -26,10 +30,20 @@ update titles of videos using yt-dlp
 .Pp
 The commands are as follows:
 .Bl -tag -width Ds
+.It Sy add Em item ...
+Creates watch_later entries for the given items.
+This command is implied if it wasn't explicitly given but there are
+remaining arguments.
 .It Sy list
 Lists all watch_later entries.
 This command is implied if there are no remaining arguments.
 .El
+.Pp
+An item may be a URL or a path to a file on the file system.
+Any command that modifies watch_later entries will subsequently print
+all entries just as if
+.Ic list
+was invoked.
 .Sh FILES
 .Bl -tag -width "1"
 .It Pa $XDG_CACHE_HOME/later/titles.json
-- 
cgit v1.2.3-2-gb3c3