diff options
author | B. Watson <urchlay@slackware.uk> | 2024-07-11 16:43:32 -0400 |
---|---|---|
committer | B. Watson <urchlay@slackware.uk> | 2024-07-11 16:43:32 -0400 |
commit | d234b36005c8d30b144dce79c94a069b5f076191 (patch) | |
tree | 8c9bb29a10dc571735fc903673d057a5ab86013f /whichbas.1 | |
parent | 2ffb4dcd0e788a68b9089f02838f4bba0b79dd2c (diff) | |
download | bw-atari8-tools-d234b36005c8d30b144dce79c94a069b5f076191.tar.gz |
whichbas: update doc for multiple files.
Diffstat (limited to 'whichbas.1')
-rw-r--r-- | whichbas.1 | 29 |
1 files changed, 21 insertions, 8 deletions
@@ -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 |