whichbas: update doc for multiple files.

1 files changed, 20 insertions, 7 deletions

diff --git a/whichbas.rst b/whichbas.rst
index 6b9a63f..8a7e15e 100644
--- a/whichbas.rst
+++ b/whichbas.rst
@@ -10,20 +10,28 @@ Determine BASIC variant of a tokenized Atari 8-bit program
 
 SYNOPSIS
 ========
-whichbas [-v] *input-file*
+whichbas [-v] *input-file* [*input-file* ...]
 
 DESCRIPTION
 ===========
-**whichbas** reads a tokenized Atari 8-bit BASIC, Turbo BASIC,
-BASIC XL, BASIC XE, BASIC/A+, or Atari Microsoft BASIC program and attempts to
-discover which BASIC is required to run it.
+**whichbas** reads tokenized Atari 8-bit BASIC, Turbo BASIC,
+BASIC XL, BASIC XE, BASIC/A+, or Atari Microsoft BASIC programs and attempts to
+discover which BASIC is required to run each one.
 
-*input-file* must be an actual file. **whichbas** can't read from
+*input-file*\s must be actual files. **whichbas** can't read from
 standard input, because it seeks in the input file.
 
+With multiple *input-file*\s, the output is one line per file,
+with the filename, a tab, and the detected BASIC. With only one
+*input-file*, the filename and tab are not printed.
+
 OPTIONS
 =======
 
+*Note*\: none of the options **-s** **-k** **-v** are allowed
+when checking multiple files; they only work if there's just one
+*input-file* argument.
+
 Detection Options
 -----------------
 
@@ -92,8 +100,13 @@ ELF binaries, etc) as a convenience, but I wouldn't rely on
 **whichbas**\'s non-BASIC file type detection if I were you.
 If you need the **file**\(1) command, use it.
 
-**whichbas** knows nothing about other BASICs such as Frost BASIC,
-or Altirra BASIC.
+**whichbas** knows nothing about other BASICs such as Frost BASIC or
+Altirra BASIC.
+
+When using multiple *input-file* arguments, a separate instance of
+**whichbas** is spawned for each file. This isn't the most efficient
+approach, but it shouldn't cause problems on reasonably modern
+systems.
 
 BUGS
 ====