aboutsummaryrefslogtreecommitdiff
path: root/README.txt
blob: cfa3e0a96e8111878978008ca254575758581f1d (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
unalf project README.

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).

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.