Re: Install run-help and *.zwc files system wide in build system

[Martin Vaeth <vaeth@xxxxxxxxxxxxxxxxxxxxxxxxxxx>]

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

--- eix-0.29.6.ebuild
+++ eix-0.30.0.ebuild
@@ -14,7 +14,7 @@
 LICENSE="GPL-2"
 SLOT="0"
 KEYWORDS="~alpha ~amd64 ~arm ~hppa ~ia64 ~m68k ~mips ~ppc ~ppc64 ~s390 ~sh ~sparc ~x86 ~ppc-aix ~amd64-fbsd ~sparc-fbsd ~x86-fbsd ~x86-freebsd ~ia64-hpux ~x86-interix ~amd64-linux ~ia64-linux ~x86-linux ~ppc-macos ~x64-macos ~x86-macos ~sparc-solaris ~sparc64-solaris ~x86-solaris"
-IUSE="clang debug +dep doc nls optimization security strong-optimization strong-security sqlite swap-remote tools"
+IUSE="debug +dep doc nls optimization security strong-optimization strong-security sqlite swap-remote tools"
 
 BOTHDEPEND="sqlite? ( >=dev-db/sqlite-3 )
 	nls? ( virtual/libintl )"
@@ -22,7 +22,6 @@
 	app-shells/push"
 DEPEND="${BOTHDEPEND}
 	app-arch/xz-utils
-	clang? ( sys-devel/clang )
 	nls? ( sys-devel/gettext )"
 
 pkg_setup() {
@@ -46,7 +45,6 @@
 		$(use_enable swap-remote) \
 		$(use_with prefix always-accept-keywords) \
 		$(use_with dep dep-default) \
-		$(use_with clang nongnu-cxx clang++) \
 		--with-zsh-completion \
 		--with-ebuild-sh-default="/usr/$(get_libdir)/portage/bin/ebuild.sh" \
 		--with-portage-rootpath="${ROOTPATH}" \