buninu 0.3.0 → 0.3.1

package/apps/bunmsh/help/grep.md

@@ -0,0 +1,34 @@
+## grep
+
+Search text with basic, extended, fixed, recursive, and color modes.
+
+### Usage
+
+```sh
+grep [OPTIONS] PATTERN [FILE ...]
+```
+
+### Options and forms
+
+- `-E`: Extended regular expressions.
+- `-F`: Fixed-string matching.
+- `-i`: Ignore case.
+- `-q`: Quiet; return status only.
+- `-v`: Invert matches.
+- `-n`: Prefix line numbers.
+- `-o`: Print only matched text.
+- `-r`: Recurse into directories.
+- `-x`: Match whole lines.
+- `--color=always|auto|never`: Control match color; `--colour` is also accepted.
+
+### Example
+
+```sh
+printf 'alpha\nbeta\n' | grep beta
+```
+
+Output:
+
+```text
+beta
+```

package/apps/bunmsh/help/head.md

@@ -0,0 +1,27 @@
+## head
+
+Write the first lines or bytes of input.
+
+### Usage
+
+```sh
+head [-n N | -N | -c N | -cN] [FILE ...]
+```
+
+### Options and forms
+
+- `-n N`, `-N`: Write the first N lines.
+- `-c N`, `-cN`: Write the first N bytes.
+
+### Example
+
+```sh
+printf 'one\ntwo\nthree\n' | head -n 2
+```
+
+Output:
+
+```text
+one
+two
+```

package/apps/bunmsh/help/kill.md

@@ -0,0 +1,27 @@
+## kill
+
+Send a signal to processes.
+
+### Usage
+
+```sh
+kill [-SIGNAL] PID ...
+```
+
+### Options and forms
+
+- `-SIGNAL`: Select a signal by name or number; the default is SIGTERM.
+- `-0`: Check whether a process can be signalled without sending a signal.
+
+### Example
+
+```sh
+kill -0 $$
+echo $?
+```
+
+Output:
+
+```text
+0
+```

package/apps/bunmsh/help/ln.md

@@ -0,0 +1,28 @@
+## ln
+
+Create hard or symbolic links.
+
+### Usage
+
+```sh
+ln [-sfT] TARGET LINK
+```
+
+### Options and forms
+
+- `-s`: Create a symbolic link.
+- `-f`: Replace an existing destination.
+- `-T`: Treat the destination as a normal path, not a directory.
+
+### Example
+
+```sh
+ln -s target.txt link.txt
+readlink link.txt
+```
+
+Output:
+
+```text
+target.txt
+```

package/apps/bunmsh/help/ls.md

@@ -0,0 +1,37 @@
+## ls
+
+Use the lsfancy emoji and terminal-width-aware listing.
+
+### Usage
+
+```sh
+ls [-aAdlhRtrS1F] [PATH ...]
+```
+
+Because `-h` means human-readable sizes, use `--help` to display this page.
+
+### Options and forms
+
+- `-a`: Include `.` and `..` plus hidden entries.
+- `-A`: Include hidden entries except `.` and `..`.
+- `-d`: List directories themselves rather than their contents.
+- `-l`: Use long format.
+- `-h`: Show human-readable sizes; use `--help` for this page.
+- `-R`: Recurse into directories.
+- `-t`: Sort by modification time.
+- `-r`: Reverse the result order.
+- `-S`: Sort by size.
+- `-1`: Print one entry per line.
+- `-F`: Append classify suffixes such as `/`, `@`, and `*`.
+
+### Example
+
+```sh
+builtin ls -l README.md
+```
+
+Output:
+
+```text
+-rw-r--r--    32221 2026-08-28 17:55 📄 README.md
+```

package/apps/bunmsh/help/lsbun.md

@@ -0,0 +1,29 @@
+## lsbun
+
+Invoke Bun Shell's original ls implementation.
+
+### Usage
+
+```sh
+lsbun [OPTIONS] [PATH ...]
+```
+
+### Options and forms
+
+- `-a`: Include all entries.
+- `-A`: Include hidden entries except `.` and `..`.
+- `-d`: List directories themselves.
+- `-l`: Use long format.
+- `-R`: Recurse into directories.
+
+### Example
+
+```sh
+builtin lsbun README.md
+```
+
+Output:
+
+```text
+README.md
+```

package/apps/bunmsh/help/lsfancy.md

@@ -0,0 +1,37 @@
+## lsfancy
+
+List files with icons, columns, metadata, sorting, and recursion.
+
+### Usage
+
+```sh
+lsfancy [-aAdlhRtrS1F] [PATH ...]
+```
+
+Because `-h` means human-readable sizes, use `--help` to display this page.
+
+### Options and forms
+
+- `-a`: Include `.` and `..` plus hidden entries.
+- `-A`: Include hidden entries except `.` and `..`.
+- `-d`: List directories themselves rather than their contents.
+- `-l`: Use long format, including symlink targets.
+- `-h`: Show human-readable sizes; use `--help` for this page.
+- `-R`: Recurse into directories.
+- `-t`: Sort by modification time.
+- `-r`: Reverse the result order.
+- `-S`: Sort by size.
+- `-1`: Print one entry per line.
+- `-F`: Append `/` for directories, `@` for links, `*` for executables, `=` for sockets, or `|` for FIFOs.
+
+### Example
+
+```sh
+builtin lsfancy -1 README.md
+```
+
+Output:
+
+```text
+📄 README.md
+```

package/apps/bunmsh/help/md5sum.md

@@ -0,0 +1,21 @@
+## md5sum
+
+Print MD5 hashes.
+
+### Usage
+
+```sh
+md5sum [FILE ...]
+```
+
+### Example
+
+```sh
+printf hello | md5sum
+```
+
+Output:
+
+```text
+5d41402abc4b2a76b9719d911017c592  -
+```

package/apps/bunmsh/help/mkdir.md

@@ -0,0 +1,27 @@
+## mkdir
+
+Create directories with Bun Shell's fallback.
+
+### Usage
+
+```sh
+mkdir [-pv] [--parents] DIRECTORY ...
+```
+
+### Options and forms
+
+- `-p`, `--parents`: Create missing parent directories and accept existing directories.
+- `-v`, `--vebose`: Request verbose output (`--vebose` is Bun Shell's currently accepted spelling).
+
+### Example
+
+```sh
+mkdir -p build/output
+builtin test -d build/output; echo $?
+```
+
+Output:
+
+```text
+0
+```

package/apps/bunmsh/help/mktemp.md

@@ -0,0 +1,26 @@
+## mktemp
+
+Create a temporary file or directory; TEMPLATE ends in XXXXXX.
+
+### Usage
+
+```sh
+mktemp [-d] TEMPLATE
+```
+
+### Options and forms
+
+- `-d`: Create a directory instead of a file.
+- The template must end in exactly six `X` characters.
+
+### Example
+
+```sh
+mktemp sample.XXXXXX
+```
+
+Output:
+
+```text
+sample.a1B2c3
+```

package/apps/bunmsh/help/mv.md

@@ -0,0 +1,26 @@
+## mv
+
+Move files with Bun Shell's fallback.
+
+### Usage
+
+```sh
+mv [OPTIONS] SOURCE ... DESTINATION
+```
+
+### Options and forms
+
+- `-f`, `-h`, `-i`, `-n`, `-v`: Currently accepted by Bun Shell but do not change behaviour; `-i` and `-n` do not prevent overwriting.
+
+### Example
+
+```sh
+mv old.txt new.txt
+basename new.txt
+```
+
+Output:
+
+```text
+new.txt
+```

package/apps/bunmsh/help/print.md

@@ -0,0 +1,30 @@
+## print
+
+Write arguments with mksh-style print semantics.
+
+### Usage
+
+```sh
+print [-rRnNl] [-uFD] [--] [ARG ...]
+```
+
+### Options and forms
+
+- `-r`, `-R`: Do not interpret backslash escapes.
+- `-n`: Omit the terminator.
+- `-l`: Separate arguments with newlines.
+- `-N`: Separate and terminate arguments with NUL bytes.
+- `-uFD`: Write to file descriptor 1 or 2; other descriptors are not implemented.
+- `--`: Stop option parsing.
+
+### Example
+
+```sh
+print hello world
+```
+
+Output:
+
+```text
+hello world
+```

package/apps/bunmsh/help/printf.md

@@ -0,0 +1,25 @@
+## printf
+
+Format and write arguments.
+
+### Usage
+
+```sh
+printf FORMAT [ARG ...]
+```
+
+### Options and forms
+
+- Supported conversions are `%s`, `%d`, `%i`, `%%`, and optional numeric field widths; backslash escapes are also interpreted.
+
+### Example
+
+```sh
+printf '%s=%d\n' answer 42
+```
+
+Output:
+
+```text
+answer=42
+```

package/apps/bunmsh/help/pwd.md

@@ -0,0 +1,21 @@
+## pwd
+
+Print the active directory.
+
+### Usage
+
+```sh
+pwd
+```
+
+### Example
+
+```sh
+pwd
+```
+
+Output:
+
+```text
+/data/data/com.termux/files/home
+```

package/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/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/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/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/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/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/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/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/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
+```