[openssl/openssl] b684ee: build.info: Introduce special syntax for dependenc...

[Richard Levitte]

  Branch: refs/heads/master
  Home:   https://github.com/openssl/openssl
  Commit: b684ee2ce4bbf2c877d2cdc39e095d52ea3fe2a3
      https://github.com/openssl/openssl/commit/b684ee2ce4bbf2c877d2cdc39e095d52ea3fe2a3
  Author: Richard Levitte <levitte at openssl.org>
  Date:   2023-06-08 (Thu, 08 Jun 2023)

  Changed paths:
    M Configurations/descrip.mms.tmpl
    M Configurations/unix-Makefile.tmpl
    M Configurations/windows-makefile.tmpl
    M Configure
    M build.info
    M doc/internal/man7/build.info.pod

  Log Message:
  -----------
  build.info: Introduce special syntax for dependencies on script modules

The DEPEND statement, when applied on files generated with GENERATE, may
be used to specify script modules that the template to be generated from
depends on.  In short, this sort of depend:

    DEPEND[generated]=util/perl/OpenSSL/something.pm

... would generate a perl run that has the inclusion directory
'util/perl/OpenSSL' and 'something' as the module to be loaded.  However,
the package name for this module is 'OpenSSL::something', so to load it the
way it's expected, the inclusion directory should be 'util/perl', and the
module to be loaded should be specified as 'OpenSSL/something' (to be
massaged into a proper module name by the build file template).

To allow this, we introduce a file syntax, where a single '|' is used as a
directory separator, to delineate what part should be used as the inclustion
directory, and which part the module name to be loaded should be derived
from:

    DEPEND[generated]=util/perl|OpenSSL/something.pm

Fixes #21112

Reviewed-by: Matt Caswell <matt at openssl.org>
Reviewed-by: Paul Dale <pauli at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21117)