aboutsummaryrefslogtreecommitdiff
path: root/diffbas.rst
diff options
context:
space:
mode:
Diffstat (limited to 'diffbas.rst')
-rw-r--r--diffbas.rst57
1 files changed, 57 insertions, 0 deletions
diff --git a/diffbas.rst b/diffbas.rst
new file mode 100644
index 0000000..0fd94c0
--- /dev/null
+++ b/diffbas.rst
@@ -0,0 +1,57 @@
+=======
+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**.
+
+COLOR
+=====
+By default, the output is colorized by **listbas**. If you want to use
+**diff**\'s **--color** option, you should use **-n** as a **listbas**
+option. Color diffs are most useful with **-u** (unified diff format),
+so the command would look like::
+
+ $ diffbas -u --color -- -n A.BAS B.BAS
+
+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