completion for man

completion for man

[Andy Spiegl]

Recently I heard/read that there is a new wonderful completion function for
man with support sections.  But my zsh (v4.3.2) doesn't do it and always
just completes the command names:

 condor:~>man <TAB>
 zsh: do you wish to see all 13618 possibilities (6810 lines)? 

 condor:~>man 8 <TAB>
 zsh: do you wish to see all 13618 possibilities (6810 lines)? 

Is there maybe some configuration option I have to set?

Thanks,
 Andy.

-- 
 Fotos: francisco.spiegl.de            o      _     _         _              
 Infos: peru.spiegl.de       __o      /\_   _ \\o  (_)\__/o  (_)         -o) 
 Andy, Heidi, Francisco    _`\<,_    _>(_) (_)/<_    \_| \   _|/' \/      /\\
 heidi.und.andy@spiegl.de (_)/ (_)  (_)        (_)   (_)    (_)'  _\o_   _\_v
 ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
 As far as we know our computer has never had an undetected error.

Re: completion for man

[Frank Terbeck]

Andy Spiegl <zsh.Andy@spiegl.de>:
> Recently I heard/read that there is a new wonderful completion function for
> man with support sections.  But my zsh (v4.3.2) doesn't do it and always
> just completes the command names:
> 
>  condor:~>man <TAB>
>  zsh: do you wish to see all 13618 possibilities (6810 lines)? 
> 
>  condor:~>man 8 <TAB>
>  zsh: do you wish to see all 13618 possibilities (6810 lines)? 
> 
> Is there maybe some configuration option I have to set?

Hi Andy,

Starting from 'zsh -f' you need the following:

[snip]
zmodload zsh/complist
autoload -U compinit && compinit
zstyle ':completion:*'              menu select
zstyle ':completion:*:*:man:*'      menu yes
zstyle ':completion:*'              group-name ''
zstyle ':completion:*:manuals'      separate-sections true
zstyle ':completion:*:manuals.*'    insert-sections   true
zstyle ':completion:*:descriptions' format "- %d -"
[snap]

You can even do:
zstyle ':completion:*:manuals.(^1*)' insert-sections true

...to add the section number for all sections but section number one.

Regards, Frank

Re: completion for man

[Andy Spiegl]

> Starting from 'zsh -f' you need the following:
Thanks!  Great, now it's showing me the sections.

> You can even do:
> zstyle ':completion:*:manuals.(^1*)' insert-sections true
> 
> ...to add the section number for all sections but section number one.
Hm, that part doesn't seem to work...

condor:~>man 2 <TAB>
interactive: []
- manual page, section 1 -
\[                                3ddesk                                  3ddeskd                    
411toppm                          822-date                                a2p                        
a2ping                            a2ps                                    a52dec                     
a5booklet                         aa3d                                    aaflip                     
...

Shouldn't it be listing only pages out of section 2 here?

Thanks,
 Andy.

-- 
 When you become obsessed with the enemy, you become the enemy.

Re: completion for man

[Frank Terbeck]

Andy Spiegl <zsh.Andy@spiegl.de>:
[...]
> > You can even do:
> > zstyle ':completion:*:manuals.(^1*)' insert-sections true
> > ...to add the section number for all sections but section number one.
> Hm, that part doesn't seem to work...
> 
> condor:~>man 2 <TAB>
> interactive: []
> - manual page, section 1 -
> \[                                3ddesk                                  3ddeskd                    
> 411toppm                          822-date                                a2p                        
> a2ping                            a2ps                                    a52dec                     
> a5booklet                         aa3d                                    aaflip                     
> ...
> 
> Shouldn't it be listing only pages out of section 2 here?

Yes it should. And it does for me.
Have you tried the commands from 'zsh -f'?
I just checked it, and it does work (zsh v4.3.2 [debian/linux]).

Regards, Frank

Re: completion for man

[Andy Spiegl]

Hi Frank,

> Have you tried the commands from 'zsh -f'?
You're right.  In that case it works.
After half an hour of trial-and-error I found the cause
why it doesn't work here:

The following alias
 alias man='command man -a'
screws up the section completion.

The same happens if I hit TAB after "man -a 2 ".
Is that a bug or a feature?

Thanks,
 Andy.

-- 
 There is no particular mystery in animation...it's really very simple,
 and like anything that is simple, it is about the hardest thing in the
 world to do. --  Bill Tytla at the Walt Disney Studio, June 28, 1937.

Re: completion for man

[Bart Schaefer]

On Jun 24, 11:29pm, Andy Spiegl wrote:
}
} The same happens if I hit TAB after "man -a 2 ".
} Is that a bug or a feature?

It's neither, really.  The _man completer simply doesn't support any of
the GNU "man" command-line switches.  The only option it understands is
the crufty old "man -l" for manpage-formatting a named file rather than
by searching the manpath (which it appears GNU man doesn't even permit
any longer).