-=:[ ChangeLog ]:=-

20260824
- make it multiarch!
- make sure that the binary emits a proper version like all AmigaOS programs
20260821
- synchronize with the latest formalism
- add version and proper command-line arguments processing
- update test harness for more important tests

-=:[ About ]:=-

"arbor" is a command-line utility that reads paths from the standard command-
line input and then generates a visual tree by lookng at any overlapping path-
components. For example, the invocation:

arbor "/a" "/a/a" "/a/a/a" "/a/b/a"

will generate the tree:

root
 +
 |
 +---+ a
       +
       |
       +---+ a
       |     +
       |     |
       |     +---+ a
       |
       +---+ b/a

We wrote this utility because we find our filesystem-tree syntax way more
aesthetically pleasing and arbor does not rely on reading any actual filesystem
tree such that all the paths supplied on the command-line as input can be purely
fictive paths with "/" being the path-delimiter. With that said arbor should
work flawlessly on any architecture it is delivered for and works even better as
a scripting-language program (like node.js or python) but given minimalist
environments such as our beloved AmigaOS that cannot run complex JIT and/or
interpreters, we decied to release arbor as a C program instead.

-=:[ Usage ]:=-

Clicking the installer will copy the arbor binary to c: but all the executables
are to be found under the "c" folder after unpacking the LHA archive.

The arbor_test script uses the 68k binary to render some trees that are very
illustrative of the formalism and how it handles its edge cases.

-=:[ Further Documentation ]:=-

For what it is worth, the entire N-ary representation is formalized on the
following page:

  * https://grimore.org/computer_science/formalizing_our_complete_filesystem_tree_representation_model

that also includes links to various other implementations as well as floppies
for LLMs in case you wish to expand the formal system to include other features.

-=:[ Copyright and Credits ]:=-

Icons are from flaticon.com and our own contributions are licensed:

(C) 2026 Wizardry and Steamworks, MIT

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                  38600   38875  99.3% -lh5- 7e06 Aug 18 22:35 arbor.info
[Amiga]                   3844   15150  25.4% -lh5- eab5 Aug 24 06:39 arbor/arbor.c
[Amiga]                   1258    2563  49.1% -lh5- 8430 Aug 24 07:14 arbor/arbor.readme
[Amiga]                     56      56 100.0% -lh0- cdf1 Aug 18 22:35 arbor/arbor.readme.info
[Amiga]                   1597    9131  17.5% -lh5- 035d Aug 24 07:10 arbor/arbor_test
[Amiga]                  67804   68449  99.1% -lh5- 7c27 Aug 21 23:01 arbor/arbor_test.info
[Amiga]                   6135   10484  58.5% -lh5- a44a Aug 24 07:07 arbor/c/arbor_68k
[Amiga]                   6949   11672  59.5% -lh5- 4ff4 Aug 24 07:07 arbor/c/arbor_68020_fpu
[Amiga]                   6180   10300  60.0% -lh5- 6e1a Aug 24 07:07 arbor/c/arbor_68020_soft
[Amiga]                   6077   10616  57.2% -lh5- f9a0 Aug 24 07:07 arbor/c/arbor_kick13
[Amiga]                   4511    9140  49.4% -lh5- 3042 Aug 24 07:07 arbor/c/arbor_morphos
[Amiga]                   7954   19548  40.7% -lh5- 93d3 Aug 24 07:07 arbor/c/arbor_powerup
[Amiga]                   7083   15440  45.9% -lh5- 7795 Aug 24 07:07 arbor/c/arbor_warpos
[Amiga]                    758    2207  34.3% -lh5- 10a3 Aug 24 07:58 arbor/Install
[Amiga]                  35573   37363  95.2% -lh5- 69c2 Aug 18 22:37 arbor/Install.info
[Amiga]                   1236    4650  26.6% -lh5- 0480 Aug 24 06:39 arbor/Makefile
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        16 files  195615  265644  73.6%            Aug 24 10:44