From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 20856 invoked by alias); 6 Mar 2014 02:57:46 -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: 32466 Received: (qmail 17443 invoked from network); 6 Mar 2014 02:57:39 -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=-2.0 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FROM,HTML_MESSAGE,RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.2 X-Yahoo-Newman-Property: ymail-3 X-Yahoo-Newman-Id: 557306.23448.bm@omp1042.mail.ne1.yahoo.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s1024; t=1394074337; bh=q6atpoC1PJHMcgm+q2S8lAmAalvKGGBFILmuEtjo61g=; h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-Mailer:Message-ID:Date:From:Reply-To:Subject:To:MIME-Version:Content-Type; b=K7pEk3in0azSmzwEp19xqmrJzDyAJgKE81UhxRQ8pY0jMVEizv6tLYBXJlKNobhsyPXgOHKzMsN9QX4tS/WdqfOR3FKFSNCoZxBgj6fM32u6btDwEV7seoyXMYJHEQx6Wl0R2hxrNmhebhBf3x9IJ2xqn6TyFVylzohLfWzqUPM= DomainKey-Signature:a=rsa-sha1; q=dns; c=nofws; s=s1024; d=yahoo.com; h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-Mailer:Message-ID:Date:From:Reply-To:Subject:To:MIME-Version:Content-Type; b=dEIa6eZJ7D8GKnm3xPbEB1cWBYO6B5tuPaZPqkvv0NuV0fQAaFEgXeI6d764Scuj3wVwt3ayFXY5J/SLmdqEeW0GZFj94cjXXp5qp84iwtqDnMSFgLsmU3gnmU5n/wdUG4iGhX+Ef1OdHNTtnVp3/k42LnO1Y0cKjkJHNT/wZuo=; X-YMail-OSG: T4kSUxYVM1mq05Y9Q3dhbO1i4_azvskLntNJFxAdtLBYuRQ mWkOs8atyU.3Hi8NGGJ97WQAf7EeSHJDkbQL3BoqYvX0RFcUYLDXJ3mM7f0W LfnW1LgcB4s.v6puytOcM62lyYM3kDU0YeTodHM_BybdW2b8HBHakL4rO2U3 PEF_5gPl1C4x_kv50TpIvg2UScIEjZQ3jKiXkPEa.BXF24wp_Y2Lw8kkqUsA jctq1lYO0XYKuaFltElysvjyE12AnTTE64tWaJuReYn_e0sF0L37PMyG06Pz JM4q8vUdQTT6BhIldbh4Cn_i3xUyN7HsCuqpgPH4FoTOQE8uBtzrOfPyn.Ao s0e3GZ0ER75t7ao54dfzLeRUCBWqTi9ad0HSkIKboZp2e9PJMci5VM3nKDCP KGHHjEguHdG1yAvGUYl8cRP3jsY_6rWz3_as1YRjEE6B4rRZAaoTudpadk5s MFrU6Ljc1cXY0WfnJ8BAHApm4rsthWCoHrAfMk1G1OFNUGQ5vv36qgaJK3zI JmXaRnZ6HunryM6BU.UM1Oqv3CZoCqWzDNiQ5We_iBX_UtKVQOBk8VZQQb09 mFVub9JeoToULHsDfZ_KdX9FOI5wc6vyJSIzLwuFnthEkNBjJNEpfswjm6DW t3BGFs.D8fi3ZaBr67klnvo3iA5qGOUMSX9K1Nd0WBhUZsB3uxbfz.kMJjkV I0a0M2OA7ug-- X-Rocket-MIMEInfo: 002.001,SGVsbG8sCgpXaGVuIEkgd2FzIHJlYWRpbmcgaHR0cDovL3pzaC5zb3VyY2Vmb3JnZS5uZXQvR3VpZGUvenNoZ3VpZGUwNi5odG1sLCBJIG5vdGljZWQgYSBtaXNzcGVsbGluZzogInBhcnNpaW5nIi7CoCBJIGRvbid0IGtub3cgdGhlIFJpZ2h0IFdheSB0byByZXBvcnQgdGhlIHR5cG8gdG8genNoLCBidXQgdGhlIFNvdXJjZUZvcmdlIHByb2plY3Qgc3VnZ2VzdHMgSSBzaG91bGQgZW1haWwgYSBwYXRjaCB0byB0aGlzIGFsaWFzLsKgIEknbSBhbHNvIG5ldyB0byBnaXQsIGJ1dCBJIHJhbiBhbiB4ZW1hY3MgaXMBMAEBAQE- X-Mailer: YahooMailWebService/0.8.177.636 Message-ID: <1394074336.77387.YahooMailNeo@web121905.mail.ne1.yahoo.com> Date: Wed, 5 Mar 2014 18:52:16 -0800 (PST) From: David Costanzo Reply-To: David Costanzo Subject: Typos in chapter 6 of the zsh guide To: "zsh-workers@zsh.org" MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="4535996-1856633423-1394074336=:77387" --4535996-1856633423-1394074336=:77387 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Hello,=0A=0AWhen I was reading http://zsh.sourceforge.net/Guide/zshguide06.= html, I noticed a misspelling: "parsiing".=A0 I don't know the Right Way to= report the typo to zsh, but the SourceForge project suggests I should emai= l a patch to this alias.=A0 I'm also new to git, but I ran an xemacs ispell= over c6.yo and here's the result of "git diff":=0A=0Adiff --git a/Guide/zs= hguide/c6.yo b/Guide/zshguide/c6.yo=0Aindex fe1b0df..115ba40 100755=0A--- a= /Guide/zshguide/c6.yo=0A+++ b/Guide/zshguide/c6.yo=0A@@ -2358,7 +2358,7 @@ = pattern characters in the existing string are active, so this is a cross=0A= =A0between expansion and completion.=A0 You can also give it a numeric pref= ix to=0A=A0show the tt(N)th most recently modified file that matches the pa= ttern.=0A=A0=0A-By the way, you can actually do the same by setting appropi= ate styles,=0A+By the way, you can actually do the same by setting appropri= ate styles,=0A=A0without any new functions.=A0 The trick is to persuade the= system to use=0A=A0the normal tt(_files) completer with the tt(file-sort) = style.=A0 By=0A=A0restricting the use of the styles to the context of the w= idget --- which=0A@@ -2386,7 +2386,7 @@ itemize(=0A=A0=A0=A0=A0=A0 completi= on so far didn't work.=0A=A0=A0 it() First, tt(_menu) comes along; it actua= lly does nothing more=0A=A0=A0=A0=A0=A0 than tell the system to use menu co= mpletion.=0A-=A0 it() Then tt(_files) generats a list of files.=A0 This use= s=0A+=A0 it() Then tt(_files) generates a list of files.=A0 This uses=0A=A0= =A0=A0=A0=A0 the tt(file-sort) and tt(file-patterns) styles defined for the= =0A=A0=A0=A0=A0=A0 tt(most-recent-file) context.=A0 They produce a set of f= iles in=0A=A0=A0=A0=A0=A0 modification time order, and include only regular= files (so not=0A@@ -2415,7 +2415,7 @@ Omit the tt(file-patterns) line if y= ou don't want the match restricted=0A=A0to regular files (I sometimes need = the most recently modified directory,=0A=A0but often it's irrelevant).=A0 T= he whole version using styles comes from=0A=A0Oliver Kiddle, who recommends= using tt(_generic) in this way any time=0A-you want to generate a widge fr= om a specific completion such as=0A+you want to generate a widget from a sp= ecific completion such as=0A=A0tt(_files).=A0 There is a brief section on t= t(_generic) below.=0A=A0=0A=A0subsect(tt(_next_tags))=0A@@ -2987,7 +2987,7 = @@ subsect(The dispatcher)=0A=A0This top level is only necessary for comple= x commands with multiple=0A=A0subcommands.=A0 There are interesting titbits= here, but if you just want=0A=A0to know how to complete a command with ord= inary UNIX-style argument=0A-parsiing, skip to the next section.=0A+parsing= , skip to the next section.=0A=A0=0A=A0The main tt(_perforce) function has = the two purposes described at the top of=0A=A0the previous subsection.=A0 W= e need to decide whether we are in the first=0A@@ -3195,7 +3195,7 @@ syntax= , but in your case you may get `tt(-)tt(-)' as the separator.=0A=A0seemed y= ou'd already got to the last argument:=A0 it's possible for=0A=A0options to= have multiple arguments, and you can continue having=0A=A0sets of tt(:)var= (description)tt(:)var(action) pairs.=A0 This means the=0A-system needs some= way of distinguishing these colons from ones indside=0A+system needs some = way of distinguishing these colons from ones inside=0A=A0arguments.=A0 Whil= e I'm digressing, you may also have noticed that I could=0A=A0have written = the tt(-s)var(X) as an option with arguments, in which case=0A=A0you can ha= ve a bonus point.)=0A@@ -3271,7 +3271,7 @@ tt(^xh) to tell you about valid = tags, you'll see tt(_arguments) has its=0A=A0own generic tag, tt(argument-r= est); this isn't usually all that useful,=0A=A0so we are going to supply mo= re specific ones.=0A=A0=0A-In the first possiblity, it's the standard one f= or files, `tt(files).=0A+In the first possibility, it's the standard one fo= r files, `tt(files).=0A=A0The function is the basic low-level one for compl= eting files, too; it's=0A=A0described below, but you already know a lot abo= ut the effect since it's=0A=A0the completion system's workhorse which you u= se it all the time without=0A@@ -3413,7 +3413,7 @@ tt("$(cmd)") syntax; if = the output is empty, because its quoted you=0A=A0still get one zero-length = string output, which we don't want.=0A=A0=0A=A0Finally, we pass the result = to tt(compadd) as before.=A0 Again, tags and=0A-the description havealready= been handled and we just need to make sure=0A+the description have already= been handled and we just need to make sure=0A=A0the appropriate options ge= t passed in with tt("$@").=A0 This time we use=0A=A0the `tt(-a)' option whi= ch tells tt(compadd) that any arguments are array=0A=A0name, not a list of = completions.=A0 This is more efficient; compadd only=0A@@ -3484,7 +3484,7 @= @ we only need to look at what is at the left of the cursor, stored in=0A= =A0tt($LBUFFER).=0A=A0=0A=A0The function is called with the length of the s= uffix added to the=0A-function.=A0 In this case, it's just a space --- we'v= e finshed a normal=0A+function.=A0 In this case, it's just a space --- we'v= e finished a normal=0A=A0completion, so the system has automatically added = a space to what's on=0A=A0the command line.=A0 We therefore check we've jus= t got one single=0A=A0character in the suffix, to avoid getting confused.= =0A@@ -4215,7 +4215,7 @@ The tt(_description) function calls another functi= on tt(_setup) to do much=0A=A0of the setting up of styles for the particula= r tag.=A0 Mostly, tt(_setup) is=0A=A0buried deeply enough that you don't ne= ed to worry about it yourself.=0A=A0Sometimes you can't do completion, and = just want to print a message=0A-unconditionaly to say so, irrespective of t= ags etc.; the function=0A+unconditionally to say so, irrespective of tags e= tc.; the function=0A=A0tt(_message) does this, taking the message as its so= le argument.=0A=A0=0A=A0There are two levels above that; these implement th= e tags mechanism in --4535996-1856633423-1394074336=:77387--