buninu-linux 0.8.55 → 0.9.56

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

@@ -0,0 +1,21 @@
+## break
+
+Leave N enclosing loops (default 1). N must be positive. Function calls establish their own loop boundary.
+
+### Usage
+
+```sh
+break [N]
+```
+
+### Example
+
+```sh
+for x in a b; do echo "$x"; break; done
+```
+
+Output:
+
+```text
+a
+```

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

@@ -1,6 +1,6 @@
 ## chmod
 
-Change modes using octal values, +x, or a+x.
+Change file modes using octal values or symbolic permission changes.
 
 ### Usage
 
@@ -11,7 +11,13 @@ chmod MODE FILE ...
 ### Options and forms
 
 - Octal modes such as `755` set all permission bits.
-- `+x` and `a+x` add executable bits.
+- `+x` retains its existing shorthand for adding executable bits for everyone.
+- Explicit classes `u`, `g`, `o`, or `a` support `+`, `-`, and `=` with `rwxX`.
+- `X` adds execution only for directories or files already executable.
+- Comma-separated clauses and multiple operations are applied in order.
+- Examples: `a-w`, `u+rw`, `go=rx`, `u=rw,g=r,o=`.
+- Recursive mode, permission copying, `s`/`t`, and omitted classes other than
+  the existing `+x` shorthand are not implemented.
 
 ### Example
 

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

@@ -0,0 +1,29 @@
+## cmp
+
+Compare two files byte by byte. Return 0 for identical data, 1 for differences,
+and 2 for errors. `-` reads standard input.
+
+### Usage
+
+```sh
+cmp [-s] [--] FILE1 FILE2
+```
+
+`-s` (also `--silent` or `--quiet`) suppresses difference and file-error messages.
+Without it, report the first differing byte and line, or which file ends first.
+Byte offsets, `-l`, and other GNU extensions are not implemented.
+
+### Example
+
+```sh
+printf same > first
+printf same > second
+cmp -s first second
+echo $?
+```
+
+Output:
+
+```text
+0
+```

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

@@ -0,0 +1,22 @@
+## continue
+
+Continue the Nth enclosing loop (default 1). N must be positive.
+
+### Usage
+
+```sh
+continue [N]
+```
+
+### Example
+
+```sh
+for x in a b; do echo "$x"; continue; echo skipped; done
+```
+
+Output:
+
+```text
+a
+b
+```

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

@@ -6,12 +6,16 @@ Copy files and directories.
 
 ```sh
 cp [-rRv] SOURCE ... DESTINATION
+cp -p [-v] [--] FILE ... DESTINATION
 ```
 
 ### Options and forms
 
 - `-r`, `-R`: Copy directories recursively (`-r` is translated to Bun Shell's `-R`).
 - `-v`: Request verbose output.
+- `-p`: Preserve regular-file ownership, permissions and access/modification
+  times. Multiple sources require a directory destination; recursive `-p`
+  combinations are not yet supported and report an error.
 - `-n`: Accepted by Bun Shell but currently does not prevent overwriting.
 
 ### Example

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

@@ -0,0 +1,30 @@
+## diff
+
+Compare two files. Return 0 when identical, 1 when different, or 2 on error.
+
+### Usage
+
+```sh
+diff [-q] [--] FILE1 FILE2
+```
+
+Print normal-format changes, or use `-q`/`--brief` for a difference notice.
+Binary differences produce a notice. Text differences use Myers line alignment, preserving unchanged lines
+between separate additions, deletions, and replacements. Missing final
+newlines are reported explicitly. Directory comparison and unified/context formats are not supported.
+The default shell alias's `--color` option is accepted; output is plain text.
+
+### Example
+
+```sh
+printf 'first\nlast\n' > before
+printf 'first\nnew\nlast\n' > after
+diff before after
+```
+
+Output:
+
+```text
+1a2
+> new
+```

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

@@ -0,0 +1,26 @@
+## egrep
+
+Search using extended regular expressions, equivalent to `grep -E`.
+
+### Usage
+
+```sh
+egrep [OPTIONS] PATTERN [FILE ...]
+```
+
+### Options and forms
+
+Accepts the same supported options as builtin `grep`.
+
+### Example
+
+```sh
+printf 'red\nblue\ngreen\n' | builtin egrep 'red|blue'
+```
+
+Output:
+
+```text
+red
+blue
+```

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

@@ -1,11 +1,11 @@
 ## export
 
-Set or list environment variables.
+Mark variables for export, or list them. In `set -o posix` mode, external programs receive only inherited/exported variables and command-prefix assignments. Shell pipelines and subshells retain all shell variables through internal state transfer. Outside POSIX mode, bunmsh preserves its default of passing all variables to external programs.
 
 ### Usage
 
 ```sh
-export [NAME[=VALUE] ...]
+export [-p] [NAME[=VALUE] ...]
 ```
 
 ### Example

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

@@ -0,0 +1,30 @@
+## expr
+
+Evaluate integer, string, and basic regular-expression expressions.
+
+### Usage
+
+```sh
+expr [--] EXPRESSION
+```
+
+### Options and forms
+
+- Arithmetic: `+`, `-`, `*`, `/`, `%`, with parentheses and precedence.
+- Comparisons: `=`, `!=`, `<`, `<=`, `>`, `>=`.
+- `|` selects the first nonempty, nonzero operand; `&` requires both operands.
+- `STRING : BRE` returns the first capture, or the matched prefix length when there is no capture.
+- Status is 0 for a nonempty, nonzero result, 1 for empty or zero, and 2 for an error.
+- Quote operators that the shell would otherwise interpret.
+
+### Example
+
+```sh
+expr 2 + 3 '*' 4
+```
+
+Output:
+
+```text
+14
+```

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

@@ -0,0 +1,25 @@
+## fgrep
+
+Search for fixed strings, equivalent to `grep -F`.
+
+### Usage
+
+```sh
+fgrep [OPTIONS] PATTERN [FILE ...]
+```
+
+### Options and forms
+
+Accepts the same supported options as builtin `grep`.
+
+### Example
+
+```sh
+printf 'a.b\naxb\n' | builtin fgrep 'a.b'
+```
+
+Output:
+
+```text
+a.b
+```

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

@@ -32,3 +32,7 @@ Output:
 ```text
 beta
 ```
+
+Repeated `-e PATTERN` options combine patterns with OR. `-c` prints the number of selected lines per input file.
+
+The fallback names `egrep` and `fgrep` select `grep -E` and `grep -F`.

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

@@ -1,11 +1,11 @@
 ## ls
 
-Use the lsfancy emoji and terminal-width-aware listing.
+Use the lsfancy emoji and terminal-width-aware listing. With `set -o posix`, fallback `ls` omits icons and automatic directory suffixes. Explicit `-F` suffixes still apply; `lsfancy` always retains its icons.
 
 ### Usage
 
 ```sh
-ls [-aAdlhRtrS1F] [PATH ...]
+ls [-aAdilhLRtrS1F] [PATH ...]
 ```
 
 Because `-h` means human-readable sizes, use `--help` to display this page.
@@ -16,6 +16,8 @@ Because `-h` means human-readable sizes, use `--help` to display this page.
 - `-A`: Include hidden entries except `.` and `..`.
 - `-d`: List directories themselves rather than their contents.
 - `-l`: Use long format.
+- `-i`: Print inode numbers.
+- `-L`: Follow symbolic links.
 - `-h`: Show human-readable sizes; use `--help` for this page.
 - `-R`: Recurse into directories.
 - `-t`: Sort by modification time.

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

@@ -1,6 +1,6 @@
 ## mkdir
 
-Create directories with Bun Shell's fallback.
+Create directories with Bun Shell's fallback, processing operands in order.
 
 ### Usage
 

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

@@ -28,3 +28,6 @@ Output:
 ```text
 hello world
 ```
+
+Short flags may be combined: `print -rn -- text` is equivalent to
+`print -r -n -- text`.

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

@@ -0,0 +1,23 @@
+## return
+
+Return from a function or sourced script. Without STATUS, preserve the previous status.
+
+### Usage
+
+```sh
+return [STATUS]
+```
+
+### Example
+
+```sh
+f () { return 7; }
+f
+echo "$?"
+```
+
+Output:
+
+```text
+7
+```

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

@@ -1,20 +1,25 @@
 ## sed
 
-Apply supported print and substitution expressions.
+Apply editing commands to pattern and hold spaces.
 
 ### Usage
 
 ```sh
-sed [-nEr] [-e SCRIPT] [-i] [SCRIPT] [FILE ...]
+sed [-nEr] [-e SCRIPT | -f FILE] [-i] [SCRIPT] [FILE ...]
 ```
 
 ### Options and forms
 
 - `-n`: Suppress automatic output.
 - `-e SCRIPT`, `-eSCRIPT`: Add a script.
+- `-f FILE`, `-fFILE`: Read a script from a file.
 - `-E`, `-r`: Use extended regular expressions.
 - `-i`: Edit files in place.
-- Supported commands include numeric `p` and `s///` with `g` and `p` flags.
+- Numeric, last-line (`$`), and regular-expression addresses; ranges, inversion, and `{ ... }` groups.
+- `s///` with `g`, `p`, and occurrence-number flags; `y///` translation.
+- `p`, `P`, `d`, `D`, `q`, `=`, `n`, `N`; hold-space commands `h`, `H`, `g`, `G`, `x`.
+- Labels (`:`), unconditional branches (`b`), and substitution-test branches (`t`, `T`).
+- `a`, `i`, `c` text commands; `r FILE` appends file contents after the current cycle. Missing/unreadable files are skipped. This remains a subset: `w` is not implemented.
 
 ### Example
 

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

@@ -1,16 +1,25 @@
 ## set
 
-Print variables or replace positional parameters.
+Print variables, replace positional parameters, or change shell options.
 
 ### Usage
 
 ```sh
-set [-- [ARG ...]]
+set [-eufxv] [+eufxv] [-o NAME | +o NAME] [-- [ARG ...]]
 ```
 
 ### Options and forms
 
-- `--`: Replace positional parameters with the remaining arguments. With no arguments, print variables.
+- No arguments: print variables.
+- `--`: replace positional parameters, including clearing them with no following arguments.
+- `-`: end options and disable verbose/xtrace; replace positional parameters only when arguments follow.
+- `-e` / `+e`: enable/disable exit on untested failures. Conditions, negation and non-final AND/OR commands suppress it.
+- `-u` / `+u`: enable/disable errors for unset parameters; explicit defaults still work.
+- `-f` / `+f`: disable/enable pathname expansion.
+- `-x` / `+x`: enable/disable execution tracing.
+- `-o` / `+o` without a name: list named option states / reusable set commands.
+- Names: `errexit`, `nounset`, `noglob`, `xtrace`, `verbose`, `posix`. CLI `-v` prints initial input; incremental verbose reading is not yet implemented.
+- `-o posix`: enable compatibility mode. The fallback `ls` prints without icons or automatic directory suffixes; `lsfancy` remains decorative. External programs receive only inherited/exported variables and command-prefix assignments; pipelines and subshells still receive complete shell state. Use `+o posix` to restore the default, which passes all variables to external programs. This option is not a guarantee of complete POSIX semantics.
 
 ### Example
 

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

@@ -24,3 +24,7 @@ Output:
 ```text
 HELLO
 ```
+
+`-s SET` squeezes repeated characters in SET. With two sets, translation happens
+before squeezing SET2. `-ds SET1 SET2` deletes SET1 then squeezes SET2.
+`--` ends option parsing; unsupported options report an error.

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

@@ -0,0 +1,22 @@
+## trap
+
+Register shell code for EXIT (0) or a catchable signal. No operands lists handlers; ACTION - resets and an empty ACTION ignores the signal in this shell. Signal handlers are deferred to command boundaries. Background process ownership is unchanged.
+
+### Usage
+
+```sh
+trap [ACTION SIGNAL ...]
+```
+
+### Example
+
+```sh
+trap 'echo done' 0
+exit 0
+```
+
+Output:
+
+```text
+done
+```

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

@@ -0,0 +1,27 @@
+## uniq
+
+Collapse adjacent equal lines without sorting. Comparisons preserve bytes.
+
+### Usage
+
+```sh
+uniq [-cdu] [--] [INPUT [OUTPUT]]
+```
+
+`-c` prefixes counts; `-d` selects repeated groups; `-u` selects single lines.
+`-` reads standard input or writes standard output. Missing final newlines
+are added. Field/character skipping and other GNU options are unsupported.
+
+### Example
+
+```sh
+printf 'a\na\nb\na\n' | uniq
+```
+
+Output:
+
+```text
+a
+b
+a
+```

package/initramfs/buninu/apps/bunmsh/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunmsh",
-  "version": "0.3.11",
+  "version": "0.4.0",
   "description": "Cross-platform command shell for Bun JavaScript",
   "license": "MIT",
   "type": "module",