* Bug in user guide @ 2011-02-04 4:17 cheer_xiao 2011-02-09 9:34 ` cheer_xiao 0 siblings, 1 reply; 14+ messages in thread From: cheer_xiao @ 2011-02-04 4:17 UTC (permalink / raw) To: zsh-workers In the first paragraph of 4.6.1(http://zsh.sourceforge.net/Guide/zshguide04.html#l100) array=LPAR()first should be array=(first I have been informed that we still cannot push changes to sf, so I hope it be fixed as soon as sf returns to normal. ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-04 4:17 Bug in user guide cheer_xiao @ 2011-02-09 9:34 ` cheer_xiao 2011-02-09 12:03 ` Frank Terbeck 0 siblings, 1 reply; 14+ messages in thread From: cheer_xiao @ 2011-02-09 9:34 UTC (permalink / raw) To: zsh-workers Another bug found: in the "echotc" section of 3.2.1 "Builtins for printing", "man 5 zsh" and "man -s 5 zsh" should be "man 5 termcap" and "man -s 5 termcap". BTW. Is access to sourceforge still blocked? Any one with the permission please fix these two bugs ASAP. (Correct my English if it sounds weird to you. Thanks!) ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-09 9:34 ` cheer_xiao @ 2011-02-09 12:03 ` Frank Terbeck 2011-02-10 1:42 ` cheer_xiao 0 siblings, 1 reply; 14+ messages in thread From: Frank Terbeck @ 2011-02-09 12:03 UTC (permalink / raw) To: cheer_xiao; +Cc: zsh-workers cheer_xiao wrote: > Another bug found: in the "echotc" section of 3.2.1 "Builtins for > printing", "man 5 zsh" and "man -s 5 zsh" should be "man 5 termcap" > and "man -s 5 termcap". > > BTW. Is access to sourceforge still blocked? Any one with the > permission please fix these two bugs ASAP. CVS is still down. Yes. Regards, Frank -- In protocol design, perfection has been reached not when there is nothing left to add, but when there is nothing left to take away. -- RFC 1925 ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-09 12:03 ` Frank Terbeck @ 2011-02-10 1:42 ` cheer_xiao 2011-02-10 15:04 ` Bart Schaefer 0 siblings, 1 reply; 14+ messages in thread From: cheer_xiao @ 2011-02-10 1:42 UTC (permalink / raw) To: Frank Terbeck; +Cc: zsh-workers On Wed, Feb 9, 2011 at 8:03 PM, Frank Terbeck <ft@bewatermyfriend.org> wrote: > CVS is still down. Yes. Thanks for the info. Some more thoughts about the user guide. The guide is, overall, well written. But I found two features missing in the user guide: 1) Mark the terms appearing for the first time in *bold*, 2) A comprehensive index. Does that sound fine to you all? If so, I'll take some time to improve the guide and post my improve version to the mailing list. ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-10 1:42 ` cheer_xiao @ 2011-02-10 15:04 ` Bart Schaefer 2011-02-11 5:15 ` cheer_xiao 0 siblings, 1 reply; 14+ messages in thread From: Bart Schaefer @ 2011-02-10 15:04 UTC (permalink / raw) To: zsh-workers On Feb 10, 9:42am, cheer_xiao wrote: } Subject: Re: Bug in user guide } } Some more thoughts about the user guide. The guide is, overall, well } written. But I found two features missing in the user guide: } 1) Mark the terms appearing for the first time in *bold*, } 2) A comprehensive index. } Does that sound fine to you all? If so, I'll take some time to improve } the guide and post my improve version to the mailing list. Just to be sure ... you're talking about http://zsh.sourceforge.net/Guide/zshguide.html ?? We'd certainly welcome any help with the guide (or any other docs, for that matter) so do jump in and send us suggested improvements. As for (1) in particular ... although the guide can be read linearly it's really more intended to to be navigated as hypertext, so adding more cross-references to places where terms are explained would probably be more useful than merely highlighting the "first" place they are used. Which ought to be possible if you're constructing an index anyway. Based on SourceForge's progress so far we might have our CVS back by sometime on Friday. ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-10 15:04 ` Bart Schaefer @ 2011-02-11 5:15 ` cheer_xiao 2011-02-15 11:22 ` cheer_xiao 0 siblings, 1 reply; 14+ messages in thread From: cheer_xiao @ 2011-02-11 5:15 UTC (permalink / raw) To: Bart Schaefer; +Cc: zsh-workers On Thu, Feb 10, 2011 at 11:04 PM, Bart Schaefer <schaefer@brasslantern.com> wrote: > [snip] > Just to be sure ... you're talking about > http://zsh.sourceforge.net/Guide/zshguide.html > ?? Yes. > We'd certainly welcome any help with the guide (or any other docs, for > that matter) so do jump in and send us suggested improvements. As for > (1) in particular ... although the guide can be read linearly it's > really more intended to to be navigated as hypertext, so adding more > cross-references to places where terms are explained would probably be > more useful than merely highlighting the "first" place they are used. > Which ought to be possible if you're constructing an index anyway. I think the user guide is intended for linear reading; it's quite hard for me to start somewhere in the middle. After all, that's what most "user guides" are; you should turn to the (more formal) documentation when you need reference. User guides are more like books, documentations dictionaries. Given its linear nature, I suppose that adding cross-references can be distracting and unnecessary (that's what the documentation needs), while highlighting the first appearance of terms is quite helpful. > Based on SourceForge's progress so far we might have our CVS back by > sometime on Friday. I'm looking forward to a heavily loaded "git pull"! (I'm not a native speaker so please correct my English if it sounds weird or impolite. Thanks!) ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-11 5:15 ` cheer_xiao @ 2011-02-15 11:22 ` cheer_xiao 2011-02-15 11:37 ` Peter Stephenson 0 siblings, 1 reply; 14+ messages in thread From: cheer_xiao @ 2011-02-15 11:22 UTC (permalink / raw) To: Bart Schaefer; +Cc: zsh-workers Sorry for the inactivity during the past few days. I wonder, does the source code of the user guide reside in a repository? Or simply in the maintainer's box? ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-15 11:22 ` cheer_xiao @ 2011-02-15 11:37 ` Peter Stephenson 2011-02-16 13:33 ` cheer_xiao 0 siblings, 1 reply; 14+ messages in thread From: Peter Stephenson @ 2011-02-15 11:37 UTC (permalink / raw) To: zsh-workers On Tue, 15 Feb 2011 19:22:11 +0800 cheer_xiao <xiaqqaix@gmail.com> wrote: > Sorry for the inactivity during the past few days. I wonder, does the > source code of the user guide reside in a repository? Or simply in the > maintainer's box? The tar file visible in the web service is the master copy, rsync'd from elsewhere via sourceforge's ssh service where necessary, so it's up to date. -- Peter Stephenson <pws@csr.com> Software Engineer Tel: +44 (0)1223 692070 Cambridge Silicon Radio Limited Churchill House, Cambridge Business Park, Cowley Road, Cambridge, CB4 0WZ, UK Member of the CSR plc group of companies. CSR plc registered in England and Wales, registered number 4187346, registered office Churchill House, Cambridge Business Park, Cowley Road, Cambridge, CB4 0WZ, United Kingdom ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-15 11:37 ` Peter Stephenson @ 2011-02-16 13:33 ` cheer_xiao 2011-02-16 13:39 ` Peter Stephenson 2011-02-16 13:46 ` Mikael Magnusson 0 siblings, 2 replies; 14+ messages in thread From: cheer_xiao @ 2011-02-16 13:33 UTC (permalink / raw) To: Peter Stephenson; +Cc: zsh-workers 6.4.1 of User Guide (http://zsh.sourceforge.net/Guide/zshguide06.html#l154) said There's an easy way of finding out what context you are in: at the point where you want to complete something, instead type `^Xh', and it will tell you. But it doesn't work here on my box. Nor was I able to find a pre-binded keystroke to perform this action. (I tried keybind | egrep '(context|completion)' .) Any hints? ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-16 13:33 ` cheer_xiao @ 2011-02-16 13:39 ` Peter Stephenson 2011-02-16 13:46 ` Mikael Magnusson 1 sibling, 0 replies; 14+ messages in thread From: Peter Stephenson @ 2011-02-16 13:39 UTC (permalink / raw) To: zsh-workers On Wed, 16 Feb 2011 21:33:07 +0800 cheer_xiao <xiaqqaix@gmail.com> wrote: > 6.4.1 of User Guide > (http://zsh.sourceforge.net/Guide/zshguide06.html#l154) said > > There's an easy way of finding out what context you are in: at the > point where you want to complete something, instead type `^Xh', and it > will tell you. > > But it doesn't work here on my box. Nor was I able to find a > pre-binded keystroke to perform this action. (I tried keybind | egrep > '(context|completion)' .) Any hints? The binding is to _complete_help; see Completion/Base/Widget/_complete_help. It should be set up by default when compinit is run, though what happens after that is another matter. -- Peter Stephenson <pws@csr.com> Software Engineer Tel: +44 (0)1223 692070 Cambridge Silicon Radio Limited Churchill House, Cambridge Business Park, Cowley Road, Cambridge, CB4 0WZ, UK Member of the CSR plc group of companies. CSR plc registered in England and Wales, registered number 4187346, registered office Churchill House, Cambridge Business Park, Cowley Road, Cambridge, CB4 0WZ, United Kingdom ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-16 13:33 ` cheer_xiao 2011-02-16 13:39 ` Peter Stephenson @ 2011-02-16 13:46 ` Mikael Magnusson 2011-02-16 13:48 ` cheer_xiao 1 sibling, 1 reply; 14+ messages in thread From: Mikael Magnusson @ 2011-02-16 13:46 UTC (permalink / raw) To: cheer_xiao; +Cc: zsh-workers On 16 February 2011 14:33, cheer_xiao <xiaqqaix@gmail.com> wrote: > 6.4.1 of User Guide (http://zsh.sourceforge.net/Guide/zshguide06.html#l154) said > > There's an easy way of finding out what context you are in: at the > point where you want to complete something, instead type `^Xh', and it > will tell you. > > But it doesn't work here on my box. Nor was I able to find a > pre-binded keystroke to perform this action. (I tried keybind | egrep > '(context|completion)' .) Any hints? Note that ^Xh means ctrl-x h, not ctrl-x ctrl-h, that would be ^X^H. And you want bindkey | grep complete -- Mikael Magnusson ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-16 13:46 ` Mikael Magnusson @ 2011-02-16 13:48 ` cheer_xiao 2011-02-16 13:51 ` Mikael Magnusson 0 siblings, 1 reply; 14+ messages in thread From: cheer_xiao @ 2011-02-16 13:48 UTC (permalink / raw) To: Mikael Magnusson; +Cc: zsh-workers On Wed, Feb 16, 2011 at 9:46 PM, Mikael Magnusson <mikachu@gmail.com> wrote: > On 16 February 2011 14:33, cheer_xiao <xiaqqaix@gmail.com> wrote: >> 6.4.1 of User Guide (http://zsh.sourceforge.net/Guide/zshguide06.html#l154) said >> >> There's an easy way of finding out what context you are in: at the >> point where you want to complete something, instead type `^Xh', and it >> will tell you. >> >> But it doesn't work here on my box. Nor was I able to find a >> pre-binded keystroke to perform this action. (I tried keybind | egrep >> '(context|completion)' .) Any hints? > > Note that ^Xh means ctrl-x h, not ctrl-x ctrl-h, that would be ^X^H. > And you want bindkey | grep complete I already knew this... Also, "bindkey | grep complete" gives: "^I" expand-or-complete ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-16 13:48 ` cheer_xiao @ 2011-02-16 13:51 ` Mikael Magnusson 2011-02-16 13:56 ` cheer_xiao 0 siblings, 1 reply; 14+ messages in thread From: Mikael Magnusson @ 2011-02-16 13:51 UTC (permalink / raw) To: cheer_xiao; +Cc: zsh-workers On 16 February 2011 14:48, cheer_xiao <xiaqqaix@gmail.com> wrote: > On Wed, Feb 16, 2011 at 9:46 PM, Mikael Magnusson <mikachu@gmail.com> wrote: >> On 16 February 2011 14:33, cheer_xiao <xiaqqaix@gmail.com> wrote: >>> 6.4.1 of User Guide (http://zsh.sourceforge.net/Guide/zshguide06.html#l154) said >>> >>> There's an easy way of finding out what context you are in: at the >>> point where you want to complete something, instead type `^Xh', and it >>> will tell you. >>> >>> But it doesn't work here on my box. Nor was I able to find a >>> pre-binded keystroke to perform this action. (I tried keybind | egrep >>> '(context|completion)' .) Any hints? >> >> Note that ^Xh means ctrl-x h, not ctrl-x ctrl-h, that would be ^X^H. >> And you want bindkey | grep complete > > I already knew this... Also, "bindkey | grep complete" gives: > "^I" expand-or-complete Have you run compinit? -- Mikael Magnusson ^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: Bug in user guide 2011-02-16 13:51 ` Mikael Magnusson @ 2011-02-16 13:56 ` cheer_xiao 0 siblings, 0 replies; 14+ messages in thread From: cheer_xiao @ 2011-02-16 13:56 UTC (permalink / raw) To: Mikael Magnusson; +Cc: zsh-workers On Wed, Feb 16, 2011 at 9:51 PM, Mikael Magnusson > Have you run compinit? Yes. Thanks for your hint, I figured it out. I put "bindkey -e" *after* "compinit" in my .zshrc. It works now. Next time I will post such questions to zsh-users before suspecting the correctness of the guide. Sorry for the noise. ^ permalink raw reply [flat|nested] 14+ messages in thread
end of thread, other threads:[~2011-02-16 14:15 UTC | newest] Thread overview: 14+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2011-02-04 4:17 Bug in user guide cheer_xiao 2011-02-09 9:34 ` cheer_xiao 2011-02-09 12:03 ` Frank Terbeck 2011-02-10 1:42 ` cheer_xiao 2011-02-10 15:04 ` Bart Schaefer 2011-02-11 5:15 ` cheer_xiao 2011-02-15 11:22 ` cheer_xiao 2011-02-15 11:37 ` Peter Stephenson 2011-02-16 13:33 ` cheer_xiao 2011-02-16 13:39 ` Peter Stephenson 2011-02-16 13:46 ` Mikael Magnusson 2011-02-16 13:48 ` cheer_xiao 2011-02-16 13:51 ` Mikael Magnusson 2011-02-16 13:56 ` cheer_xiao
Code repositories for project(s) associated with this public inbox https://git.vuxu.org/mirror/zsh/ This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).