view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME
    Alien::IUP - Building, finding and using iup + related libraries -
    <http://www.tecgraf.puc-rio.br/iup/>

VERSION
    *   *iup* library 3.19.1 - see <http://www.tecgraf.puc-rio.br/iup/>

    *   *im* library 3.11 - see <http://www.tecgraf.puc-rio.br/im/>

    *   *cd* library 5.10 - see <http://www.tecgraf.puc-rio.br/cd/>

SYNOPSIS
    IMPORTANT: This module is not a perl binding for *iup + related*
    libraries; it is just a helper module. The real perl binding is
    implemented by IUP module, which is using Alien::IUP to locate *iup +
    related* libraries on your system (or build it from source codes).

    Alien::IUP installation comprise of:

    *   Downloading *iup* & co. source code tarballs

    *   Building *iup* & co. binaries from source codes (note: static
        libraries are build)

    *   Installing libs and dev files (*.h, *.a) into *share* directory of
        Alien::IUP distribution - *share* directory is usually something
        like this: /usr/lib/perl5/site_perl/5.18/auto/share/dist/Alien-IUP

    Later on you can use Alien::IUP in your module that needs to link with
    *iup* and/or related libs like this:

     # Sample Makefile.pl
     use ExtUtils::MakeMaker;
     use Alien::IUP;
 
     WriteMakefile(
       NAME         => 'Any::IUP::Module',
       VERSION_FROM => 'lib/Any/IUP/Module.pm',
       LIBS         => Alien::IUP->config('LIBS'),
       INC          => Alien::IUP->config('INC'),
       # + additional params
     );

    IMPORTANT: As Alien::IUP builds static libraries the modules using
    Alien::IUP (e.g. IUP) need to have Alien::IUP just for building, not for
    later use. In other words Alien:IUP is just "build dependency" not
    "run-time dependency".

METHODS
  config()
    This function is the main public interface to this module.

     Alien::IUP->config('LIBS');

    Returns a string like: '-L/path/to/iupdir/lib -liup -lim -lcd'

     Alien::IUP->config('INC');

    Returns a string like: '-I/path/to/iupdir/include'

     Alien::IUP->config('PREFIX');

    Returns a string like: '/path/to/iupdir' (note: if using the already
    installed *iup* config('PREFIX') returns undef)

  havelib()
    Checks the presence of given iup related libraries.

     Alien::IUP->havelib('iupim');
     #or