buninu-linux 0.2.0

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

@@ -0,0 +1,22 @@
+## eval
+
+Evaluate arguments as shell source.
+
+### Usage
+
+```sh
+eval [ARG ...]
+```
+
+### Example
+
+```sh
+code='echo evaluated'
+eval "$code"
+```
+
+Output:
+
+```text
+evaluated
+```

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

@@ -0,0 +1,22 @@
+## exec
+
+Run a command and terminate the current shell with its status.
+
+### Usage
+
+```sh
+exec COMMAND [ARG ...]
+```
+
+### Example
+
+```sh
+exec printf 'done\n'
+```
+
+Output:
+
+```text
+done
+(shell exits with status 0)
+```

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

@@ -0,0 +1,21 @@
+## exit
+
+Exit the current shell.
+
+### Usage
+
+```sh
+exit [STATUS]
+```
+
+### Example
+
+```sh
+exit 7
+```
+
+Output:
+
+```text
+(shell exits with status 7)
+```

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

@@ -0,0 +1,22 @@
+## export
+
+Set or list environment variables.
+
+### Usage
+
+```sh
+export [NAME[=VALUE] ...]
+```
+
+### Example
+
+```sh
+export NAME=value
+env | grep '^NAME='
+```
+
+Output:
+
+```text
+NAME=value
+```

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

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

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

@@ -0,0 +1,33 @@
+## find
+
+Walk paths with name, path, type, depth, print, and -exec expressions.
+
+### Usage
+
+```sh
+find [PATH ...] [EXPRESSION]
+```
+
+### Options and forms
+
+- `-name`, `-iname`: Match a basename, optionally ignoring case.
+- `-path`, `-ipath`: Match a path, optionally ignoring case.
+- `-type f|d|l`: Select files, directories, or links.
+- `-mindepth N`, `-maxdepth N`: Limit traversal depth.
+- `-print`, `-print0`: Emit newline- or NUL-delimited paths.
+- `!`, `-not`: Negate the following expression.
+- `-exec COMMAND {} \;`: Run once per path.
+- `-exec COMMAND {} +`: Run with batches of paths.
+
+### Example
+
+```sh
+find . -type f -name '*.md'
+```
+
+Output:
+
+```text
+./README.md
+./CHANGELOG.md
+```

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

@@ -0,0 +1,28 @@
+## getopts
+
+Parse positional options.
+
+### Usage
+
+```sh
+getopts OPTSTRING NAME [ARG ...]
+```
+
+### Options and forms
+
+- A leading `:` in OPTSTRING selects silent error reporting.
+- A letter followed by `:` requires an argument. Results use the named variable plus `OPTARG` and `OPTIND`.
+
+### Example
+
+```sh
+set -- -a value
+getopts a: option
+echo "$option=$OPTARG"
+```
+
+Output:
+
+```text
+a=value
+```

package/initramfs/buninu/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/initramfs/buninu/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/initramfs/buninu/apps/bunmsh/help/kill.md

@@ -0,0 +1,43 @@
+## 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.
+- `-l`: List the signal names this runtime knows.
+
+### Windows
+
+Windows has no signals to deliver. The runtime turns SIGTERM, SIGINT, and
+SIGKILL into an unconditional `TerminateProcess`, refuses every other name,
+and in no case touches the target's children. So on Windows every terminating
+signal is sent as `taskkill /PID PID /T /F` instead: `/T` reaches the children
+the runtime would leave running, and `/F` is what makes it work on a console
+process that has no message loop to close.
+
+The consequence is that the signal name is accepted but not honoured there —
+`kill -HUP PID` terminates the process rather than failing, and nothing gets
+the chance to shut down gracefully. `-0` is the exception: it asks whether the
+PID exists without touching it, which `taskkill` cannot express, so it still
+goes through the runtime.
+
+### Example
+
+```sh
+kill -0 $$
+echo $?
+```
+
+Output:
+
+```text
+0
+```

package/initramfs/buninu/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/initramfs/buninu/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/initramfs/buninu/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/initramfs/buninu/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/initramfs/buninu/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/initramfs/buninu/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/initramfs/buninu/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/initramfs/buninu/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/initramfs/buninu/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/initramfs/buninu/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/initramfs/buninu/apps/bunmsh/help/pspa.md

@@ -0,0 +1,38 @@
+## pspa
+
+List every process as a PID and its full command line.
+
+### Usage
+
+```sh
+pspa
+```
+
+It is a PATH-fallback builtin, so an executable named `pspa` found in `PATH`
+wins; `builtin pspa` selects this implementation. It takes no options — pipe
+it into `grep` to narrow the listing, and into `kill` to act on what you find.
+
+[`pspac`](#pspac) prints the same listing with the PID and the command line
+coloured.
+
+On POSIX systems this is `ps -eo pid,args`, and its output is passed through
+untouched. Reading `ps` over a pipe is also what keeps the command lines
+whole: procps truncates them at the terminal width when it is writing straight
+to a terminal.
+
+Windows has no `ps`, so the same two columns are queried from
+`Win32_Process` through PowerShell and laid out the same way, with the image
+name standing in for a system process that reports no command line.
+
+### Example
+
+```sh
+pspa | grep bun
+```
+
+Output:
+
+```text
+ 1004 bun ./src/main.js
+ 1220 bun run dev
+```

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

@@ -0,0 +1,57 @@
+## pspac
+
+The `pspa` process listing, coloured.
+
+### Usage
+
+```sh
+pspac
+```
+
+It is a PATH-fallback builtin taking no options, and it lists exactly what
+[`pspa`](#pspa) lists — same processes, same two columns, same order. Strip
+the colour off its output and you have `pspa`'s byte for byte.
+
+Like `catfancy`, it always colours rather than sniffing for a terminal, so the
+plain listing is always one command away: use `pspa` when the output is going
+somewhere that wants plain text.
+
+### What gets coloured
+
+The PID is painted as the number it is. The COMMAND column is a shell command
+line, so it is highlighted as one, using micro's `syntax/sh.yaml` rules and
+its `colorschemes/monokai.micro` colours — the same palette `catfancy` uses,
+so a command line reads the same here as in a previewed script:
+
+- Command names, shell keywords, flags, numbers, variables, quoted strings,
+  and comments each take their own colour.
+- Quoted strings and comments are regions, so a `#` inside an argument does
+  not turn the rest of the line into a comment.
+- Later rules win, exactly as in the editor: `--cat` is a flag, not the
+  coreutils `cat`.
+
+Two things a process listing needs that a script does not:
+
+- The directory in front of the program is dimmed. It is the part an absolute
+  path buries the answer in, and `ps` prints a lot of it.
+- The program's own name is coloured as a command whether or not sh.yaml's
+  word lists have heard of it — the file has to guess a command from a list,
+  while here the first token is known to be one.
+
+A kernel thread such as `[kworker/0:1]` has no program, path, or arguments to
+take apart, so it recedes as a whole.
+
+### Example
+
+```sh
+pspac
+```
+
+Output:
+
+```text
+  PID COMMAND
+    1 /init
+ 8824 /data/data/com.termux/files/usr/bin/bash -l
+ 8955 bun run dev
+```

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