From d234b36005c8d30b144dce79c94a069b5f076191 Mon Sep 17 00:00:00 2001 From: "B. Watson" Date: Thu, 11 Jul 2024 16:43:32 -0400 Subject: whichbas: update doc for multiple files. --- whichbas.rst | 27 ++++++++++++++++++++------- 1 file changed, 20 insertions(+), 7 deletions(-) (limited to 'whichbas.rst') 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 ==== -- cgit v1.2.3