-=:[ 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.

-=:[ 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
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                38600   38875  99.3% -lh5- 7e06 Aug 18 22:35 arbor.info
[generic]                 2279    8115  28.1% -lh5- 5ac0 Aug 18 22:29 arbor/arbor.c
[generic]                 2325    8298  28.0% -lh5- 710f Aug 18 22:29 arbor/arbor.c.good
[generic]                  152     242  62.8% -lh5- 46e9 Aug 18 22:35 arbor/arbor.installgen
[generic]                 3268    6532  50.0% -lh5- 2678 Aug 18 22:47 arbor/arbor.o
[generic]                  954    1930  49.4% -lh5- bc2e Aug 18 22:44 arbor/arbor.readme
[generic]                   56      56 100.0% -lh0- cdf1 Aug 18 22:35 arbor/arbor.readme.info
[generic]                 1252    5055  24.8% -lh5- e658 Aug 18 22:29 arbor/arbor_test
[generic]                67800   68444  99.1% -lh5- a5fa Aug 18 22:35 arbor/arbor_test.info
[generic]                18335   41912  43.7% -lh5- 86f6 Aug 18 22:47 arbor/c/arbor
[generic]                  190     287  66.2% -lh5- b300 Aug 18 22:38 arbor/Install
[generic]                35573   37363  95.2% -lh5- 69c2 Aug 18 22:37 arbor/Install.info
[generic]                  510     917  55.6% -lh5- de94 Aug 18 22:29 arbor/Makefile
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        13 files  171294  218026  78.6%            Aug 18 22:53