buninu-linux 0.2.0

package/initramfs/buninu/apps/bunmsh/help/alias.md

@@ -0,0 +1,22 @@
+## alias
+
+Define or print aliases.
+
+### Usage
+
+```sh
+alias [NAME[=VALUE] ...]
+```
+
+### Example
+
+```sh
+alias ll='builtin lsfancy -l'
+alias ll
+```
+
+Output:
+
+```text
+ll='builtin lsfancy -l'
+```

package/initramfs/buninu/apps/bunmsh/help/basename.md

@@ -0,0 +1,38 @@
+## basename
+
+Remove directory components and an optional suffix.
+
+### Usage
+
+```sh
+basename [--] STRING [SUFFIX]
+```
+
+### Options and forms
+
+- `--`: Stop option parsing, allowing a string beginning with `-`.
+- `SUFFIX`: Remove this exact suffix when it is present and is not the whole basename.
+
+### Example
+
+```sh
+basename /usr/local/bin/bun
+```
+
+Output:
+
+```text
+bun
+```
+
+Suffix example:
+
+```sh
+basename archive.tar.gz .gz
+```
+
+Output:
+
+```text
+archive.tar
+```

package/initramfs/buninu/apps/bunmsh/help/builtin.md

@@ -0,0 +1,25 @@
+## builtin
+
+Run a registered builtin explicitly; with no command, list builtin names.
+
+### Usage
+
+```sh
+builtin [--] [COMMAND [ARG ...]]
+```
+
+### Options and forms
+
+- `--`: Stop builtin's own option parsing before the command name.
+
+### Example
+
+```sh
+builtin echo hello
+```
+
+Output:
+
+```text
+hello
+```

package/initramfs/buninu/apps/bunmsh/help/bun.md

@@ -0,0 +1,27 @@
+## bun
+
+Invoke the active Bun runtime.
+
+### Usage
+
+```sh
+bun [ARG ...]
+```
+
+### Options and forms
+
+All arguments are forwarded unchanged to the active Bun runtime. Bun's
+supported flags depend on that runtime version; run the external `bun --help`
+when its own complete CLI reference is required.
+
+### Example
+
+```sh
+bun --version
+```
+
+Output:
+
+```text
+1.4.0
+```

package/initramfs/buninu/apps/bunmsh/help/bunmsh.md

@@ -0,0 +1,47 @@
+## bunmsh
+
+Invoke the active bunmsh entry point.
+
+### Usage
+
+```sh
+bunmsh [ARG ...]
+```
+
+### Options and forms
+
+- `SCRIPT [ARG ...]`: Execute a shell script file.
+- `-c SOURCE [ARG ...]`: Parse and execute shell source text.
+- `-cc COMMAND [ARG ...]`: Execute argv directly without shell parsing or expansion.
+- `-i`: Enter interactive mode after any requested command or script.
+- `--mouse`: Enable terminal mouse events.
+- `--builtin-only`: Disable PATH lookup while retaining builtins.
+- `-V`, `--version`: Print the bunmsh version.
+- `--readme`: Render the bundled README.
+- `--changelog`: Render the bundled changelog.
+- `--build-exe`: Build `./bmsh` for the current platform.
+- `--build-for TARGET`: Cross-compile `./bmsh` for a target.
+- `--`: Stop option parsing before a script path.
+
+### Tar-backend asset controls
+
+These options currently work only with the tar asset backend. They are not
+available to builds that embed the asset directory directly with Bun's
+`--asset` backend. See [single-exe/README.md](../single-exe/README.md) for the
+backend comparison, build setup, and extraction layout.
+
+- `--assets-list`: List embedded asset paths and exit.
+- `--assets-extract`: Extract embedded assets beside the executable and exit.
+- `--assets-external`: Ignore embedded assets and read the extracted files.
+
+### Example
+
+```sh
+bunmsh -c 'echo hello'
+```
+
+Output:
+
+```text
+hello
+```

package/initramfs/buninu/apps/bunmsh/help/cat.md

@@ -0,0 +1,31 @@
+## cat
+
+Concatenate files or stdin.
+
+### Usage
+
+```sh
+cat [--exclude PATTERN]... [--] [FILE ...]
+```
+
+### Options and forms
+
+- `--`: Stop option parsing.
+- `--exclude PATTERN`/`--exclude=PATTERN`: Omit matching file operands using
+  `Bun.Glob` patterns. Repeat the option to exclude more patterns; quote a
+  pattern to prevent the shell from expanding it first.
+- `-`: Read from stdin at that operand position. No other options are supported.
+
+### Example
+
+```sh
+printf 'alpha\n' > alpha.txt
+printf 'beta\n' > beta.txt
+builtin cat --exclude 'alpha.*' *.txt
+```
+
+Output:
+
+```text
+beta
+```

package/initramfs/buninu/apps/bunmsh/help/catfancy.md

@@ -0,0 +1,35 @@
+## catfancy
+
+Render Markdown and colorized parsed structured data; pass other formats through.
+
+### Usage
+
+```sh
+catfancy [--exclude PATTERN]... [--] [FILE ...]
+```
+
+### Options and forms
+
+- `--`: Stop option parsing.
+- `--exclude PATTERN`/`--exclude=PATTERN`: Omit matching file operands using
+  `Bun.Glob` patterns. Repeat the option to exclude more patterns; quote a
+  pattern to prevent the shell from expanding it first.
+- `-`: Read unformatted stdin; file previews are selected from filename extensions.
+- `.js`/`.mjs`/`.cjs`/`.jsx` and `.ts`/`.mts`/`.cts`/`.tsx` files are wrapped
+  in a fenced ` ```javascript `/` ```typescript ` block and rendered through
+  `Bun.markdown.ansi`, for the same syntax coloring Markdown code blocks get.
+
+### Example
+
+```sh
+builtin catfancy package.json
+```
+
+Output:
+
+```text
+{
+  "name": "bunmsh",
+  "version": "0.1.10"
+}  # colorized
+```

package/initramfs/buninu/apps/bunmsh/help/cd.md

@@ -0,0 +1,22 @@
+## cd
+
+Change directory; cd - returns to the previous directory.
+
+### Usage
+
+```sh
+cd [DIRECTORY]
+```
+
+### Example
+
+```sh
+cd /tmp
+pwd
+```
+
+Output:
+
+```text
+/tmp
+```

package/initramfs/buninu/apps/bunmsh/help/chmod.md

@@ -0,0 +1,27 @@
+## chmod
+
+Change modes using octal values, +x, or a+x.
+
+### Usage
+
+```sh
+chmod MODE FILE ...
+```
+
+### Options and forms
+
+- Octal modes such as `755` set all permission bits.
+- `+x` and `a+x` add executable bits.
+
+### Example
+
+```sh
+chmod +x script.sh
+builtin test -x script.sh; echo $?
+```
+
+Output:
+
+```text
+0
+```

package/initramfs/buninu/apps/bunmsh/help/clear.md

@@ -0,0 +1,21 @@
+## clear
+
+Clear the terminal.
+
+### Usage
+
+```sh
+clear
+```
+
+### Example
+
+```sh
+clear
+```
+
+Output:
+
+```text
+(terminal screen is cleared)
+```

package/initramfs/buninu/apps/bunmsh/help/colon.md

@@ -0,0 +1,22 @@
+## :
+
+Do nothing and return success.
+
+### Usage
+
+```sh
+: [ARG ...]
+```
+
+### Example
+
+```sh
+: ignored
+echo $?
+```
+
+Output:
+
+```text
+0
+```

package/initramfs/buninu/apps/bunmsh/help/command.md

@@ -0,0 +1,27 @@
+## command
+
+Run or inspect a command while bypassing aliases.
+
+### Usage
+
+```sh
+command [-pVv] COMMAND [ARG ...]
+```
+
+### Options and forms
+
+- `-p`: Use bunmsh's default command PATH.
+- `-v`: Print a concise lookup result.
+- `-V`: Print a verbose lookup description.
+
+### Example
+
+```sh
+command -V echo
+```
+
+Output:
+
+```text
+echo is a shell builtin
+```

package/initramfs/buninu/apps/bunmsh/help/cp.md

@@ -0,0 +1,28 @@
+## cp
+
+Copy files and directories.
+
+### Usage
+
+```sh
+cp [-rRv] SOURCE ... DESTINATION
+```
+
+### Options and forms
+
+- `-r`, `-R`: Copy directories recursively (`-r` is translated to Bun Shell's `-R`).
+- `-v`: Request verbose output.
+- `-n`: Accepted by Bun Shell but currently does not prevent overwriting.
+
+### Example
+
+```sh
+cp source.txt copy.txt
+cat copy.txt
+```
+
+Output:
+
+```text
+hello
+```

package/initramfs/buninu/apps/bunmsh/help/curl.md

@@ -0,0 +1,181 @@
+## curl
+
+Transfer a URL over HTTP or HTTPS, built on Bun's own `fetch`.
+
+This is a **fallback builtin**: a real `curl` found on `PATH` always wins, so
+scripts keep the system binary where there is one and still run on a device
+that has none. `builtin curl` selects this implementation explicitly.
+
+### Usage
+
+```sh
+curl [OPTIONS] URL...
+```
+
+A URL with no scheme gets one: `http://` by default, `https://` when the port
+is `443`, or whatever `--proto-default` says. So `curl localhost:8080` and
+`curl example.com/page` work the way they do with the real curl. Only `http`
+and `https` are supported; anything else fails with exit code `1`.
+
+### Options and forms
+
+#### Output and files
+
+- `-o, --output FILE`: Write the body to `FILE` instead of stdout. `-o -`
+  means stdout. Repeat it to pair one target with each URL, in order.
+- `-O, --remote-name`: Save under the filename from the URL path.
+- `--remote-name-all`: Treat every URL as if it had its own `-O`.
+- `-J, --remote-header-name`: With `-O`, prefer the name in the
+  `Content-Disposition` header.
+- `--output-dir DIR`: Write `-o`/`-O` files under `DIR`.
+- `--create-dirs`: Create missing parent directories for the output file.
+- `-a, --append`: Append to the output file instead of truncating it.
+- `-C, --continue-at OFFSET|-`: Resume a partial download. `-` sizes the
+  existing file and asks for the rest with a `Range` header; the file is
+  appended to when the server answers `206`, and rewritten when it answers
+  `200` and ignored the range. A `416` answer means the local file is already
+  complete: nothing is written and the exit status is `0`.
+- `-D, --dump-header FILE`: Write the response headers to `FILE` (`-` for
+  stdout).
+- `-i, --include`: Print the response headers before the body. With `-L`,
+  every hop's headers are printed, as the real curl does.
+- `-I, --head`: Send `HEAD` and print the response headers.
+- `-w, --write-out FORMAT`: Print `FORMAT` after the transfer, with
+  `%{variable}` substitutions and `\n`, `\t`, `\r` escapes. `@FILE` (or `@-`)
+  reads the format from a file. Supported variables: `url`, `url_effective`,
+  `method`, `scheme`, `http_code`, `response_code`, `http_version`,
+  `num_redirects`, `num_headers`, `redirect_url`, `size_download`,
+  `size_upload`, `size_header`, `size_request`, `speed_download`,
+  `speed_upload`, `content_type`, `filename_effective`, `remote_ip`,
+  `remote_port`, `ssl_verify_result`, `exitcode`, `errormsg`, `time_total`,
+  `time_namelookup`, `time_connect`, `time_appconnect`, `time_pretransfer`,
+  `time_starttransfer`, `time_redirect`, `header_json`, `json`, `stdout`,
+  `stderr`.
+
+#### Request shaping
+
+- `-X, --request METHOD`: Set the request method.
+- `-H, --header 'Name: value'`: Add or replace a header. `'Name;'` sends an
+  empty value; `'Name:'` removes a header that would otherwise be sent.
+- `-d, --data DATA`, `--data-ascii DATA`: `POST` body; `@file` reads a file
+  (newlines stripped) and `@-` reads stdin. Repeats join with `&`.
+- `--data-raw DATA`: Same, but `@` has no special meaning.
+- `--data-binary DATA`: Same, but a `@file` is sent byte for byte.
+- `--data-urlencode DATA`: Percent-encode before sending. Accepts `content`,
+  `=content`, `name=content`, `@file`, and `name@file`.
+- `--json DATA`: `--data-binary` plus `Content-Type: application/json` and
+  `Accept: application/json`. `@file` and `@-` work here too.
+- `-G, --get`: Move the data onto the query string and send `GET`.
+- `-F, --form 'name=value'`, `--form-string`: `multipart/form-data`. `@file`
+  attaches a file, `<file` sends its contents as the field value, and
+  `;type=` / `;filename=` set the part's type and name.
+- `-T, --upload-file FILE`: `PUT` the file (`-` reads stdin).
+- `-u, --user USER[:PASSWORD]`: HTTP basic authentication.
+- `--oauth2-bearer TOKEN`: Send `Authorization: Bearer TOKEN`.
+- `-A, --user-agent NAME`: Override the default `curl/8.14.1`.
+- `-e, --referer URL`: Send a `Referer` header; a trailing `;auto` is ignored.
+- `-b, --cookie 'k=v'`: Send a `Cookie` header.
+- `-r, --range RANGE`: Send `Range: bytes=RANGE`.
+- `--compressed`: Ask for and transparently decode a compressed response.
+  Without it, no `Accept-Encoding` is negotiated, matching curl's default.
+- `-x, --proxy URL`: Send the request through a proxy.
+
+#### Redirects, failure, and timing
+
+- `-L, --location`: Follow redirects. `301`/`302`/`303` turn a `POST` into a
+  `GET`; `307`/`308` keep the method and body. `Authorization` is dropped when
+  the host changes, unless `--location-trusted` is given.
+- `--max-redirs N`: Cap the redirect chain (default 50, `-1` for unlimited).
+  Exceeding it fails with exit code `47`.
+- `-f, --fail`: No body output on HTTP errors; exit `22` instead.
+- `--fail-with-body`: Print the body and still exit `22`.
+- `-k, --insecure`: Do not verify the server certificate.
+- `-m, --max-time SECONDS`, `--connect-timeout SECONDS`: Abort a slow
+  transfer with exit code `28`.
+- `--retry N`, `--retry-delay SECONDS`, `--retry-all-errors`,
+  `--retry-connrefused`: Retry connection failures, timeouts, and the
+  transient statuses `408`, `429`, `500`, `502`, `503`, and `504`.
+
+#### Reporting
+
+- `-s, --silent`: No progress meter and no error messages.
+- `-S, --show-error`: Keep error messages while `-s` is in effect.
+- `-#, --progress-bar`: A single-bar progress display instead of the meter.
+- `--no-progress-meter`: Keep errors, drop the meter.
+- `-v, --verbose`: Trace the request and response headers on stderr.
+- `-V, --version`: Print the version banner.
+
+Like the real curl, the progress meter is shown only when the body is *not*
+being painted on the terminal — a `-o`/`-O` download or a redirected stdout
+gets a meter, `curl URL` at a prompt does not.
+
+#### Accepted and ignored
+
+These are parsed so a script does not die on them, and then have no effect,
+because `fetch` either handles that part itself or does not expose it:
+`--cacert`, `--capath`, `-E/--cert`, `--key`, `--interface`, `--limit-rate`,
+`--resolve`, `--connect-to`, `--unix-socket`, `--noproxy`, `--proxy-user`,
+`--proxy-header`, `-n/--netrc`, `-c/--cookie-jar`, `-z/--time-cond`,
+`-R/--remote-time`, `-N/--no-buffer` (output is always streamed anyway),
+`-g/--globoff` (URL globbing is not performed, so `{}` and `[]` are already
+literal), `-q/--disable`, `-4`, `-6`, `--http1.0`, `--http1.1`, `--http2`,
+`--http3`, `--tlsv1.x`, `--tcp-nodelay`, `--keepalive`, `--anyauth`,
+`--basic`, `--digest`, `-Z/--parallel`, `--max-filesize`, `--path-as-is`.
+
+### Where it differs from the system curl
+
+- `fetch` reports header names in lower case, so `-i`, `-I`, `-D`, and `-v`
+  rebuild the conventional capitalisation (`Content-Type`, `ETag`) and list
+  the headers in `fetch`'s order rather than the server's wire order.
+- The negotiated HTTP version is not exposed, so status lines are written as
+  `HTTP/1.1`.
+- Bun adds a `Connection: keep-alive` request header of its own.
+- The progress meter is a look-alike: same columns, not the same arithmetic.
+- URL globbing (`{a,b}`, `[1-10]`) is not implemented.
+- `fetch` forbids a body on `GET` and `HEAD`, so `-X GET -d ...` sends the
+  request without the data; use `-G` to put it on the query string instead.
+
+### Exit status
+
+`0` on success, `1` unsupported protocol, `2` bad usage, `3` malformed URL,
+`6` host not resolved, `7` connection failed, `22` HTTP error with `-f`,
+`23` write error, `26` local file could not be read, `28` timeout,
+`47` too many redirects, `56` connection reset, `60` certificate problem.
+
+### Example
+
+```sh
+curl -s -o /dev/null -w '%{http_code} %{content_type}\n' example.com
+```
+
+Output:
+
+```text
+200 text/html
+```
+
+The invocations a package script tends to use:
+
+```sh
+curl -kLO https://example.com/pkg.tar.gz
+curl -C - -kLO https://example.com/pkg.tar.gz
+curl -fsSL https://example.com/install.sh | sh
+curl -#k https://example.com/pkg.tar.gz.sha256
+curl -kfsS https://example.com/probe >/dev/null 2>/dev/null
+curl localhost:8080
+```
+
+Calling a JSON API — enough for the OpenAI chat completions endpoint:
+
+```sh
+curl -sS https://api.openai.com/v1/chat/completions \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -H 'Content-Type: application/json' \
+  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"hi"}]}'
+```
+
+`--json` shortens that, and `-N` streaming responses arrive chunk by chunk:
+
+```sh
+curl -sN --json @request.json https://api.openai.com/v1/chat/completions
+```

package/initramfs/buninu/apps/bunmsh/help/cut.md

@@ -0,0 +1,25 @@
+## cut
+
+Select character positions.
+
+### Usage
+
+```sh
+cut -c LIST [FILE ...]
+```
+
+### Options and forms
+
+- `-c LIST`, `-cLIST`: Select character positions or ranges such as `1-3,7`.
+
+### Example
+
+```sh
+printf 'abcdef\n' | cut -c2-4
+```
+
+Output:
+
+```text
+bcd
+```

package/initramfs/buninu/apps/bunmsh/help/date.md

@@ -0,0 +1,25 @@
+## date
+
+Print the current date.
+
+### Usage
+
+```sh
+date [+FORMAT]
+```
+
+### Options and forms
+
+- Formats include `%Y` year, `%m` month, `%d` day, `%H` hour, `%M` minute, `%S` second, `%s` Unix time, `%F` date, `%T` time, and `%%` percent.
+
+### Example
+
+```sh
+date +%F
+```
+
+Output:
+
+```text
+2026-08-28
+```

package/initramfs/buninu/apps/bunmsh/help/dirname.md

@@ -0,0 +1,25 @@
+## dirname
+
+Print a path's directory component.
+
+### Usage
+
+```sh
+dirname [--] STRING
+```
+
+### Options and forms
+
+- `--`: Stop option parsing, allowing a string beginning with `-`.
+
+### Example
+
+```sh
+dirname /usr/local/bin/bun
+```
+
+Output:
+
+```text
+/usr/local/bin
+```

package/initramfs/buninu/apps/bunmsh/help/echo.md

@@ -0,0 +1,25 @@
+## echo
+
+Write space-separated arguments.
+
+### Usage
+
+```sh
+echo [-n] [ARG ...]
+```
+
+### Options and forms
+
+- `-n`: Omit the trailing newline.
+
+### Example
+
+```sh
+echo hello world
+```
+
+Output:
+
+```text
+hello world
+```

package/initramfs/buninu/apps/bunmsh/help/env.md

@@ -0,0 +1,27 @@
+## env
+
+Print or modify the environment and optionally run a command.
+
+### Usage
+
+```sh
+env [-i] [-u NAME] [NAME=VALUE ...] [COMMAND [ARG ...]]
+```
+
+### Options and forms
+
+- `-i`, `--ignore-environment`: Start with an empty environment.
+- `-u NAME`, `--unset NAME`, `--unset=NAME`: Remove a variable.
+- `--`: Stop option parsing.
+
+### Example
+
+```sh
+env NAME=value sh -c 'echo "$NAME"'
+```
+
+Output:
+
+```text
+value
+```