From d234b36005c8d30b144dce79c94a069b5f076191 Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Thu, 11 Jul 2024 16:43:32 -0400
Subject: whichbas: update doc for multiple files.

---
 whichbas.1 | 29 +++++++++++++++++++++--------
 1 file changed, 21 insertions(+), 8 deletions(-)

(limited to 'whichbas.1')

diff --git a/whichbas.1 b/whichbas.1
index ade192e..8c452ff 100644
--- a/whichbas.1
+++ b/whichbas.1
@@ -27,21 +27,29 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "WHICHBAS" 1 "2024-07-09" "0.2.1" "Urchlay's Atari 8-bit Tools"
+.TH "WHICHBAS" 1 "2024-07-11" "0.2.1" "Urchlay's Atari 8-bit Tools"
 .SH NAME
 whichbas \- Determine BASIC variant of a tokenized Atari 8-bit program
 .SH SYNOPSIS
 .sp
-whichbas [\-v] \fIinput\-file\fP
+whichbas [\-v] \fIinput\-file\fP [\fIinput\-file\fP ...]
 .SH DESCRIPTION
 .sp
-\fBwhichbas\fP 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.
+\fBwhichbas\fP 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.
 .sp
-\fIinput\-file\fP must be an actual file. \fBwhichbas\fP can\(aqt read from
+\fIinput\-file\fPs must be actual files. \fBwhichbas\fP can\(aqt read from
 standard input, because it seeks in the input file.
+.sp
+With multiple \fIinput\-file\fPs, the output is one line per file,
+with the filename, a tab, and the detected BASIC. With only one
+\fIinput\-file\fP, the filename and tab are not printed.
 .SH OPTIONS
+.sp
+\fINote\fP: none of the options \fB\-s\fP \fB\-k\fP \fB\-v\fP are allowed
+when checking multiple files; they only work if there\(aqs just one
+\fIinput\-file\fP argument.
 .SS Detection Options
 .INDENT 0.0
 .TP
@@ -127,8 +135,13 @@ ELF binaries, etc) as a convenience, but I wouldn\(aqt rely on
 \fBwhichbas\fP\(aqs non\-BASIC file type detection if I were you.
 If you need the \fBfile\fP(1) command, use it.
 .sp
-\fBwhichbas\fP knows nothing about other BASICs such as Frost BASIC,
-or Altirra BASIC.
+\fBwhichbas\fP knows nothing about other BASICs such as Frost BASIC or
+Altirra BASIC.
+.sp
+When using multiple \fIinput\-file\fP arguments, a separate instance of
+\fBwhichbas\fP is spawned for each file. This isn\(aqt the most efficient
+approach, but it shouldn\(aqt cause problems on reasonably modern
+systems.
 .SH BUGS
 .SS Misdetection
 .sp
-- 
cgit v1.2.3