pod2man is no longer needed
[gd/samba-autobuild/.git] / pidl / wscript
index 4db7ca54d9b5290b9f24c122873f069056e5428a..d1b8278990a2d7f94941accb9dd8e46322d27fa7 100644 (file)
@@ -1,61 +1,67 @@
 #!/usr/bin/env python
 
-import os
+import os, string
+from samba_utils import MODE_755
+from waflib import Logs
 
-def set_options(opt):
-    opt.tool_options('perl')
+# This function checks if a perl module is installed on the system.
+def check_system_perl_module(conf, module, version=None):
+    bundle_name = module.replace('::', '_')
+    module_check = module
 
-def configure(conf):
-    conf.check_tool('perl')
-    # we need a recent version of MakeMaker to get the right man page names
-    if conf.CHECK_PERL_MANPAGE():
-        conf.env.PERLMAN1EXT = conf.CHECK_PERL_MANPAGE(section='1')
-        conf.env.PERLMAN3EXT = conf.CHECK_PERL_MANPAGE(section='3')
-        conf.DEFINE('HAVE_PERL_MAKEMAKER', 1)
+    # Create module string with version
+    if version:
+        module_check = module + ' ' + str(version)
 
-    # yapp is used for building the parser
-    conf.find_program('yapp', var='YAPP')
+    # Check if we have to bundle it.
+    if conf.LIB_MUST_BE_BUNDLED(bundle_name.lower()):
+        return False
 
+    # Check for system perl module
+    if conf.check_perl_module(module_check) is None:
+        return False
 
-def build(bld):
-    bld.INSTALL_FILES('${BINDIR}', 'pidl', chmod=0755)
+    conf.define('USING_SYSTEM_%s' % bundle_name.upper(), 1)
 
-    bld.BUILD_SUBDIR('lib')
+    return True
 
-    if not bld.CONFIG_SET('HAVE_PERL_MAKEMAKER'):
-        return
+def options(opt):
+    return
 
-    pidl_src = ['pidl']
-    pidl_src.extend(bld.path.ant_glob('lib/**/*.pm').split())
-
-    pidl_manpages = '''blib/man1/pidl.${PERLMAN1EXT} blib/man3/Parse::Pidl::NDR.${PERLMAN3EXT}
-                       blib/man3/Parse::Pidl::Wireshark::Conformance.${PERLMAN3EXT}
-                       blib/man3/Parse::Pidl::Dump.${PERLMAN3EXT}
-                       blib/man3/Parse::Pidl::Util.${PERLMAN3EXT}
-                       blib/man3/Parse::Pidl::Wireshark::NDR.${PERLMAN3EXT}'''.split()
-
-    pidl_manpages = bld.EXPAND_VARIABLES(pidl_manpages)
+def configure(conf):
+    # Check if perl(Parse::Yapp::Driver) is available.
+    check_system_perl_module(conf, "Parse::Yapp::Driver", 1.05)
 
-    # use perl to build the manpages
-    bld.env.pidl_srcdir = os.path.join(bld.srcnode.abspath(), 'pidl')
+    # yapp is used for building the parser
+    conf.find_program('yapp', var='YAPP')
 
-    bld.SAMBA_GENERATOR('pidl_manpages',
-                        source=pidl_src,
-                        target=pidl_manpages,
-                        rule='cd ${pidl_srcdir} && ${PERL} Makefile.PL && make manifypods && rm -f Makefile Makefile.old')
+def build(bld):
 
-    # we want to prefer the git version of the parsers if we can. Only if the
-    # source has changed do we want to re-run yapp
-    need_yapp_build = ('YAPP' in bld.env and (
+    # we want to prefer the git version of the parsers if we can.
+    # Only if the source has changed do we want to re-run yapp
+    # But we force the developer to use the pidl standalone build
+    # to regenerate the files.
+    # TODO: only warn in developer mode and if 'git diff HEAD'
+    #       shows a difference
+    warn_about_grammar_changes = ('PIDL_BUILD_WARNINGS' in bld.env and (
         bld.IS_NEWER('idl.yp', 'lib/Parse/Pidl/IDL.pm') or
         bld.IS_NEWER('expr.yp', 'lib/Parse/Pidl/Expr.pm')))
 
-    if need_yapp_build:
-        bld.SAMBA_GENERATOR('pidl_parser',
-                            source='idl.yp expr.yp',
-                            target='lib/Parse/Pidl/IDL.pm lib/Parse/Pidl/Expr.pm Makefile.PL',
-                            rule='cd ${pidl_srcdir} && ${PERL} Makefile.PL && make lib/Parse/Pidl/IDL.pm lib/Parse/Pidl/Expr.pm && rm -f Makefile Makefile.old')
+    if warn_about_grammar_changes:
+        Logs.warn('''
+Pidl grammar files have changed. Please use the pidl standalone build
+to regenerate them with yapp.
+
+$ cd ../pidl
+$ perl Makefile.PL
+$ make lib/Parse/Pidl/IDL.pm lib/Parse/Pidl/Expr.pm
+$ git add lib/Parse/Pidl/IDL.pm lib/Parse/Pidl/Expr.pm
+$ git commit
+$ cd -
+
+If your 100% sure you haven't changed idl.yp and expr.yp
+try this to avoid this message:
+
+$ touch ../pidl/lib/Parse/Pidl/IDL.pm ../pidl/lib/Parse/Pidl/Expr.pm
+''')
 
-    for m in pidl_manpages:
-        dname=os.path.dirname(m)[5:]
-        bld.INSTALL_FILES('${MANDIR}/'+dname, m, flat=True)