aboutsummaryrefslogtreecommitdiff
path: root/README.txt
blob: c0a02589fbfc35273a801b5cda7163b3a411cd04 (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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
unalf is a decompressor for the ALF file format, as used on the Atari
8-bit computers in the late 1980s.

Currently, unalf is working and has been fairly well tested against
various ALF archives.

The ultimate goal of this project is to reimplement the ALF
compression and decompression algorithms on modern systems aka
Linux and anything else that's POSIX-ish. It's also intended to
be a repository of information about the ALF archiver (and UNALF
dearchiver).

The original ALF/UNALF programs for the Atari were written by Alfred.
This project is by B. Watson (urchlay@slackware.uk).

The rest of this file is a list of the contents of the git repository
or distribution tar/zip file.

Included in both the source and binary distributions:

- README.txt - you're reading it now.

- TODO.txt - plans for the future.

- doc/Arcinfo - describes the format of ARC compressed files. The ALF
  file structure is almost identical to ARC's. This file was taken from
  the arc-5.21q source.

- doc/alf14.atr - the distribution disk for ALF version 1.4, as an Atari
  8-bit single-density floppy disk image. This likely isn't the original
  distribution disk, but it's the only one I've found on the various
  archive sites.

- doc/alf14_doc.txt - the documentation for ALF and UNALF, extracted
  from the disk image and converted from ATASCII to standard ASCII. Note
  that the filenames are different: LZ.COM for ALF14.COM and DZ.COM for
  UNALF14.COM.

- doc/fileformat.txt - documents how the ALF file format differs from ARC.

- doc/review.txt - a review of the original ALFCrunch, from an Atari
  magazine.

- examples/* - ALF files found in the wild.

Included in the source distribution only:

- BUILD.txt - directions for compiling unalf.

- src/ - the source.

- f65/ - "fake 6502" porting layer. Not for the faint of heart. The
  unalf algorithm was ported from a disassembly of the 6502 code,
  using a perl script to convert the 6502 mnemonics to C macros.
  This means I was able to port the code without fully understanding
  how it works...

- testing/alfls - a Perl script that lists the contents of an ALF
  archive. Run it with --help for more information. If you're
  packaging unalf for a distribution, there's no need to include this
  script in the package: I wrote it for testing purposes only. You can
  use "unalf -l" to list .alf files, so this is redundant.

- magic/ - "magic" that allows the file(1) command to identify ALF
  archive files. See magic/MAGIG.txt for details.

Included in the binary distribution only:

- README_Windows.txt.

- unalf.exe and alfsum.exe - the Windows executables.

- unalf.html and alfsum.html - the man pages, converted to HTML.