container: root: change base path, update help process, update docs, related refactoring #245

2025-11-22T01:34:55Z

AaronFiore commented

2025-11-22 01:34:55 +00:00

(Migrated from gitea.com)

Description

Usage help is now:

Less noisy, less intrusive, more helpful
Will allow for isolating usage help on a per-namespace level

Change root base path, related refactor:

The base path is now outside of the macro directory; allowing for a
more integrated view of dfi's entire root system. This is more
apparent once running an interactive session where the expectation is
(more intuitively) that any path should be relative to 'src/root' and
not 'src/root/macro'.

The rationale for why this was in 'src/root/macro' to begin with stems
from how root (by default) will automatically load rootlogon.C in the
directory that root is started. This is causing more confusion than
not because dfi's usage of root is not limited to macros.

These changes skirt the line between needing a major API bump and not
but, so far, appears to be on the side of not. However, the TODOs
noted for macro loading should be addressed prior to any API changes.

Update TODO re: c++23

Agreement

I have read and understood the Development and License documentation

### Description Usage help is now: - Less noisy, less intrusive, more helpful - Will allow for isolating usage help on a per-namespace level --- Change root base path, related refactor: The base path is now *outside* of the macro directory; allowing for a more integrated view of `dfi`'s entire `root` system. This is more apparent once running an interactive session where the expectation is (more intuitively) that any path should be relative to 'src/root' and not 'src/root/macro'. The rationale for why this was in 'src/root/macro' to begin with stems from how `root` (by default) will automatically load rootlogon.C in the directory that `root` is started. This is causing more confusion than not because `dfi`'s usage of `root` is not limited to macros. These changes skirt the line between needing a major API bump and not but, so far, appears to be on the side of *not*. However, the TODOs noted for macro loading should be addressed prior to any API changes. --- Update TODO re: c++23 ### Agreement - [x] I have read and understood the [Development](https://gitea.com/EvergreenCrypto/docker-finance#development) and [License](https://gitea.com/EvergreenCrypto/docker-finance#license-and-disclaimer) documentation

AaronFiore commented

2025-11-24 18:53:00 +00:00

(Migrated from gitea.com)

All tests pass.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Reference: EvergreenCrypto/docker-finance#245