How to link to zsh manual section?

How to link to zsh manual section?

[zzapper]

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

Re: How to link to zsh manual section?

[zzapper]

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

Re: How to link to zsh manual section?

[Mikael Magnusson]

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

Re: How to link to zsh manual section?

[Ray Andrews]

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.

Re: How to link to zsh manual section?

[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.

Re: How to link to zsh manual section?

[Stephane Chazelas]

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

Re: How to link to zsh manual section?

[zzapper]

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

Re: How to link to zsh manual section?

[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.

-- 
Christian Neukirchen  <chneukirchen@gmail.com>  http://chneukirchen.org

Re: How to link to zsh manual section?

[zzapper]

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

Re: How to link to zsh manual section?

[René Neumann]

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é

Re: How to link to zsh manual section?

[İ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.

ismail

Re: How to link to zsh manual section?

[Peter Stephenson]

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

Re: How to link to zsh manual section?

[René Neumann]

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é

Re: How to link to zsh manual section?

[İsmail Dönmez]

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

Re: How to link to zsh manual section?

[Daniel Shahaf]

İ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