mirror of
https://github.com/fish-shell/fish-shell
synced 2025-01-13 13:39:02 +00:00
Minor comment and documentation edits
darcs-hash:20060420150206-ac50b-c5c91053ee37a6c3f763287c42b430cdc99bb45b.gz
This commit is contained in:
parent
ca82fc2f03
commit
536523ffd7
2 changed files with 6 additions and 12 deletions
|
@ -1284,7 +1284,7 @@ Examples:
|
||||||
|
|
||||||
- Here documents are too similar to using echo inside of a pipeline.
|
- Here documents are too similar to using echo inside of a pipeline.
|
||||||
- Subshells, command substitution and process substitution are strongly related. \c fish only supports command substitution, the others can be achived either using a block or the psub shellscript function.
|
- Subshells, command substitution and process substitution are strongly related. \c fish only supports command substitution, the others can be achived either using a block or the psub shellscript function.
|
||||||
- Having both aliases and functions is confusing, especially since both of them have limitations and problems. \c fish sunctions have none of the drawbacks of either syntax.
|
- Having both aliases and functions is confusing, especially since both of them have limitations and problems. \c fish functions have none of the drawbacks of either syntax.
|
||||||
- The many Posix quoting styles are silly, especially \$''.
|
- The many Posix quoting styles are silly, especially \$''.
|
||||||
|
|
||||||
|
|
||||||
|
@ -1377,14 +1377,14 @@ Examples:
|
||||||
|
|
||||||
\subsection disc The law of discoverability
|
\subsection disc The law of discoverability
|
||||||
|
|
||||||
The shell should implement it's features in a way that makes them as
|
A program should be designed to make its features as
|
||||||
easy as possible for the user to discover for her/himself.
|
easy as possible to discover for the user.
|
||||||
|
|
||||||
Rationale:
|
Rationale:
|
||||||
|
|
||||||
A program whose features are discoverable makes a new user into an
|
A program whose features are discoverable turns a new user into an
|
||||||
expert in a shorter span of time, since the user will learn how to use
|
expert in a shorter span of time, since the user will become an expert
|
||||||
the program simply by using it.
|
on the program simply by using it.
|
||||||
|
|
||||||
The main benefit of a graphical program over a command line-based
|
The main benefit of a graphical program over a command line-based
|
||||||
program is discoverability. In a graphical program, one can discover
|
program is discoverability. In a graphical program, one can discover
|
||||||
|
|
|
@ -1,9 +1,3 @@
|
||||||
#
|
|
||||||
# This file defines various shellscript functions. Most of them are
|
|
||||||
# meant to be used directly by the user, but some of them, typically
|
|
||||||
# the ones whose name start with '__fish_', are only meant to be used
|
|
||||||
# internally by fish.
|
|
||||||
#
|
|
||||||
|
|
||||||
function contains -d (N_ "Test if a key is contained in a set of values")
|
function contains -d (N_ "Test if a key is contained in a set of values")
|
||||||
while set -q argv
|
while set -q argv
|
||||||
|
|
Loading…
Reference in a new issue