From 3c62a20f48dc3e625f76acdd76c26bfb888d598e Mon Sep 17 00:00:00 2001 From: wm4 Date: Thu, 7 Dec 2017 10:51:22 +0100 Subject: manpage: clarify --sub-file(s) options This was a bit confused, and I bet nobody understood whether to use --sub-file or --sub-files, and what the difference is. Explicitly mention that both variants exist, and how they are related. --- DOCS/man/options.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index ffdde88676..b67d8fe120 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -1586,7 +1586,7 @@ Subtitles ``--sub-delay=`` Delays subtitles by ```` seconds. Can be negative. -``--sub-files=`` +``--sub-files=``, ``--sub-file=`` Add a subtitle file to the list of external subtitles. If you use ``--sub-file`` only once, this subtitle file is displayed by @@ -1598,7 +1598,11 @@ Subtitles and ``--secondary-sid`` to select the second index. (The index is printed on the terminal output after the ``--sid=`` in the list of streams.) - This is a list option. See `List Options`_ for details. + ``--sub-files`` is a list option (see `List Options`_ for details), and + can take multiple file names separated by ``:`` (Unix) or ``;`` (Windows), + while ``--sub-file`` takes a single filename, but can be used multiple + times to add multiple files. Technically, ``--sub-file`` is a CLI/config + file only alias for ``--sub-files-append``. ``--secondary-sid=`` Select a secondary subtitle stream. This is similar to ``--sid``. If a -- cgit v1.2.3