From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 10456 invoked by alias); 10 May 2015 17:49:57 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: X-Seq: 35076 Received: (qmail 26733 invoked from network); 10 May 2015 17:49:55 -0000 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.2 X-Biglobe-Sender: From: Jun T To: zsh-workers@zsh.org Cc: Jun-ichi Takimoto Subject: [PATCH 1/4] improve manual format (ch.14-18) Date: Mon, 11 May 2015 02:48:47 +0900 Message-Id: <1431280130-26058-2-git-send-email-takimoto-j@kba.biglobe.ne.jp> X-Mailer: git-send-email 1.9.5 (Apple Git-50.3) In-Reply-To: <1431280130-26058-1-git-send-email-takimoto-j@kba.biglobe.ne.jp> References: <1431280130-26058-1-git-send-email-takimoto-j@kba.biglobe.ne.jp> X-Biglobe-Spnum: 58822 From: Jun-ichi Takimoto --- Doc/Zsh/builtins.yo | 29 +++++++++++++++++------------ Doc/Zsh/expn.yo | 2 ++ Doc/Zsh/options.yo | 2 +- Doc/Zsh/params.yo | 2 +- Doc/Zsh/zle.yo | 9 +++++---- 5 files changed, 26 insertions(+), 18 deletions(-) diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo index 9699cf3..5327789 100644 --- a/Doc/Zsh/builtins.yo +++ b/Doc/Zsh/builtins.yo @@ -661,10 +661,11 @@ Do nothing and return an exit status of 1. findex(fc) cindex(history, editing) cindex(editing history) +redef(SPACES)(0)(tt(ifztexi(NOTRANS(@ @ @ @ @ @ ))ifnztexi( ))) xitem(tt(fc) [ tt(-e) var(ename) ] [ tt(-m) var(match) ] [ var(old)tt(=)var(new) ... ] [ var(first) [ var(last) ] ]) -xitem(tt(fc) tt(-l) [ tt(-nrdfEiD) ] [ tt(-t) var(timefmt) ] [ tt(-m) var(match) ]) -xitem(tt( )[ var(old)tt(=)var(new) ... ] [ var(first) [ var(last) ] ]) -xitem(tt(fc) tt(-p) [ tt(-a) ] [ var(filename) [ var(histsize) [ var(savehistsize) ] ] ]) +xitem(tt(fc -l )[ tt(-nrdfEiD) ] [ tt(-t) var(timefmt) ] [ tt(-m) var(match) ]) +xitem(SPACES()[ var(old)tt(=)var(new) ... ] [ var(first) [ var(last) ] ]) +xitem(tt(fc -p )[ tt(-a) ] [ var(filename) [ var(histsize) [ var(savehistsize) ] ] ]) xitem(tt(fc) tt(-P)) item(tt(fc) tt(-ARWI) [ var(filename) ])( The tt(fc) command controls the interactive history mechanism. Note @@ -1099,8 +1100,8 @@ and the new directory stack is not printed. This is useful for calls to tt(popd) that do not change the environment seen by an interactive user. ) findex(print) -xitem(tt(print) [ tt(-abcDilmnNoOpPrsSz) ] [ tt(-u) var(n) ] [ tt(-f) var(format) ] [ tt(-C) var(cols) ]) -item( [ tt(-R) [ tt(-en) ]] [ var(arg) ... ])( +xitem(tt(print )[ tt(-abcDilmnNoOpPrsSz) ] [ tt(-u) var(n) ] [ tt(-f) var(format) ] [ tt(-C) var(cols) ]) +item(SPACES()[ tt(-R) [ tt(-en) ]] [ var(arg) ... ])( With the `tt(-f)' option the arguments are printed as described by tt(printf). With no flags or with the flag `tt(-)', the arguments are printed on the standard output as described by tt(echo), with the following differences: @@ -1288,8 +1289,9 @@ contain symbolic links. alias(r)(fc -e -) findex(read) vindex(IFS, use of) -ifzman(xitem(tt(read) [ tt(-rszpqAclneE) ] [ tt(-t) [ var(num) ] ] [ tt(-k) [ var(num) ] ] [ tt(-d) var(delim) ])) -item(ifnzman(tt(read) [ tt(-rszpqAclneE) ] [ tt(-t) [ var(num) ] ] [ tt(-k) [ var(num) ] ] [ tt(-d) var(delim) ]) [ tt(-u) var(n) ] [ var(name)[tt(?)var(prompt)] ] [ var(name) ... ])( +redef(SPACES)(0)(tt(ifztexi(NOTRANS(@ @ @ @ @ ))ifnztexi( ))) +xitem(tt(read )[ tt(-rszpqAclneE) ] [ tt(-t) [ var(num) ] ] [ tt(-k) [ var(num) ] ] [ tt(-d) var(delim) ]) +item(SPACES()[ tt(-u) var(n) ] [ var(name)[tt(?)var(prompt)] ] [ var(name) ... ])( vindex(REPLY, use of) vindex(reply, use of) Read one line and break it into fields using the characters @@ -1441,7 +1443,9 @@ cindex(parameters, positional) cindex(parameters, setting array) cindex(array parameters, setting) pindex(KSH_ARRAYS, use of) -item(tt(set) [ {tt(PLUS())|tt(-)}var(options) | {tt(PLUS())|tt(-)}tt(o) [ var(option_name) ] ] ... [ {tt(PLUS())|tt(-)}tt(A) [ var(name) ] ] [ var(arg) ... ])( +redef(SPACES)(0)(tt(ifztexi(NOTRANS(@ @ @ @ ))ifnztexi( ))) +xitem(tt(set )[ {tt(PLUS())|tt(-)}var(options) | {tt(PLUS())|tt(-)}tt(o) [ var(option_name) ] ] ... [ {tt(PLUS())|tt(-)}tt(A) [ var(name) ] ]) +item(SPACES()[ var(arg) ... ])( Set the options for the shell and/or set the positional parameters, or declare and set an array. If the tt(-s) option is given, it causes the specified arguments to be sorted before assigning them to the positional @@ -1687,11 +1691,12 @@ Equivalent to tt(whence -v). findex(typeset) cindex(parameters, setting) cindex(parameters, declaring) -xitem(tt(typeset) [ {tt(PLUS())|tt(-)}tt(AHUaghlmprtux) ] \ +redef(SPACES)(0)(tt(ifztexi(NOTRANS(@ @ @ @ @ @ @ @ ))ifnztexi( ))) +xitem(tt(typeset )[ {tt(PLUS())|tt(-)}tt(AHUaghlmprtux) ] \ [ {tt(PLUS())|tt(-)}tt(EFLRZi) [ var(n) ] ]) -xitem( [ tt(+) | var(name)[tt(=)var(value)] ... ]) -xitem(tt(typeset) tt(-T) [ {tt(PLUS())|tt(-)}tt(Uglprux) ] [ {tt(PLUS())|tt(-)}tt(LRZ) [ var(n) ] ]) -xitem( [ tt(+) | var(SCALAR)[tt(=)var(value)] var(array) [ var(sep) ] ]) +xitem(SPACES()[ tt(+) | var(name)[tt(=)var(value)] ... ]) +xitem(tt(typeset )tt(-T) [ {tt(PLUS())|tt(-)}tt(Uglprux) ] [ {tt(PLUS())|tt(-)}tt(LRZ) [ var(n) ] ]) +xitem(SPACES()[ tt(+) | var(SCALAR)[tt(=)var(value)] var(array) [ var(sep) ] ]) item(tt(typeset) tt(-f) [ {tt(PLUS())|tt(-)}tt(TUkmtuz) ] [ tt(+) | var(name) ... ])( Set or display attributes and values for shell parameters. diff --git a/Doc/Zsh/expn.yo b/Doc/Zsh/expn.yo index 85191ed..1089ddf 100644 --- a/Doc/Zsh/expn.yo +++ b/Doc/Zsh/expn.yo @@ -1147,7 +1147,9 @@ be treated as patterns. This applies to the string arguments of flags that follow tt(~) within the same set of parentheses. Compare with tt(~) outside parentheses, which forces the entire substituted string to be treated as a pattern. Hence, for example, + example([[ "?" = ${(~j.|.)array} ]]) + treats `tt(|)' as a pattern and succeeds if and only if tt($array) contains the string `tt(?)' as an element. The tt(~) may be repeated to toggle the behaviour; its effect only lasts to the diff --git a/Doc/Zsh/options.yo b/Doc/Zsh/options.yo index fceb141..032423d 100644 --- a/Doc/Zsh/options.yo +++ b/Doc/Zsh/options.yo @@ -1037,7 +1037,7 @@ pindex(NO_GLOBAL_EXPORT) pindex(GLOBALEXPORT) pindex(NOGLOBALEXPORT) cindex(environment, and local parameters) -item(tt(GLOBAL_EXPORT) (tt()))( +item(tt(GLOBAL_EXPORT) )( If this option is set, passing the tt(-x) flag to the builtins tt(declare), tt(float), tt(integer), tt(readonly) and tt(typeset) (but not tt(local)) will also set the tt(-g) flag; hence parameters exported to diff --git a/Doc/Zsh/params.yo b/Doc/Zsh/params.yo index e7fad2d..44df07c 100644 --- a/Doc/Zsh/params.yo +++ b/Doc/Zsh/params.yo @@ -1675,7 +1675,7 @@ ifzman(zmanref(zshcompsys))\ ifnzman(noderef(Completion System)). ) vindex(ZLE_RPROMPT_INDENT) -item(tt(ZLE_RPROMPT_INDENT ))( +item(tt(ZLE_RPROMPT_INDENT) )( If set, used to give the indentation between the right hand side of the right prompt in the line editor as given by tt(RPS1) or tt(RPROMPT) and the right hand side of the screen. If not set, the value 1 is used. diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo index c783567..16d661f 100644 --- a/Doc/Zsh/zle.yo +++ b/Doc/Zsh/zle.yo @@ -339,10 +339,11 @@ by `tt(bindkey -m)'. findex(vared) cindex(parameters, editing) cindex(editing parameters) -xitem(tt(vared) [ tt(-Aache) ] [ tt(-p) var(prompt) ] [ tt(-r) var(rprompt) ]) -xitem( [ tt(-M) var(main-keymap) ] [ tt(-m) var(vicmd-keymap) ]) -xitem( [ tt(-i) var(init-widget) ] [ tt(-f) var(finish-widget) ]) -item( [ tt(-t) var(tty) ] var(name))( +redef(SPACES)(0)(tt(ifztexi(NOTRANS(@ @ @ @ @ @ ))ifnztexi( ))) +xitem(tt(vared )[ tt(-Aache) ] [ tt(-p) var(prompt) ] [ tt(-r) var(rprompt) ]) +xitem(SPACES()[ tt(-M) var(main-keymap) ] [ tt(-m) var(vicmd-keymap) ]) +xitem(SPACES()[ tt(-i) var(init-widget) ] [ tt(-f) var(finish-widget) ]) +item(SPACES()[ tt(-t) var(tty) ] var(name))( The value of the parameter var(name) is loaded into the edit buffer, and the line editor is invoked. When the editor exits, var(name) is set to the string value returned by the editor. -- 1.9.5 (Apple Git-50.3)