AstralTransRocketries/OpenComputers
1
0
Fork 0
mirror of https://github.com/MightyPirates/OpenComputers.git synced 2025-09-16 18:55:03 -04:00
Code Issues Packages Projects Releases Wiki Activity

Moved besh-specific documentation to extra manpage for bash, removed it from the simple shell's manpage. Closes #333.

Browse Source
This commit is contained in:
Florian Nücke 2014-06-16 22:10:00 +02:00
parent 7d62262984
commit cbfe1dd25a
2 changed files with 40 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
src/main/resources/assets/opencomputers/loot/BetterShell/besh.man Normal file
View File

@ -0,0 +1,34 @@
NAME
besh - alternative command interpreter (shell)
SYNOPSIS
besh
DESCRIPTION
This is an alternative to the the basic, built-in standard shell of OpenOS. It provides some additional functionality such as piping. Otherwise it behaves similar to the built-in shell. To run a command, enter it and press enter. The first token in a command will usually be a program. Any additional parameters will be passed along to the program.
Arguments to programs can be quoted, to provide strings with multiple spaces in them, for example:
echo "a b"
will print the string `a b` to the screen. It is also possible to use single quotes (echo 'a b').
Single quotes also suppress variable expansion. Per default, expressions like `$NAME` and `${NAME}` are expanded using environment variables (also accessible via the `os.getenv` method).
BeSh provides basic redirects and piping:
cat f > f2
copies the contents of file `f` to `f2`, for example.
echo "this is a \"test\"" >> f2
will append the string 'this is a "test"' to the file `f2`.
Redirects can be combined:
cat < f >> f2
will feed the contents of file `f` to cat, which will then output it (in append mode) to file `f2`.
Finally, pipes can be used to pass data between programs:
ls | cat > f
will enumerate the files and directories in the working directory, write them to its output stream, which is cat's input stream, which will in turn write the data to file `f`.
This shell also supports aliases, which can be created using `alias` and removed using `unalias` (or using the `shell` API). For example, `dir` is a standard alias for `ls`.
EXAMPLES
besh
Starts a new shell.

20
src/main/resources/assets/opencomputers/loot/OpenOS/usr/man/sh
View File

@ -11,21 +11,13 @@ DESCRIPTION
echo "a b"
will print the string `a b` to the screen. It is also possible to use single quotes (echo 'a b').
Single quotes also suppress variable expansion. Per default, expressions like `$NAME` and `${NAME}` are expanded using environment variables (also accessible via the `os.getenv` method).
The OpenOS shell provides basic redirects and piping:
cat f > f2
copies the contents of file `f` to `f2`, for example.
echo "this is a \"test\"" >> f2
will append the string 'this is a "test"' to the file `f2`.
Redirects can be combined:
cat < f >> f2
will feed the contents of file `f` to cat, which will then output it (in append mode) to file `f2`.
Finally, pipes can be used to pass data between programs:
ls | cat > f
will enumerate the files and directories in the working directory, write them to its output stream, which is cat's input stream, which will in turn write the data to file `f`.
Basic globbing is supported, i.e. '*' and '?' are expanded approriately. For example:
ls b?n/
will list all files in `/bin/` (and, if it exists `/ban` and so on).
cp /bin/* /usr/bin/
will copy all files from `/bin` to `/usr/bin`.
The shell also supports aliases, which can be created using `alias` and removed using `unalias` (or using the `shell` API). For example, `dir` is a standard alias for `ls`.