======
a8diff
======

-----------------------------------------------------------
Show differences between two Atari 8-bit ATASCII text files
-----------------------------------------------------------

.. include:: manhdr.rst

SYNOPSIS
========

a8diff [*diff-options*] [**--** *a8cat-options*] *file1* *file2*

DESCRIPTION
===========
**a8diff** shows the differences between two ATASCII text files,
using **a8cat**\(1) and **diff**\(1).

OPTIONS
=======
**a8diff** takes no options of its own. It will pass options as-is
to both **a8cat** and **diff**. Use **--** to separate them: everything
before **--** is passed to **diff**, and everything between **--** and
the first filename is passed to **a8cat**.

EXAMPLE
=======

A.LST and B.LST were both created by the **LIST** command in BASIC.

::

  $ a8diff -u A.LST B.LST

  --- A.LST.txt	2024-07-12 23:56:46.937965855 -0400
  +++ B.LST.txt	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.LST!"
   30 END 

EXIT STATUS
===========
0 for success. On failure, the exit status is that of whichever command
failed (**a8diff** or **diff**).

.. include:: manftr.rst
