From 80065945451b84f324430b9fcf4273c723a1cc0d Mon Sep 17 00:00:00 2001
From: "B. Watson" <urchlay@slackware.uk>
Date: Sat, 13 Jul 2024 00:03:51 -0400
Subject: diffbas: add man page.

---
 diffbas.rst | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 diffbas.rst

(limited to 'diffbas.rst')

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
-- 
cgit v1.2.3