NAME
    Build::Hopen - A build generator with first-class edges and explicit
    dependencies

SYNOPSIS
    Input is the last-sorting file in "." matching "*.hopen", unless you
    specify otherwise. That way you can call your build file ".hopen" if you
    want it hidden, or "z.hopen" if you want it to sort below all your other
    files. Sort order is Lua's "<", which is by byte value.

    Output is a build file for a build system (Ninja or Make will be first).
    You will eventually be able to pick a generator, a la CMake. The invoker
    will put the selected generator's path first in @INC, but other than
    that it's all straight Perl.

INSTALLATION
    Easiest: install "cpanminus" if you don't have it - see
    <https://metacpan.org/pod/App::cpanminus#INSTALLATION>. Then run "cpanm
    Build::Hopen".

    Manually: clone or untar into a working directory. Then, in that
    directory,

        perl Makefile.PL
        make
        make test

    ... and if all the tests pass,

        make install

    If some of the tests fail, please check the issues and file a new one if
    no one else has reported the problem yet.

SUPPORT
    You can find documentation for this module with the perldoc command.

        perldoc Build::Hopen
        perldoc hopen

    You can also look for information at:

    *   GitHub (report bugs here)

        <https://github.com/cxw42/hopen>

    *   MetaCPAN

        <https://metacpan.org/release/Build-Hopen>

    *   AnnoCPAN: Annotated CPAN documentation

        <http://annocpan.org/dist/Build-Hopen>

    *   CPAN Ratings

        <https://cpanratings.perl.org/d/Build-Hopen>

INSPIRED BY
    *   Luke <https://github.com/gvvaughan/luke>

    *   a bit of Ant <https://ant.apache.org/>

    *   a tiny bit of Buck
        <https://buckbuild.com/concept/what_makes_buck_so_fast.html>

    *   my own frustrations working with CMake.

LICENSE AND COPYRIGHT
    Copyright (C) 2018 Christopher White, "<cxwembedded at gmail.com>"

    This program is free software; you can redistribute it and/or modify it
    under the terms of the GNU Lesser General Public License as published by
    the Free Software Foundation; either version 2.1 of the License, or (at
    your option) any later version.

    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
    General Public License for more details.

    You should have received a copy of the GNU Lesser General Public License
    along with this program; if not, write to the Free Software Foundation,
    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

