view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME
    Alien::Tidyp - Building, finding and using tidyp library -
    <http://www.tidyp.com>

VERSION
    Version 1.4.7 of Alien::Tidyp uses *tidyp* sources v1.04.

SYNOPSIS
    IMPORTANT: This module is not a perl binding for *tidyp* library; it is
    just a helper module. The real perl binding is implemented by e.g
    HTML::Tidy module, which is able to use Alien::Tidyp to locate *tidyp*
    library on your system (or build it from source codes).

    Alien::Tidyp tries (in given order) during its installation:

    *   Locate an already installed *tidyp* + ask user whether to use the
        already installed *tidyp* or whether to build *tidyp* from sources

    *   Via env variable TIDYP_DIR you can specify where the build script
        should look for the already installed *tidyp* (directories
        $TIDYP_DIR/lib and $TIDYP_DIR/include/tidyp are expected to exist)

    *   When not using the already installed *tidyp* build process continues
        with the following steps

    *   Download *tidyp* source code tarball

    *   Build *tidyp* binaries from source codes (note: static libraries are
        build in this case)

    *   Install binaries and dev files (*.h, *.a) into *share* directory of
        Alien::Tidyp distribution - *share* directory is usually something
        like this: /usr/lib/perl5/site_perl/5.10/auto/share/dist/Alien-Tidyp

    Later on you can use Alien::Tidyp in your module that needs to link with
    *tidyp* like this:

     # Sample Makefile.pl
     use ExtUtils::MakeMaker;
     use Alien::Tidyp;

     WriteMakefile(
       NAME         => 'Any::Tidyp::Module',
       VERSION_FROM => 'lib/Any/Tidyp/Module.pm',
       LIBS         => Alien::Tidyp->config('LIBS'),
       INC          => Alien::Tidyp->config('INC'),
       # + additional params
     );

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

Build.PL options
  --srctarball=<url_or_filename>
    This option might come handy if you are not connected to the Internet.
    You can use it like:

     Build.PL --srctarball=/path/to/file/tidyp-1.04.tar.gz

    or:

     Build.PL --srctarball=http://any.server.com/path/to/tidyp-1.04.tar.gz

    IMPORTANT: The file should always be exactly the same source code
    tarball as specified in the end of Build.PL - see source code (SHA1
    checksum of the tarball is checked).

METHODS