-=:[ ChangeLog ]:=-

20260830
- add the -s/--scan flag to actually scan a filesystem
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.

arbor can be called with paths on the command-line in order to draw a tree using
the paths as input and without relying on the filesystem at all. However, it is
recently possible to also scan a filesystem path recursively using the -s/--scan
switch with the first parameter set to a path in order to have arbor generate a
tree from the path passed as parameter as the starting path.

-=:[ 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]                   4669   19812  23.6% -lh5- aea4 Aug 30 09:17 arbor/arbor.c
[Amiga]                   1436    3011  47.7% -lh5- 2d06 Aug 30 09:19 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]                   3173    4944  64.2% -lh5- aa05 Aug 30 09:20 arbor/c/arbor_68k
[Amiga]                   3161    4880  64.8% -lh5- fe7a Aug 30 09:20 arbor/c/arbor_68020_fpu
[Amiga]                   3135    4840  64.8% -lh5- c9ff Aug 30 09:20 arbor/c/arbor_68020_soft
[Amiga]                   6439   10968  58.7% -lh5- 3800 Aug 30 09:20 arbor/c/arbor_kick13
[Amiga]                   8469   20516  41.3% -lh5- 9eaa Aug 30 09:20 arbor/c/arbor_morphos
[Amiga]                   8870   22144  40.1% -lh5- 0156 Aug 30 09:20 arbor/c/arbor_powerup
[Amiga]                   7991   17880  44.7% -lh5- 3b19 Aug 30 09:20 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]                   1238    4666  26.5% -lh5- ba3e Aug 30 09:06 arbor/Makefile
[Amiga]                   1587    6276  25.3% -lh5- 5b8e Aug 30 07:49 arbor/Makefile.docker
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        17 files  194556  276018  70.5%            Aug 30 21:49