Re: pdd19_pir.pod: See C<docs/imcc/macros.pod>

["Reini Urban" <rurban@x-ray.at>]

2008/8/28 Moritz Lenz <moritz@casella.verplant.org>:
>> +=head1 DESCRIPTION
>> +
>> +Parrot installation mechanisms are more powerful than perl5's.
>> +MANIFEST contains also the end location, tools/dev/install_files.pl is 
>> driven
>> +by this definition.
>
> To me it's not clear what the "end location" is - care to elaborate?

The end location by make install is a string concatation of

* the $(DESTDIR) as defined per Makefile argument,
* plus the respective Configure defined directoy (prefix,bin_dir, lib_dir,
  include_dir, mandir, doc_dir, ...)
  where the directores are defined by default to follow the FHS convention
  and optional Configure.pl arguments,
  and the files as defined in one of the three MANIFEST files in the format
    <filename> \t [<package>]lib,doc,include,bin
  - files from the [library] package go to prefix/lib_dir and either
dynext, library or include,
* plus the filename as defined by the three MANIFEST files.
There's additional logic in the tools/dev/install_files.pl script.

prefix defaults to "/usr/local" and packages define them as "/usr"
lib_dir defaults to prefix + "/lib"
  and libraries go to parrot/dynext for shared libs (flat)
                             parrot/library for pbc files (structured
according to the namespace)
                             parrot/include for pir and pasm files (flat)
bin_dir to prefix + "/bin"
doc_dir to  prefix + "/share/doc/parrot"
mandir to prefix + "/man", but it should be prefix + "/share/man"
according to the FHS
include_dir to prefix + "/include/parrot"
pkgconfig_dir to prefix + "/lib/pkgconfig"

What is missing is the end location of language pbc's and installable exe's.
The convention by fedora and cygwin for parrot-language installables is
  $(DESTDIR)@bin_dir@/parrot-$(LANG)@exe@

Open problem:
For language pbc's a new dir like script_dir or lib_dir/parrot/bin
would be required.
They could also pollute $(DESTDIR)@lib_dir@/parrot/library where the other
pbc's are.
The language group and op shared libs go to $(DESTDIR)@lib_dir@/parrot/dynext
for sure.
e.g. tclsh.pbc, APL.pbc, ...
-- 
Reini Urban
http://phpwiki.org/ http://murbreak.at/