Please find attached the announced patches for
run-help files generation, for simplicity all bundled into
one patch against current git master.
(This is my first attempt to post a patch to a mailing list;
I hope attachments are allowed).

Main part is a new (Bourne) shell script "generate-help.sh" which
uses man, clcrt, and Util/helpfiles (hence perl) to generate the
run-help files.

There are further patches to the build system, to run-help itself
and, since I was at it, I also added a _run-help completion file
to the patch.

The purpose of the patched build system is to call
generate-help.sh and to install/uninstall the help directoy
unless
./configure --disable-runhelpdir
or
./configure --enable-runhelpdir=
is used. (To make the patch active, autotools must be used
to generate the new configure script after the patch, of course).

run-help itself is patched to default to the default directory
HELPDIR=/usr/share/zsh/$ZSH_VERSION/help

The meaning of the new _run-help completion file should be clear...
(note that this file is not used, by default, since by default,
run-help is an alias to "man", and so, of course, usually the
"man" completion is used instead).


I agree, of course, that "generate-help.sh" should better
generate the run-help files directly from yodl, but I am not (yet)
familiar enough with yodl to do this.
If eventually somebody writes a script which can do this, this can
simply replace the current "generate-help.sh".

In the moment, I have not attempted to put the generated
run-help directory into the tarball, since this can lead
to other problems: This directory contains symlinks which
are not available on all systems...