aboutsummaryrefslogtreecommitdiff
path: root/diffbas.rst
diff options
context:
space:
mode:
authorB. Watson <urchlay@slackware.uk>2024-07-13 00:03:51 -0400
committerB. Watson <urchlay@slackware.uk>2024-07-13 00:03:51 -0400
commit80065945451b84f324430b9fcf4273c723a1cc0d (patch)
treefb7870ef0e4e93f103845727f9a811d274b7f2e0 /diffbas.rst
parent498ecbcfe4d3c4767e4b4275a443527a182cb773 (diff)
downloadbw-atari8-tools-80065945451b84f324430b9fcf4273c723a1cc0d.tar.gz
diffbas: add man page.
Diffstat (limited to 'diffbas.rst')
-rw-r--r--diffbas.rst48
1 files changed, 48 insertions, 0 deletions
diff --git a/diffbas.rst b/diffbas.rst
new file mode 100644
index 0000000..4bb2210
--- /dev/null
+++ b/diffbas.rst
@@ -0,0 +1,48 @@
+=======
+diffbas
+=======
+
+--------------------------------------------------------------
+Show differences between two tokenized Atari 8-bit BASIC files
+--------------------------------------------------------------
+
+.. include:: manhdr.rst
+
+SYNOPSIS
+========
+
+diffbas [*diff-options*] [**--** *listbas-options*] *file1* *file2*
+
+DESCRIPTION
+===========
+**diffbas** shows the differences between two tokenized (SAVEd)
+Atari BASIC programs, using **listbas**\(1) and **diff**\(1).
+
+OPTIONS
+=======
+**diffbas** takes no options of its own. It will pass options as-is
+to both **listbas** and **diff**. Use **--** to separate them: everything
+before **--** is passed to **diff**, and everything between **--** and
+the first filename is passed to **listbas**.
+
+EXAMPLE
+=======
+
+::
+
+ $ diffbas -u A.BAS B.BAS
+
+ --- A.BAS.lst 2024-07-12 23:56:46.937965855 -0400
+ +++ B.BAS.lst 2024-07-12 23:56:46.938965854 -0400
+ @@ -1,3 +1,4 @@
+ 10 ? "THIS LINE IS IN BOTH PROGRAMS."
+ 20 ? "THIS LINE IS ALSO IN BOTH."
+ +25 ? "THIS LINE ONLY IN B.BAS!"
+ 30 END
+
+EXIT STATUS
+===========
+0 for success. On failure, the exit status is that of whichever command
+failed (**listbas** or **diff**).
+
+.. include:: manftr.rst