From 536523ffd75a2785c72183ea978682a07cd79fb5 Mon Sep 17 00:00:00 2001 From: axel Date: Fri, 21 Apr 2006 01:02:06 +1000 Subject: [PATCH] Minor comment and documentation edits darcs-hash:20060420150206-ac50b-c5c91053ee37a6c3f763287c42b430cdc99bb45b.gz --- doc_src/doc.hdr | 12 ++++++------ share/functions/contains.fish | 6 ------ 2 files changed, 6 insertions(+), 12 deletions(-) diff --git a/doc_src/doc.hdr b/doc_src/doc.hdr index c5ce8198c..c94f98bc5 100644 --- a/doc_src/doc.hdr +++ b/doc_src/doc.hdr @@ -1284,7 +1284,7 @@ Examples: - 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. -- 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 \$''. @@ -1377,14 +1377,14 @@ Examples: \subsection disc The law of discoverability -The shell should implement it's features in a way that makes them as -easy as possible for the user to discover for her/himself. +A program should be designed to make its features as +easy as possible to discover for the user. Rationale: -A program whose features are discoverable makes a new user into an -expert in a shorter span of time, since the user will learn how to use -the program simply by using it. +A program whose features are discoverable turns a new user into an +expert in a shorter span of time, since the user will become an expert +on the program simply by using it. The main benefit of a graphical program over a command line-based program is discoverability. In a graphical program, one can discover diff --git a/share/functions/contains.fish b/share/functions/contains.fish index c5cb4d41d..690f89dcc 100644 --- a/share/functions/contains.fish +++ b/share/functions/contains.fish @@ -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") while set -q argv