aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorSoccera1 <[email protected]>2026-07-28 16:37:20 +1000
committerSoccera1 <[email protected]>2026-07-28 16:37:20 +1000
commit471a0af4628e4796421fdba55ebc79bb4240c47e (patch)
tree3253279597744e51679422cb8ef940a0aa928a82 /man
parenta1361ac72185b04fbb7b2d6f658e36720cc1490f (diff)
downloadbnu-471a0af4628e4796421fdba55ebc79bb4240c47e.tar.gz
bnu-471a0af4628e4796421fdba55ebc79bb4240c47e.zip
Update docs
Diffstat (limited to 'man')
-rw-r--r--man/bnu.127
-rw-r--r--man/coreutils.14
2 files changed, 23 insertions, 8 deletions
diff --git a/man/bnu.1 b/man/bnu.1
index f2d995f..26175b3 100644
--- a/man/bnu.1
+++ b/man/bnu.1
@@ -11,15 +11,21 @@ bnu \- run a BNU core utility
BNU is an independent implementation of the GNU Coreutils 9.11
command\-line interface for the Bun runtime.
.PP
-The first operand selects a utility. The remaining operands are passed to
-that utility. Run
+Each utility has an independently runnable entry under
+.IR src/commands/ .
+The
+.B bnu
+launcher is retained as a compatibility and discovery surface: its first
+operand selects a utility, which is loaded on demand, and the remaining
+operands are passed to that utility. Run
.B bnu \-\-help
to list the implemented commands, or run
.I COMMAND
.B \-\-help
to see command-specific help.
.PP
-Utilities may also be invoked through command-name wrappers generated with:
+Command-name wrappers that invoke the single-call entries directly can be
+generated with:
.PP
.RS
bun run link\-commands \-\- DIRECTORY
@@ -52,10 +58,19 @@ semantics.
.SH FILES
.TP
.I bin/bnu.js
-multi-call entry point in a source checkout
+compatibility multi-call launcher in a source checkout
+.TP
+.I src/commands/*.js
+independently runnable command entries
+.TP
+.I src/shared/catalog.js
+command inventory and lazy module loader
+.TP
+.I src/shared/command.js
+shared single-call entry behavior
.TP
-.I src/coreutils.js
-command implementations in a source checkout
+.I src/shared/runtime.js
+compatibility multi-call dispatch
.SH "REPORTING BUGS"
Report BNU bugs at <https://github.com/Soccera1/bnu/issues>.
.SH COPYRIGHT
diff --git a/man/coreutils.1 b/man/coreutils.1
index e71cd3d..e3963fd 100644
--- a/man/coreutils.1
+++ b/man/coreutils.1
@@ -1,7 +1,7 @@
.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md.
.TH COREUTILS "1" "2026-07-28" "BNU 9.11" "BNU Commands"
.SH NAME
-coreutils \- single binary for coreutils programs
+coreutils \- dispatch to a BNU command module
.SH SYNOPSIS
.B coreutils
\fI\,--coreutils-prog=PROGRAM_NAME \/\fR[\fI\,PARAMETERS\/\fR]...
@@ -10,7 +10,7 @@ coreutils \- single binary for coreutils programs
This page documents BNU, an independent Bun implementation compatible with
GNU Coreutils 9.11.
.PP
-Execute the PROGRAM_NAME built\-in program with the given PARAMETERS.
+Load and execute the PROGRAM_NAME single\-call module with the given PARAMETERS.
.TP
\X'tty: link https://www.gnu.org/software/coreutils/coreutils#coreutils--help'\fB\-\-help\fP\X'tty: link'
display this help and exit