From bcc921bd2fc6bcd1cf45279a8497b230f8ebc700 Mon Sep 17 00:00:00 2001
From: Dave <orangechannel@pm.me>
Date: Sat, 4 Jan 2020 17:47:49 -0500
Subject: manpage: explain deprecated usage of multiple items with *-add

---
 DOCS/man/encode.rst | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/DOCS/man/encode.rst b/DOCS/man/encode.rst
index e897a342cf..6262f5dc5a 100644
--- a/DOCS/man/encode.rst
+++ b/DOCS/man/encode.rst
@@ -17,8 +17,9 @@ You can encode files from one format/codec to another using this facility.
 
     This is a key/value list option. See `List Options`_ for details.
 
-    ``--ofopts-add=<options1[,options2,...]>``
-        Appends the options given as arguments to the options list.
+    ``--ofopts-add=<option>``
+        Appends the option given as an argument to the options list. (Passing
+        multiple options is currently still possible, but deprecated.)
 
     ``--ofopts=""``
         Completely empties the options list.
@@ -42,8 +43,9 @@ You can encode files from one format/codec to another using this facility.
 
     This is a key/value list option. See `List Options`_ for details.
 
-    ``--oacopts-add=<options1[,options2,...]>``
-        Appends the options given as arguments to the options list.
+    ``--oacopts-add=<option>``
+        Appends the option given as an argument to the options list. (Passing
+        multiple options is currently still possible, but deprecated.)
 
     ``--oacopts=""``
         Completely empties the options list.
@@ -74,8 +76,9 @@ You can encode files from one format/codec to another using this facility.
 
     This is a key/value list option. See `List Options`_ for details.
 
-    ``--ovcopts-add=<options1[,options2,...]>``
-        Appends the options given as arguments to the options list.
+    ``--ovcopts-add=<option>``
+        Appends the option given as an argument to the options list. (Passing
+        multiple options is currently still possible, but deprecated.)
 
     ``--ovcopts=""``
         Completely empties the options list.
-- 
cgit v1.2.3