Re: Bug#486283: Use description of modules from zshmodules

[Clint Adams <schizo@xxxxxxxxxx>]

On Sat, Jun 14, 2008 at 11:44:09PM +0200, JÃrg Sommer wrote:
> Hi,
> 
> run-help (mapped to ESC h) gives for modules only the hint to look at the
> zshmodules manpage. Instead, the part from this manpage should be shown.
> 
> % run-help sched |cat
> sched  See the section `The zsh/sched Module' in zshmodules(1).
> 
> % man zshmodules | sed -n '/THE ZSH\/SCHED/,/^T/p' |sed '$d'
> THE ZSH/SCHED MODULE
>        The zsh/sched module makes available one builtin command and one paramâ
>        eter.
> 
>        sched [-o] [+]hh:mm[:ss] command ...
>        sched [-o] [+]seconds command ...
>        sched [ -item ]
>               Make an entry in the scheduled list of commands to execute.  The
> 
> 
> Or you could move the HELPDIR stuff away and create run-help functions
> for them.
> 
> run-help-sched ()
> {
>     LESS="${LESS:--}p^THE ZSH/SCHED" man zshmodules
> }

I suppose we could, at build time, produce a list of '^module(' from
builtins.yo, then use that to do something more like the sed program
above.  That would seem to be more helpful than this:

Index: Functions/Misc/run-help
===================================================================
RCS file: /cvsroot/zsh/zsh/Functions/Misc/run-help,v
retrieving revision 1.12
diff -u -r1.12 run-help
--- Functions/Misc/run-help	10 Oct 2008 09:53:22 -0000	1.12
+++ Functions/Misc/run-help	30 Dec 2008 05:34:47 -0000
@@ -76,7 +76,7 @@
 	(clone) ;&
 	(ln|mkdir|mv|rm|rmdir|sync) ;&
 	(sched) ;&
-	(stat) man zshmodules;;
+	(echotc|echoti|sched|stat|zprof|zpty|zsocket|zstyle|ztcp) man zshmodules;;
 	(zftp) man zshftpsys;;
 	(*) man zshbuiltins;;
 	esac