tools/HTMesh-0.01/README

0001 HTMesh version 0.01
0002 ===================
0003
0004 This Perl HTMesh wrapper was written by James Bowlin based on the
0005 original HTMesh C++ library (seemingly no longer maintained). After we
0006 stripped down the HTMesh library for use in KStars (see
0007 e.g. 0c344a2bf45594e9028f86d6c6a7d5e56b58bdfc -- one of the many
0008 commits stripping the library down), Akarsh Simha had to modify the
0009 perl wrapper to reflect these changes.
0010
0011 INSTALLATION
0012
0013 To install this module, first build the stripped-down HTMesh library
0014 with -fPIC flag (so it can be used in a shared object), otherwise the
0015 linker will barf because HTMesh perl library needs to be built as a
0016 shared object with symbols etc. To do so:
0017
0018    1. Open kstars/kstars/htmesh/CMakeLists.txt and remove the comment
0019       on the -fPIC flag.
0020
0021    2. make && make install in the kstars/kstars/htmesh directory
0022
0023    3. Copy the libhtmesh.a object from the install prefix into
0024       /usr/lib or wherever the Makefile below will look for it
0025       (alternatively, point the Makefile to it)
0026
0027    4. Revert the -fPIC uncommenting
0028
0029 Then, build the perl module:
0030
0031    perl Makefile.PL
0032    make
0033    make test
0034    make install # Or sudo make install depending on the prefix etc.
0035
0036 COPYRIGHT AND LICENCE
0037
0038 Copyright (C) 2015 James Bowlin <bowlin@mindspring.com>, Akarsh Simha <akarsh@kde.org>
0039
0040 This library is free software; you can redistribute it and/or modify
0041 it under the same terms as Perl itself, either Perl version 5.8.8 or,
0042 at your option, any later version of Perl 5 you may have available.