Package: yash
Tags: patch
.TH YASH 1 "May 17, 2012"
.SH NAME
yash \- Yet Another Shell
.SH SYNOPSIS
.B yash [options] [filename [args...]]
.br
.B yash [options] -c command [command_name [args...]]
.br
.B yash [options] -s [args...]
.SH DESCRIPTION
\fByash\fP is a command line shell that conforms to the POSIX.1
(IEEE Std 1003.1, 2008 Edition) standard for the most part. Actually,
it is much more POSIX-compliant than other shell like bash and zsh.
.PP
\fByash\fP also has its own features beyond POSIX, such as:
.PP
* global aliases
* random numbers
* socket redirections and other special redirections
* right prompt
* command completion
.SH OPTIONS
set - set shell options and positional parameters
.br
set [\-abefhmnuvxC] [+abefhmnuvxC] [\-o option] [+o option] [--]
[arg...]
.br
set \-o
.br
set +o
.br
The first form enables or disables the specified shell options and/or
sets positional parameters to <arg>s. If no <arg>s are given, the
positional parameters are not changed.
.br
If no options or <arg>s are given at all, a list of all existing
variables is printed. To clear all positional parameters, use
`set --'.
.br
The second form prints the current settings of the shell options in a
human- readable form.
.br
The third form prints commands that can be used to restore the current
option settings later.
.TP
.B \-h, \-\-help
Show this help message and exit
.TP
.B \-a \-\-allexport
Any variable is exported when assigned.
.TP
.B \-b \-\-notify
When the status of a job is changed, it is notified immediately.
.TP
.B \-\-notifyle
Similar to \-b, but only notify during line-editing. Ignored if \-b is
set.
.TP
.B \-e \-\-errexit
Exit the shell immediately when any simple command returns a
non-zero status.
.TP
.B +f \-\-glob
Perform pathname expansion (globbing).
.TP
.B \-\-caseglob
Perform pathname expansion case-sensitively.
.TP
.B \-\-dotglob
In pathname expansion, `*' and `?' match a `.' at the beginning of
the filename.
.TP
.B \-\-markdirs
In pathname expansion, directory pathnames have a `/' at the ends.
.TP
.B \-\-extendedglob
Enable extended pathname expansion.
.TP
.B \-\-nullglob
In pathname expansion, patterns that do not match any pathname are
removed from the command line rather than left as is.
.TP
.B \-h \-\-hashondef
When a function is defined, all the commands in the function are
registered in the command path cache.
.TP
.B \-m \-\-monitor
Enable job control. All jobs are run in their own process group.
When the status of a job is changed, the status is reported before
the next prompt. This option is enabled by default for an interactive
shell.
.TP
.B +n \-\-exec
Execute commands.
This option cannot be disabled in an interactive shell.
.TP
.B +u \-\-unset
Expand an undefined variable to an empty string.
.TP
.B \-v \-\-verbose
Echo each command to the standard error before execution.
.TP
.B \-x \-\-xtrace
After each command line is expanded, the expanded line is printed
to the standard error.
.TP
.B +C \-\-clobber
Allow redirections to overwrite existing files.
.TP
.B \-\-ignoreeof
Do not exit when an EOF is entered.
This option is effective in an interactive shell only.
.TP
.B \-\-braceexpand
Enable brace expansion.
.TP
.B \-\-curasync, \-\-curbg, \-\-curstop
A background job becomes the current job when
.br
(curasync) invoked as an asynchronous command
.br
(curbg) resumed by the bg built-in
.br
(curstop) stopped.
.br
(These options are enabled by default)
.TP
.B \-\-histspace
Do not save lines that start with a space in the history.
.TP
.B \-\-posixly-correct
Make the shell behave as the POSIX shell.
.TP
.B \-\-vi
Enable vi-like editing.
.TP
.B \-\-emacs
Enable emacs-like editing.
.TP
.B \-\-le-convmeta
Treat 8th bit of input as a meta-key flag (regardless of terminfo).
.TP
.B \-\-le-noconvmeta
Do not treat 8th bit of input as a meta-key flag.
.TP
.B \-\-le-visiblebell
Alert with a flash rather than a bell.
.TP
.B \-\-le-promptsp
Move cursor to beginning of line each time when starting
line-editing. (enabled by default)
.TP
.B \-\-le-alwaysrp
Make the right prompt always visible on the screen.
.TP
.B \-\-le-compdebug
Print debugging information during command line completion.
.PP
Options can be disabled by using `+' instead of `-'. For example,
`set +a' or `set ++allexport' disables the allexport option.
Prefixing `no' to a long option also disables the option. For example,
`set \-\-nounset' disables the unset option.
.SH AUTHOR
yash was written by Magicant <[email protected]>.
.PP
This manual page was written by Khalid El Fathi <[email protected]>,
for the Debian project (and may be used by others).
