diff options
Diffstat (limited to 'diffbas.rst')
| -rw-r--r-- | diffbas.rst | 57 |
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 |