-=:[ ChangeLog ]:=-

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: however you can also
just run the executable from its unarchived folder.

The first thing to try after unpacking is to run the "arbor_test" script
because it will run the arbor utility and it will show you what arbor does to
all the input paths passed to the command line.

After that, it is just a matter of running arbor with any paths as input in
order to genrate trees.

-=:[ 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]                   8017   32106  25.0% -lh5- d6d9 Aug 21 23:15 arbor/arbor.c
[Amiga]                    152     242  62.8% -lh5- 46e9 Aug 18 22:35 arbor/arbor.installgen
[Amiga]                   1238    2554  48.5% -lh5- 2e6c Aug 21 23:21 arbor/arbor.readme
[Amiga]                     56      56 100.0% -lh0- cdf1 Aug 18 22:35 arbor/arbor.readme.info
[Amiga]                   1589    9019  17.6% -lh5- 2a1e Aug 21 23:05 arbor/arbor_test
[Amiga]                  67804   68449  99.1% -lh5- 7c27 Aug 21 23:01 arbor/arbor_test.info
[Amiga]                  26241   56400  46.5% -lh5- d055 Aug 22 03:31 arbor/c/arbor
[Amiga]                    190     287  66.2% -lh5- b300 Aug 18 22:38 arbor/Install
[Amiga]                  35573   37363  95.2% -lh5- 69c2 Aug 18 22:37 arbor/Install.info
[Amiga]                    510     917  55.6% -lh5- de94 Aug 22 03:30 arbor/Makefile
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        11 files  179970  246268  73.1%            Aug 22 23:17