From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 22444 invoked by alias); 29 Aug 2017 19:02:30 -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: 41623 Received: (qmail 12532 invoked by uid 1010); 29 Aug 2017 19:02:30 -0000 X-Qmail-Scanner-Diagnostics: from know-smtprelay-omc-10.server.virginmedia.net by f.primenet.com.au (envelope-from , uid 7791) with qmail-scanner-2.11 (clamdscan: 0.99.2/21882. spamassassin: 3.4.1. Clear:RC:0(80.0.253.74):SA:0(-4.7/5.0):. Processed in 3.009191 secs); 29 Aug 2017 19:02:30 -0000 X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-4.7 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,SPF_PASS,T_DKIM_INVALID autolearn=ham autolearn_force=no version=3.4.1 X-Envelope-From: p.w.stephenson@ntlworld.com X-Qmail-Scanner-Mime-Attachments: | X-Qmail-Scanner-Zip-Files: | X-Originating-IP: [86.21.219.59] X-Authenticated-User: p.w.stephenson@ntlworld.com X-Spam: 0 X-Authority: v=2.1 cv=SeoKDalu c=1 sm=1 tr=0 a=utowdAHh8RITBM/6U1BPxA==:117 a=utowdAHh8RITBM/6U1BPxA==:17 a=L9H7d07YOLsA:10 a=9cW_t1CCXrUA:10 a=s5jvgZ67dGcA:10 a=kj9zAlcOel0A:10 a=x7bEGLp0ZPQA:10 a=6C0Nf4koS0rrCq1jW6MA:9 a=7Zwj6sZBwVKJAoWSPKxL6X1jA+E=:19 a=CjuIK1q_8ugA:10 Date: Tue, 29 Aug 2017 20:02:20 +0100 From: Peter Stephenson To: Zsh hackers list Subject: PATCH: for upated Yodl. Message-ID: <20170829200220.64471cde@ntlworld.com> X-Mailer: Claws Mail 3.11.1 (GTK+ 2.24.28; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ntlworld.com; s=meg.feb2017; t=1504033341; bh=614s13tA+6GoMTLGzikRYV3IXLHDy/tG+TgnYZkq8EA=; h=Date:From:To:Subject; b=Ug6bTOfMc/j/Bpf8GWDK7s7yUELO0t2jcrxcd5LhY/YcxfrICWDuHqI2GiMPYDG4r Fxwlp+FTAZkIA+A3lKjjnR0MgBfMIuO9NGCcUjws5t2EdCAlTd1UGIPCr2caEcVEOk MjDwC30QUUU/1tr8NMxvpeVMzYfnqac5eD2SeFAlWe0r1igceRfl2MeP4gnane8Rp6 n62PILjdp0cuxoOHL2s0czlMZG0ssE8hKJyu+gbwZv46BzNU4fZ8XBM0PzpkuM8Obz paG+ekRnn2bM9+UrMe9gdEPZ4j1+CG6I5jCbI80rcLVhIL8Nd05iszInUY97VdKcAH hR5MiLfcKFkCA== This removes warning messages with Yodl 3. However, it may not be convenient if anyone hasn't bothered updating Yodl --- and I'm not sure there's any other pressing reason to do so. So I don't need to apply this if anyone prefers a simple life. pws diff --git a/Etc/FAQ.yo b/Etc/FAQ.yo index adde2d5..6415045 100644 --- a/Etc/FAQ.yo +++ b/Etc/FAQ.yo @@ -242,9 +242,9 @@ sect(What is it good at?) in any other freely-available shell which zsh does not also have (except smallness). - itemize( + itemization( it() Command line editing: - itemize( + itemization( it() programmable completion: incorporates the ability to use the full power of zsh's globbing and shell programming features, it() multi-line commands editable as a single buffer (even files!), @@ -257,7 +257,7 @@ sect(What is it good at?) it() inline expansion of variables and history commands. ) it() Globbing --- extremely powerful, including: - itemize( + itemization( it() recursive globbing (cf. find), it() file attribute qualifiers (size, type, etc. also cf. find), it() full alternation and negation of patterns. @@ -447,7 +447,7 @@ label(21) substantial. As a summary of the status: - enumerate( + enumeration( myeit() because of all the options it is not safe to assume a general zsh run by a user will behave as if sh or ksh compatible; myeit() invoking zsh as sh or ksh (or if either is a symbolic link to @@ -500,9 +500,9 @@ tt(RM_STAR_SILENT), if `emulate ksh' is in effect. Capitalised words with underlines refer to shell options. - itemize( + itemization( it() Syntax: - itemize( + itemization( it()* Shell word splitting: see question link(3.1)(31). it()* Arrays are (by default) more csh-like than ksh-like: subscripts start at 1, not 0; tt(array[0]) refers to tt(array[1]); @@ -522,7 +522,7 @@ tt(RM_STAR_SILENT), this is a bug. Use mytt({ cmd1 && cmd2 } &) as a workaround. ) it() Command line substitutions, globbing etc.: - itemize( + itemization( it()* Failure to match a globbing pattern causes an error (use tt(NO_NOMATCH)). it()* The results of parameter substitutions are treated as plain text: @@ -565,14 +565,14 @@ tt(EXTENDED_GLOB). assignment specially as a single word. ) it() Command execution: - itemize( + itemization( it()* There is no tt($ENV) variable (use tt(/etc/zshrc), tt(~/.zshrc); note also tt($ZDOTDIR)). it()* tt($PATH) is not searched for commands specified at invocation without -c. ) it() Aliases and functions: - itemize( + itemization( it() The order in which aliases and functions are defined is significant: function definitions with () expand aliases -- see question \ link(2.3)(23). @@ -588,14 +588,14 @@ link(2.3)(23). and only the latter behave as true functions. ) it() Traps and signals: - itemize( + itemization( it()* Traps are not local to functions. The option LOCAL_TRAPS is available from 3.1.6. it() TRAPERR has become TRAPZERR (this was forced by UNICOS which has SIGERR). ) it() Editing: - itemize( + itemization( it() The options tt(gmacs), tt(viraw) are not supported. Use bindkey to change the editing behaviour: mytt(set -o {emacs,vi}) becomes `bindkey -{e,v}', although `set -o emacs' and `set -o vi' @@ -620,7 +620,7 @@ link(2.3)(23). ) ) it() Built-in commands: - itemize( + itemization( it() Some built-ins (tt(r), tt(autoload), tt(history), tt(integer) ...) were aliases in ksh. it() There is no built-in command newgrp: use e.g. mytt(alias @@ -628,7 +628,7 @@ link(2.3)(23). it() mytt(jobs) has no mytt(-n) flag. ) it() Other idiosyncrasies: - itemize( + itemization( it() mytt(select) always redisplays the list of selections on each loop. ) ) @@ -644,7 +644,7 @@ sect(Similarities with csh) particularly those with arguments. Csh-compatibility additions include: - itemize( + itemization( it() tt(logout), tt(rehash), tt(source), tt((un)limit) built-in commands. it() tt(*rc) file for interactive shells. it() Directory stacks. @@ -706,7 +706,7 @@ label(23) Here is Bart Schaefer's guide to converting csh aliases for zsh. - enumerate( + enumeration( myeit() If the csh alias references "parameters" (tt(\!:1), tt(\!*) etc.), then in zsh you need a function (referencing tt($1), tt($*) etc.). Otherwise, you can use a zsh alias. @@ -722,7 +722,7 @@ label(23) myeit() If you have aliases that refer to each other (tt(alias ls "ls -C"; alias lf "ls -F" ==> lf == ls -C -F)) then you must either: - itemize( + itemization( it() convert all of them to zsh functions; or it() after converting, be sure your .zshrc defines all of your aliases before it defines any of your functions. @@ -1097,7 +1097,7 @@ sect(What is the difference between `export' and the tt(ALL_EXPORT) option?) This may seem a useful shorthand, but in practice it can have unhelpful side effects: - enumerate( + enumeration( myeit() Since every variable is in the environment as well as remembered by the shell, the memory for it needs to be allocated twice. This is bigger as well as slower. @@ -1365,7 +1365,7 @@ sect(Why do my autoloaded functions not autoload [the first time]?) The problem is that there are two possible ways of autoloading a function (see the AUTOLOADING FUNCTIONS section of the zsh manual page zshmisc for more detailed information): - enumerate( + enumeration( myeit() The file contains just the body of the function, i.e. there should be no line at the beginning saying mytt(function foo {) or mytt(foo () {), and consequently no matching mytt(}) at the end. @@ -1709,7 +1709,7 @@ sect(What's wrong with cut and paste on my xterm?) `non-canonical input mode'. On the systems in question, input can be lost or re-ordered when the mode changes. There are actually two slightly different problems: - enumerate( + enumeration( myeit() When you paste something in while a programme is running, so that the shell only retrieves it later. Traditionally, there was a test which was used only on systems where the problem was known to exist, @@ -1931,7 +1931,7 @@ label(327) assume the option tt(EXTENDED_GLOB) is set and none of the pattern characters is disabled. - enumerate( + enumeration( myeit() mytt(**/foo~*bar*) matches any file called mytt(foo) in any subdirectory, except where mytt(bar) occurred somewhere in the path. For example, mytt(users/barstaff/foo) will be excluded by the mytt(~) @@ -2035,7 +2035,7 @@ sect(How does zsh deal with ambiguous completions?) (That's assuming you're at the end of the line, otherwise tt(\C-D) will delete the next character and you have to use tt(ESC-\C-D).) This can be changed by the following options, among others: - itemize( + itemization( it() with tt(NO_BEEP) set, that annoying beep goes away it() with tt(NO_LIST_BEEP), beeping is only turned off for ambiguous completions @@ -2243,7 +2243,7 @@ sect(How do I ensure multibyte input and output work on my system?) There are basically three components. - itemize( + itemization( it() The locale. This describes a whole series of features specific to countries or regions of which the character set is one. Usually it is controlled by the environment variable tt(LANG) (there are @@ -2436,7 +2436,7 @@ sect(What's on the wish-list?) particularly welcome for these tasks. Some future possibilities which have been suggested: - itemize( + itemization( it() The shell, in particular the line editor, should support Unicode characters. Initial support for this appeared in version 4.3; it is reasonably complete in the line editor but patchy elsewhere