meshlab for Debian
------------------

Packaging contributors: `cme update dpkg-copyright` is a useful tool and helpful
for updating this project. However, its decisions should be considered
carefully: this project is large enough and with enough "legacy" source code in
it that there are several cases that confuse it, so simply accepting what it
says will be wrong.

This is repackaged: based on a release (or, if git is in the upstream version, a
commit hash after a release).

The script debian/get-orig-source.sh can (re-)generate an equivalent tarball. It
downloads meshlab and its submodule vcglib, combines them, then passes the new
tarball to mk-origtargz to exclude files per debian/copyright.

The script requires these packages to be installed: wget curl jq devscripts

After the script is run, it produces two sed commands you can run to update the
URLs in debian/copyright. You can also run
gbp import-orig ../meshlab_VERSION~dfsg1.orig.tar.xz to import the new upstream.

The following subdirectories or files have been excluded, for the following
reasons (note that the list in debian/copyright is the authoritative one used by
get-orig-source.sh - this is just for commentary on notable exclusions):

    .github
        CI scripts.

    distrib/lib/macx64
    distrib/lib/win32*
        Other platform binaries.

    install/linux/resources/appimagetool
    install/linux/resources/linuxdeployqt
        Binaries without the corresponding source.

    src/external/u3d/Docs/U3D.chm
        MS precompiled help file

    sample
        Textures with unknown copyright status.

    src/external/glew-2.1.0
    src/external/lib3ds-1.3.0
    src/external/muparser_v225
    src/external/OpenCTM-1.0.3
    src/external/OpenGR/3rdparty/cfitsio
    src/external/OpenGR/3rdparty/chealpix
    src/external/qhull-2003.1
    src/external/u3d/src/RTL/Dependencies/jpeg
    src/external/u3d/src/RTL/Dependencies/png
    src/external/u3d/src/RTL/Dependencies/zlib
    vcglib/eigenlib
        In Debian.

    src/external/u3d/src/RTL/Component/Scheduling/IFXSchedulingGuids.cpp.bak
        Mistakenly-included file upstream: breaks debian/rules clean.

    src/external/inc
        installed includes from binaries - not needed for Linux builds.

    src/plugins_experimental
    src/plugins_unsupported
        Not intended to be built per upstream.

    vcglib/apps
        Not built, and excluding simplifies copyright file substantially.

    vcglib/wrap/system/time
        Unknown license.

    vcglib/wrap/gcache/docs/js
    vcglib/wrap/gcache/docs/css
        Unused (dependency docs) and contains minified files from libjs-prettify.

 -- Ryan Pavlik <ryan@ryanpavlik.com>  Mon, 08 Jun 2020 11:36:34 -0500
