Re: modify functions hierarchy (was: Install run-help and *.zwc files system wide in build system)

[Peter Stephenson <p.w.stephenson@ntlworld.com>]

On Sun, 17 Nov 2013 10:30:47 -0800
Bart Schaefer <schaefer@brasslantern.com> wrote:
> On Nov 16, 12:14pm, Martin Vaeth wrote:
> }
> } This patch implements a mechanism which supports "source/" subdirs
> } in the function hierarchy:
> 
> I'd rather these were not inside the tree like that.  There should be an
> entirely separate location for them.
> 
> In fact, in thinking about it, furter, I believe we should maintain the
> Completion/ and Functions/ trees as conceptually read-only at "make all"
> time.   Any files like _run_help and run-help that need to be generated
> from a .in file should be processed by "make install" (install.fns rule)
> directly into the $(sitefndir) target, and should never appear in the
> Zsh build tree.

I can see the potential confusion in having files that need processing
in the same tree as files that get installed verbatim, although I didn't
see it as necessarily a problem in practice, but the files should be
generated at make time, not install time, otherwise it's inconsistent
with the rest of the build system.  Up to now, installation has been a
straight copy and I don't see any point in changing that: it adds an
extra point of failure (other than those applicable to copying,
e.g. permissions), for one thing.  I'm not even sure the config.status
processing applicable to substitutions for .in files, which is what we
want here (and I don't see any point in inventing a new form of
processing), is designed to go straight to install directories.
 
> Taking that as step further, I'm beginning to think the helpfiles should
> also be generated by "make install" rather than being written to a tree
> underneath Doc/.

Again, this is inconsistent with other files that get installed,
and also (which is really part of the same thing) means we can't supply
them in the doc bundle with the other pre-generated documentation.

In both cases, where they get written is another matter.

We could have a parallel hierarchy Functions_pre for generated functions.

The doc bundle isn't supposed to be standalone, it's supposed to give
you additional files to install using the files from the normal build,
so I don't think that's a limitation.  So I'm not that fussed where the
generated helpfiles go in the first instance.

-- 
Peter Stephenson <p.w.stephenson@ntlworld.com>
Web page now at http://homepage.ntlworld.com/p.w.stephenson/