aboutsummaryrefslogtreecommitdiff
path: root/diffbas.rst
blob: 0fd94c03870ac6a265c3b564192ed7fad2c0b392 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
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