buninu-linux 0.2.0

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

@@ -0,0 +1,27 @@
+## read
+
+Read a line into shell variables.
+
+### Usage
+
+```sh
+read [-r] NAME ...
+```
+
+### Options and forms
+
+- `-r`: Preserve backslashes instead of treating them as escapes.
+- `--`: Stop option parsing. With no names, assign to `REPLY`.
+
+### Example
+
+```sh
+printf 'one two\n' | read first second
+echo "$first/$second"
+```
+
+Output:
+
+```text
+one/two
+```

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

@@ -0,0 +1,27 @@
+## readonly
+
+Define variables that cannot be changed.
+
+### Usage
+
+```sh
+readonly [-p] [--] [NAME[=VALUE] ...]
+```
+
+### Options and forms
+
+- `-p`: Print readonly definitions.
+- `--`: Stop option parsing.
+
+### Example
+
+```sh
+readonly NAME=value
+echo "$NAME"
+```
+
+Output:
+
+```text
+value
+```

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

@@ -0,0 +1,21 @@
+## realpath
+
+Print canonical absolute paths.
+
+### Usage
+
+```sh
+realpath PATH ...
+```
+
+### Example
+
+```sh
+realpath .
+```
+
+Output:
+
+```text
+/data/data/com.termux/files/home/bunmsh
+```

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

@@ -0,0 +1,33 @@
+## rm
+
+Remove files and directories with Bun Shell's fallback.
+
+### Usage
+
+```sh
+rm [OPTIONS] FILE ...
+```
+
+### Options and forms
+
+- `-f`: Ignore missing operands.
+- `-r`, `-R`, `--recursive`: Remove directories recursively.
+- `-v`, `--verbose`: Request verbose output.
+- `-d`, `--dir`: Remove empty directories.
+- `-i`, `--interactive=always`: Prompt for each removal.
+- `-I`, `--interactive=once`: Prompt once.
+- `--interactive=never`: Never prompt.
+- `--preserve-root`, `--no-preserve-root`: Accepted but currently have no effect.
+
+### Example
+
+```sh
+rm unwanted.txt
+builtin test -e unwanted.txt; echo $?
+```
+
+Output:
+
+```text
+1
+```

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

@@ -0,0 +1,27 @@
+## rmdir
+
+Remove empty directories.
+
+### Usage
+
+```sh
+rmdir [-p | --parents] DIRECTORY ...
+```
+
+### Options and forms
+
+- `-p`, `--parents`: Remove empty parent directories after each operand.
+
+### Example
+
+```sh
+mkdir empty
+rmdir empty
+builtin test -d empty; echo $?
+```
+
+Output:
+
+```text
+1
+```

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

@@ -0,0 +1,29 @@
+## sed
+
+Apply supported print and substitution expressions.
+
+### Usage
+
+```sh
+sed [-nEr] [-e SCRIPT] [-i] [SCRIPT] [FILE ...]
+```
+
+### Options and forms
+
+- `-n`: Suppress automatic output.
+- `-e SCRIPT`, `-eSCRIPT`: Add a script.
+- `-E`, `-r`: Use extended regular expressions.
+- `-i`: Edit files in place.
+- Supported commands include numeric `p` and `s///` with `g` and `p` flags.
+
+### Example
+
+```sh
+printf 'hello world\n' | sed 's/world/bunmsh/'
+```
+
+Output:
+
+```text
+hello bunmsh
+```

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

@@ -0,0 +1,29 @@
+## seq
+
+Print a numeric sequence.
+
+### Usage
+
+```sh
+seq [OPTIONS] [FIRST [INCREMENT]] LAST
+```
+
+### Options and forms
+
+- `-s TEXT`, `--separator TEXT`: Set the separator.
+- `-t TEXT`, `--terminator TEXT`: Set the terminator.
+- `-w`, `--fixed-width`: Accepted, but currently does not pad values.
+
+### Example
+
+```sh
+seq 3
+```
+
+Output:
+
+```text
+1
+2
+3
+```

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

@@ -0,0 +1,50 @@
+## serve
+
+Start the bunmsh HTTP file server.
+
+### Usage
+
+```sh
+serve [--auto-open] [--minapk-webview] [--random-url] [DIRECTORY]
+```
+
+### Options and forms
+
+- `--auto-open` / `--auto-open=off` / `--auto-open=/path`: Open the serving
+  URL after startup, or explicitly disable it, or open a specific path under
+  it instead of the root. Looks for `xdg-open` on PATH first regardless of
+  platform; falls back to `open` on macOS or `cmd /c start` on Windows only
+  when `xdg-open` isn't found. Bare `--auto-open` turns it on; `=off`, `=no`,
+  `=false`, or `=` (empty) turns it off, overriding an environment default
+  that turned it on; a value starting with `/` (e.g. `--auto-open=/index.html`)
+  turns it on and opens that path relative to the served URL instead of the
+  root — resolved after any `--random-url` prefix, so the secret prefix is
+  still there and the URL still works. The `o` control on stdin (see below)
+  opens the same target this flag configured.
+- `--minapk-webview` / `--minapk-webview=N` / `--minapk-webview=off`: Pass
+  `MINAPK_WEBVIEW` to the spawned opener. Bare `--minapk-webview` passes `1`;
+  `=N` passes the literal digit string `N`; `=off`, `=no`, `=false`, or `=`
+  (empty) means don't pass it at all. Not passed by default.
+- `--random-url` / `--random-url=off`: Serve beneath a high-entropy random URL
+  prefix (requests without it get `404`), or explicitly disable it. Same
+  bare/`=off`/`=no`/`=false`/`=` rules as `--auto-open`.
+- `SERVE_AUTO_OPEN`, `SERVE_MINAPK_WEBVIEW`, and `SERVE_RANDOM_URL` set the
+  defaults before CLI flags are applied (accepting `1`, `true`, `yes`, or
+  `on`; a digit string for `SERVE_MINAPK_WEBVIEW`; a `/`-led path for
+  `SERVE_AUTO_OPEN`); every flag defaults to off/not-passed. A CLI flag
+  always overrides its environment default, including turning off something
+  the environment turned on.
+- `--` stops option parsing. The optional operand selects the served directory.
+
+### Example
+
+```sh
+serve --random-url public
+```
+
+Output:
+
+```text
+Serving /home/user/public
+  http://localhost:3000/AaBIdviNcACxwZF2x3VW0QAaBIdviNcAGsAviNI5B59AAaBIdviNcAKsuNiSJkMrdQAaBIdviNcAOoVDLS5ydB9Q/
+```

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

@@ -0,0 +1,26 @@
+## set
+
+Print variables or replace positional parameters.
+
+### Usage
+
+```sh
+set [-- [ARG ...]]
+```
+
+### Options and forms
+
+- `--`: Replace positional parameters with the remaining arguments. With no arguments, print variables.
+
+### Example
+
+```sh
+set -- alpha beta
+echo "$1/$2"
+```
+
+Output:
+
+```text
+alpha/beta
+```

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

@@ -0,0 +1,21 @@
+## sha256sum
+
+Print SHA-256 hashes.
+
+### Usage
+
+```sh
+sha256sum [FILE ...]
+```
+
+### Example
+
+```sh
+printf hello | sha256sum
+```
+
+Output:
+
+```text
+2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824  -
+```

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

@@ -0,0 +1,23 @@
+## shift
+
+Discard leading positional parameters.
+
+### Usage
+
+```sh
+shift [COUNT]
+```
+
+### Example
+
+```sh
+set -- one two three
+shift
+echo "$1 $2"
+```
+
+Output:
+
+```text
+two three
+```

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

@@ -0,0 +1,25 @@
+## sleep
+
+Pause; supports ms, s, m, and h suffixes.
+
+### Usage
+
+```sh
+sleep DURATION
+```
+
+### Options and forms
+
+- Bare durations are seconds; suffixes `ms`, `s`, `m`, and `h` select milliseconds, seconds, minutes, and hours.
+
+### Example
+
+```sh
+time sleep 10ms
+```
+
+Output:
+
+```text
+real 10.000000 ms
+```

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

@@ -0,0 +1,29 @@
+## sort
+
+Sort, reverse, compare numerically, or deduplicate lines.
+
+### Usage
+
+```sh
+sort [-rnu] [FILE ...]
+```
+
+### Options and forms
+
+- `-r`: Reverse the result.
+- `-n`: Compare numerically.
+- `-u`: Remove duplicate lines. These short flags may be combined.
+
+### Example
+
+```sh
+printf 'c\na\nb\n' | sort
+```
+
+Output:
+
+```text
+a
+b
+c
+```

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

@@ -0,0 +1,23 @@
+## source
+
+Evaluate a file in the current shell.
+
+### Usage
+
+```sh
+source FILE [ARG ...]
+```
+
+### Example
+
+```sh
+printf 'NAME=sourced\n' > settings.sh
+source settings.sh
+echo "$NAME"
+```
+
+Output:
+
+```text
+sourced
+```

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

@@ -0,0 +1,30 @@
+## tab
+
+Manage directory tabs and shell session controls.
+
+### Usage
+
+```sh
+tab [n | x | c | l | r | s | save | path | mouse | NUMBER]
+```
+
+### Options and forms
+
+- `n` creates a tab; `x`/`c` closes it; `l` and `r` switch tabs.
+- `save`/`s` saves history; `save d` deduplicates it.
+- `path [on|off|true|false]` controls PATH lookup.
+- `mouse [on|off|true|false]` controls terminal mouse tracking.
+- A numeric operand selects that tab.
+
+### Example
+
+```sh
+tab
+```
+
+Output:
+
+```text
+📁 ~/project  📂 ~/project
+[2]$
+```

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

@@ -0,0 +1,29 @@
+## tac
+
+Reverse newline-delimited records in each input file.
+
+### Usage
+
+```sh
+tac [--] [FILE ...]
+```
+
+### Options and forms
+
+- `--`: Stop option parsing.
+- `-`: Read from stdin at that operand position.
+- Other options are not currently supported.
+
+### Example
+
+```sh
+printf 'one\ntwo\nthree\n' | tac
+```
+
+Output:
+
+```text
+three
+two
+one
+```

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

@@ -0,0 +1,27 @@
+## tail
+
+Write the last lines, or start output at a selected line.
+
+### Usage
+
+```sh
+tail [-n N | -N | -n +N | -n+N] [FILE ...]
+```
+
+### Options and forms
+
+- `-n N`, `-N`: Write the last N lines.
+- `-n +N`, `-n+N`: Start output at line N.
+
+### Example
+
+```sh
+printf 'one\ntwo\nthree\n' | tail -n 2
+```
+
+Output:
+
+```text
+two
+three
+```

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

@@ -0,0 +1,25 @@
+## tee
+
+Copy stdin to stdout and files.
+
+### Usage
+
+```sh
+tee [-a] [FILE ...]
+```
+
+### Options and forms
+
+- `-a`: Append to files rather than replacing them.
+
+### Example
+
+```sh
+printf hello | tee output.txt
+```
+
+Output:
+
+```text
+hello
+```

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

@@ -0,0 +1,30 @@
+## test
+
+Evaluate file, string, and integer expressions; [ requires a closing ].
+
+### Usage
+
+```sh
+test EXPRESSION
+```
+
+### Options and forms
+
+- Unary file tests: `-e`, `-f`, `-d`, `-b`, `-c`, `-p`, `-S`, `-L`/`-h`, `-s`, `-r`, `-w`, and `-x`.
+- Unary string tests: `-n` and `-z`.
+- String comparisons: `=`, `==`, and `!=`.
+- Integer comparisons: `-eq`, `-ne`, `-gt`, `-ge`, `-lt`, and `-le`.
+- File comparisons: `-nt`, `-ot`, and `-ef`. Logical `!`, `-a`, and `-o` are supported.
+
+### Example
+
+```sh
+test -d /tmp
+echo $?
+```
+
+Output:
+
+```text
+0
+```

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

@@ -0,0 +1,29 @@
+## time
+
+Run a command and report elapsed time.
+
+### Usage
+
+```sh
+time [COMMAND [ARG ...]]
+```
+
+### Display
+
+- Elapsed time is written to stderr in milliseconds with six decimal places.
+- When stderr is a terminal, each three-digit magnitude group uses a different
+  ANSI color, making units and fractional precision easier to distinguish.
+- The decimal point is dimmed. Colors are omitted when stderr is redirected or
+  captured.
+
+### Example
+
+```sh
+time true
+```
+
+Output:
+
+```text
+real 0.000000 ms
+```

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

@@ -0,0 +1,26 @@
+## touch
+
+Create files or update timestamps.
+
+### Usage
+
+```sh
+touch FILE ...
+```
+
+### Options and forms
+
+- No options are currently supported.
+
+### Example
+
+```sh
+touch created.txt
+builtin test -f created.txt; echo $?
+```
+
+Output:
+
+```text
+0
+```

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

@@ -0,0 +1,26 @@
+## tr
+
+Translate or delete characters.
+
+### Usage
+
+```sh
+tr [-d] SET1 [SET2]
+```
+
+### Options and forms
+
+- `-d`: Delete characters in SET1 instead of translating them.
+- Simple ranges such as `a-z` are supported.
+
+### Example
+
+```sh
+printf 'hello\n' | tr a-z A-Z
+```
+
+Output:
+
+```text
+HELLO
+```

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

@@ -0,0 +1,22 @@
+## true
+
+Return success.
+
+### Usage
+
+```sh
+true
+```
+
+### Example
+
+```sh
+true
+echo $?
+```
+
+Output:
+
+```text
+0
+```

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

@@ -0,0 +1,21 @@
+## type
+
+Describe how command names resolve.
+
+### Usage
+
+```sh
+type NAME ...
+```
+
+### Example
+
+```sh
+type echo
+```
+
+Output:
+
+```text
+echo is a shell builtin
+```

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

@@ -0,0 +1,22 @@
+## umask
+
+Print or set the file-creation mask.
+
+### Usage
+
+```sh
+umask [MODE]
+```
+
+### Example
+
+```sh
+umask 022
+umask
+```
+
+Output:
+
+```text
+0022
+```