* How to link to zsh manual section? @ 2015-02-06 23:23 zzapper 2015-02-07 11:52 ` zzapper ` (3 more replies) 0 siblings, 4 replies; 15+ messages in thread From: zzapper @ 2015-02-06 23:23 UTC (permalink / raw) To: zsh-users A few tips on negotiating the zsh manuals please man zshall etc -- zzapper https://twitter.com/dailyzshtip --- This email has been checked for viruses by Avast antivirus software. http://www.avast.com ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-06 23:23 How to link to zsh manual section? zzapper @ 2015-02-07 11:52 ` zzapper 2015-02-07 12:54 ` Mikael Magnusson 2015-02-07 20:00 ` Bart Schaefer ` (2 subsequent siblings) 3 siblings, 1 reply; 15+ messages in thread From: zzapper @ 2015-02-07 11:52 UTC (permalink / raw) To: zsh-users zzapper <david@rayninfo.co.uk> wrote in news:XnsA439EDE5777Ddavidrayninfocouk@80.91.229.13: > A few tips on negotiating the zsh manuals please > e.g. I want to get the man section on the function age which I located by searching zshall for \<age\> but there must be a better way? -- zzapper https://twitter.com/dailyzshtip --- This email has been checked for viruses by Avast antivirus software. http://www.avast.com ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-07 11:52 ` zzapper @ 2015-02-07 12:54 ` Mikael Magnusson 2015-02-07 17:17 ` Ray Andrews 0 siblings, 1 reply; 15+ messages in thread From: Mikael Magnusson @ 2015-02-07 12:54 UTC (permalink / raw) To: zzapper; +Cc: Zsh Users On Sat, Feb 7, 2015 at 12:52 PM, zzapper <david@rayninfo.co.uk> wrote: > zzapper <david@rayninfo.co.uk> wrote in > news:XnsA439EDE5777Ddavidrayninfocouk@80.91.229.13: > >> A few tips on negotiating the zsh manuals please >> > > e.g. I want to get the man section on the function age > > which I located by searching zshall for \<age\> but there must be a better > way? You might want to look at the pdf version of the manual, it has handy indices at the end. All references (or at least many) are also clickable. -- Mikael Magnusson ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-07 12:54 ` Mikael Magnusson @ 2015-02-07 17:17 ` Ray Andrews 0 siblings, 0 replies; 15+ messages in thread From: Ray Andrews @ 2015-02-07 17:17 UTC (permalink / raw) To: zsh-users On 02/07/2015 04:54 AM, Mikael Magnusson wrote: > You might want to look at the pdf version of the manual, it has handy > indices at the end. All references (or at least many) are also clickable. Good idea. Which one, and where? One of the reasons I myself haven't read the manual yet, is that one is never sure one has the correct/best document, there are so many of them floating around in varying states of obsolescence. I wish we had a sort of reading list of all the recommended docs, manuals, introductions, how-to's, etc. I guess one would start at sourceforge, but there is so much else that might or might not be worth reading. ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-06 23:23 How to link to zsh manual section? zzapper 2015-02-07 11:52 ` zzapper @ 2015-02-07 20:00 ` Bart Schaefer [not found] ` <150207120056.ZM10752__13292.4999263652$1423339408$gmane$org@torch.brasslantern.com> 2015-02-08 18:46 ` Christian Neukirchen 3 siblings, 0 replies; 15+ messages in thread From: Bart Schaefer @ 2015-02-07 20:00 UTC (permalink / raw) To: zsh-users On Feb 6, 11:23pm, zzapper wrote: } } A few tips on negotiating the zsh manuals please In addition to what Mikael said about the PDF, using the "info" reader (or emacs itself if that's your editor of choice) to browse the texinfo documentation is probably the best interactive method for finding a specific section, command, or topic. It's the source for the PDF so has all the same indices, and has one-keystroke commands for jumping to the top of the current section or back to the last place you were reading, etc. If you have a build tree and have installed yodl, you can read the doc for your most recent rebuild with: make info info -f Doc/zsh.info Otherwise "info zsh" should pull up the doc for the installed zsh package. ^ permalink raw reply [flat|nested] 15+ messages in thread
[parent not found: <150207120056.ZM10752__13292.4999263652$1423339408$gmane$org@torch.brasslantern.com>]
* Re: How to link to zsh manual section? [not found] ` <150207120056.ZM10752__13292.4999263652$1423339408$gmane$org@torch.brasslantern.com> @ 2015-02-07 21:13 ` Stephane Chazelas 2015-02-08 10:00 ` zzapper 0 siblings, 1 reply; 15+ messages in thread From: Stephane Chazelas @ 2015-02-07 21:13 UTC (permalink / raw) To: Bart Schaefer; +Cc: zsh-users 2015-02-07 12:00:56 -0800, Bart Schaefer: > On Feb 6, 11:23pm, zzapper wrote: > } > } A few tips on negotiating the zsh manuals please > > In addition to what Mikael said about the PDF, using the "info" reader > (or emacs itself if that's your editor of choice) to browse the texinfo > documentation is probably the best interactive method for finding a > specific section, command, or topic. It's the source for the PDF so > has all the same indices, and has one-keystroke commands for jumping > to the top of the current section or back to the last place you were > reading, etc. > > If you have a build tree and have installed yodl, you can read the doc > for your most recent rebuild with: > > make info > info -f Doc/zsh.info > > Otherwise "info zsh" should pull up the doc for the installed zsh package. And for age: info --index-search=age zsh (or in info zsh, press i to get the index (with completion)). IMO, info is several orders of magnitude better for browsing the zsh manual than bash. On Debian and derivatives, install the zsh-doc package to get it. -- Stephane ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-07 21:13 ` Stephane Chazelas @ 2015-02-08 10:00 ` zzapper 0 siblings, 0 replies; 15+ messages in thread From: zzapper @ 2015-02-08 10:00 UTC (permalink / raw) To: zsh-users Stephane Chazelas <stephane.chazelas@gmail.com> wrote in news:20150207211345.GA8278@chaz.gmail.com: > 2015-02-07 12:00:56 -0800, Bart Schaefer: >> On Feb 6, 11:23pm, zzapper wrote: >> } >> } A few tips on negotiating the zsh manuals please >> >> In addition to what Mikael said about the PDF, using the "info" >> reader (or emacs itself if that's your editor of choice) to browse >> the texinfo documentation is probably the best interactive method for >> finding a specific section, command, or topic. It's the source for >> the PDF so has all the same indices, and has one-keystroke commands >> for jumping to the top of the current section or back to the last >> place you were reading, etc. >> > > info --index-search=age zsh > nice!!! -- zzapper https://twitter.com/dailyzshtip --- This email has been checked for viruses by Avast antivirus software. http://www.avast.com ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-06 23:23 How to link to zsh manual section? zzapper ` (2 preceding siblings ...) [not found] ` <150207120056.ZM10752__13292.4999263652$1423339408$gmane$org@torch.brasslantern.com> @ 2015-02-08 18:46 ` Christian Neukirchen 2015-02-09 13:33 ` zzapper 2015-02-09 13:52 ` René Neumann 3 siblings, 2 replies; 15+ messages in thread From: Christian Neukirchen @ 2015-02-08 18:46 UTC (permalink / raw) To: zsh-users zzapper <david@rayninfo.co.uk> writes: > A few tips on negotiating the zsh manuals please > > man zshall etc # zman -- easier browsing of zsh manpage # 20sep2011 +chris+ zman() { PAGER="less -g -s '+/^ "$1"'" man zshall } In doubt, press "n" a few times for the next results. -- Christian Neukirchen <chneukirchen@gmail.com> http://chneukirchen.org ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-08 18:46 ` Christian Neukirchen @ 2015-02-09 13:33 ` zzapper 2015-02-09 13:52 ` René Neumann 1 sibling, 0 replies; 15+ messages in thread From: zzapper @ 2015-02-09 13:33 UTC (permalink / raw) To: zsh-users Christian Neukirchen <chneukirchen@gmail.com> wrote in > > # zman -- easier browsing of zsh manpage > # 20sep2011 +chris+ > zman() { > PAGER="less -g -s '+/^ "$1"'" man zshall > } Christian this doesn't work for me: is there a quoting issue? -- zzapper https://twitter.com/dailyzshtip --- This email has been checked for viruses by Avast antivirus software. http://www.avast.com ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-08 18:46 ` Christian Neukirchen 2015-02-09 13:33 ` zzapper @ 2015-02-09 13:52 ` René Neumann 2015-02-11 12:26 ` İsmail Dönmez 1 sibling, 1 reply; 15+ messages in thread From: René Neumann @ 2015-02-09 13:52 UTC (permalink / raw) To: zsh-users Am 08.02.2015 um 19:46 schrieb Christian Neukirchen: > zzapper <david@rayninfo.co.uk> writes: > >> A few tips on negotiating the zsh manuals please >> >> man zshall etc > > # zman -- easier browsing of zsh manpage > # 20sep2011 +chris+ > zman() { > PAGER="less -g -s '+/^ "$1"'" man zshall > } > > In doubt, press "n" a few times for the next results. > Nice idea! One could enhance it a little (depending on one's preference, of course) by inserting (?i) into the search string, resulting in case-independent search. -> PAGER="less -g -s '+/(?i)^ "$1"'" man zshall - René ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-09 13:52 ` René Neumann @ 2015-02-11 12:26 ` İsmail Dönmez 2015-02-11 12:39 ` Peter Stephenson 2015-02-11 12:47 ` René Neumann 0 siblings, 2 replies; 15+ messages in thread From: İsmail Dönmez @ 2015-02-11 12:26 UTC (permalink / raw) To: René Neumann; +Cc: Zsh Users Hi, On Mon, Feb 9, 2015 at 3:52 PM, René Neumann <lists@necoro.eu> wrote: > Am 08.02.2015 um 19:46 schrieb Christian Neukirchen: >> zzapper <david@rayninfo.co.uk> writes: >> >>> A few tips on negotiating the zsh manuals please >>> >>> man zshall etc >> >> # zman -- easier browsing of zsh manpage >> # 20sep2011 +chris+ >> zman() { >> PAGER="less -g -s '+/^ "$1"'" man zshall >> } >> >> In doubt, press "n" a few times for the next results. >> > > Nice idea! One could enhance it a little (depending on one's preference, > of course) by inserting (?i) into the search string, resulting in > case-independent search. > > -> PAGER="less -g -s '+/(?i)^ "$1"'" man zshall This gives an "Invalid pattern" error here. ismail ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-11 12:26 ` İsmail Dönmez @ 2015-02-11 12:39 ` Peter Stephenson 2015-02-11 12:47 ` René Neumann 1 sibling, 0 replies; 15+ messages in thread From: Peter Stephenson @ 2015-02-11 12:39 UTC (permalink / raw) To: İsmail Dönmez, Zsh Users On Wed, 11 Feb 2015 14:26:54 +0200 İsmail Dönmez <ismail@donmez.ws> wrote: > > -> PAGER="less -g -s '+/(?i)^ "$1"'" man zshall > > This gives an "Invalid pattern" error here. The internal "" need quoting, although it's not clear that matches your problem... PAGER="less -g -s '+/(?i)^ \"$1\"'" man zshall (If they're actually needed, I haven't checked the less syntax...) pws ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-11 12:26 ` İsmail Dönmez 2015-02-11 12:39 ` Peter Stephenson @ 2015-02-11 12:47 ` René Neumann 2015-02-11 12:50 ` İsmail Dönmez 1 sibling, 1 reply; 15+ messages in thread From: René Neumann @ 2015-02-11 12:47 UTC (permalink / raw) To: zsh-users Am 11.02.2015 um 13:26 schrieb İsmail Dönmez: > Hi, > > On Mon, Feb 9, 2015 at 3:52 PM, René Neumann <lists@necoro.eu> wrote: >> Am 08.02.2015 um 19:46 schrieb Christian Neukirchen: >>> zzapper <david@rayninfo.co.uk> writes: >>> >>>> A few tips on negotiating the zsh manuals please >>>> >>>> man zshall etc >>> >>> # zman -- easier browsing of zsh manpage >>> # 20sep2011 +chris+ >>> zman() { >>> PAGER="less -g -s '+/^ "$1"'" man zshall >>> } >>> >>> In doubt, press "n" a few times for the next results. >>> >> >> Nice idea! One could enhance it a little (depending on one's preference, >> of course) by inserting (?i) into the search string, resulting in >> case-independent search. >> >> -> PAGER="less -g -s '+/(?i)^ "$1"'" man zshall > > This gives an "Invalid pattern" error here. Hmm, is your installation of 'less' using a regex library other than pcre? (Because the less manpage says, that the regex may be anything the underlying lib supports, and with libpcre-8.35 this works) - René ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-11 12:47 ` René Neumann @ 2015-02-11 12:50 ` İsmail Dönmez 2015-02-11 17:02 ` Daniel Shahaf 0 siblings, 1 reply; 15+ messages in thread From: İsmail Dönmez @ 2015-02-11 12:50 UTC (permalink / raw) To: René Neumann; +Cc: Zsh Users On Wed, Feb 11, 2015 at 2:47 PM, René Neumann <lists@necoro.eu> wrote: > Am 11.02.2015 um 13:26 schrieb İsmail Dönmez: >> Hi, >> >> On Mon, Feb 9, 2015 at 3:52 PM, René Neumann <lists@necoro.eu> wrote: >>> Am 08.02.2015 um 19:46 schrieb Christian Neukirchen: >>>> zzapper <david@rayninfo.co.uk> writes: >>>> >>>>> A few tips on negotiating the zsh manuals please >>>>> >>>>> man zshall etc >>>> >>>> # zman -- easier browsing of zsh manpage >>>> # 20sep2011 +chris+ >>>> zman() { >>>> PAGER="less -g -s '+/^ "$1"'" man zshall >>>> } >>>> >>>> In doubt, press "n" a few times for the next results. >>>> >>> >>> Nice idea! One could enhance it a little (depending on one's preference, >>> of course) by inserting (?i) into the search string, resulting in >>> case-independent search. >>> >>> -> PAGER="less -g -s '+/(?i)^ "$1"'" man zshall >> >> This gives an "Invalid pattern" error here. > > Hmm, is your installation of 'less' using a regex library other than > pcre? (Because the less manpage says, that the regex may be anything the > underlying lib supports, and with libpcre-8.35 this works) That explains it, mine is not linking to pcre. However looks like even without ?i syntax it works case-independent. Regards, ismail ^ permalink raw reply [flat|nested] 15+ messages in thread
* Re: How to link to zsh manual section? 2015-02-11 12:50 ` İsmail Dönmez @ 2015-02-11 17:02 ` Daniel Shahaf 0 siblings, 0 replies; 15+ messages in thread From: Daniel Shahaf @ 2015-02-11 17:02 UTC (permalink / raw) To: İsmail Dönmez; +Cc: René Neumann, Zsh Users İsmail Dönmez wrote on Wed, Feb 11, 2015 at 14:50:14 +0200: > On Wed, Feb 11, 2015 at 2:47 PM, René Neumann <lists@necoro.eu> wrote: > > Am 11.02.2015 um 13:26 schrieb İsmail Dönmez: > >> Hi, > >> > >> On Mon, Feb 9, 2015 at 3:52 PM, René Neumann <lists@necoro.eu> wrote: > >>> Am 08.02.2015 um 19:46 schrieb Christian Neukirchen: > >>>> zzapper <david@rayninfo.co.uk> writes: > >>>> > >>>>> A few tips on negotiating the zsh manuals please > >>>>> > >>>>> man zshall etc > >>>> > >>>> # zman -- easier browsing of zsh manpage > >>>> # 20sep2011 +chris+ > >>>> zman() { > >>>> PAGER="less -g -s '+/^ "$1"'" man zshall > >>>> } > >>>> > >>>> In doubt, press "n" a few times for the next results. > >>>> > >>> > >>> Nice idea! One could enhance it a little (depending on one's preference, > >>> of course) by inserting (?i) into the search string, resulting in > >>> case-independent search. > >>> > >>> -> PAGER="less -g -s '+/(?i)^ "$1"'" man zshall > >> > >> This gives an "Invalid pattern" error here. > > Try adding the -i flag to the 'less' invocation, and removing the (?i). > > Hmm, is your installation of 'less' using a regex library other than > > pcre? (Because the less manpage says, that the regex may be anything the > > underlying lib supports, and with libpcre-8.35 this works) > > That explains it, mine is not linking to pcre. However looks like even > without ?i syntax it works case-independent. Usually, less is case-sensitive unless the -i command-line flag is passed (or applied interactively). Daniel ^ permalink raw reply [flat|nested] 15+ messages in thread
end of thread, other threads:[~2015-02-11 17:02 UTC | newest] Thread overview: 15+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2015-02-06 23:23 How to link to zsh manual section? zzapper 2015-02-07 11:52 ` zzapper 2015-02-07 12:54 ` Mikael Magnusson 2015-02-07 17:17 ` Ray Andrews 2015-02-07 20:00 ` Bart Schaefer [not found] ` <150207120056.ZM10752__13292.4999263652$1423339408$gmane$org@torch.brasslantern.com> 2015-02-07 21:13 ` Stephane Chazelas 2015-02-08 10:00 ` zzapper 2015-02-08 18:46 ` Christian Neukirchen 2015-02-09 13:33 ` zzapper 2015-02-09 13:52 ` René Neumann 2015-02-11 12:26 ` İsmail Dönmez 2015-02-11 12:39 ` Peter Stephenson 2015-02-11 12:47 ` René Neumann 2015-02-11 12:50 ` İsmail Dönmez 2015-02-11 17:02 ` Daniel Shahaf
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).