debian_inform6-library/debian/README.source

===================================================
Debian source package for Inform 6 standard library
===================================================

Build source package from VCS
=============================

The source for the Debian packaging is managed in these conventional
Git branches:

* master: The current released code base.
* packaging: Debian packaging development branch.
* upstream: Upstream source code base, as imported from tarballs.
* pristine-tar: Metadata for reproducibly generating upstream tarball.

To build the source package from the Git VCS, use the Debian ‘gitpkg’
tool to generate all the files::

    $ git checkout master
    $ gitpkg packaging upstream

The ‘dpkg-source’ process will complain about the “deletion” of
upstream source. This is because the upstream source is not present at
all in the ‘packaging’ branch exported, but in the ‘upstream’ branch.
The upstream source is safely exported earlier in its own tarball.

The generated source package is the source control file
‘../deb-packages/inform6-library/inform6-library_$DEBIANVER.dsc’ and
its associated files in that directory.


Omitted components
==================

Components that have been omitted from Debian because they lack a
clear written grant, from the copyright holders, of free-software
license terms in their work:

* The convenience API for Glk:

  Files: infglk.h
  Copyright:
      © 2009–2016 Andrew Plotkin <erkyrath@eblong.com>
  License: all-rights-granted
  License-Grant:
      Written by Andrew Plotkin. This tool is in the public domain.
  Comment:
      This is not the source form of the work, and its corresponding
      source and build tools are not available under free-software
      terms for inclusion in Debian.
      .
      The only tool to build this (‘dispatch_dump’ from the ‘glk-dev’
      code base) itself requires the non-free ‘cheapglk’ library, so
      cannot be in Debian.


 -- Ben Finney <ben+debian@benfinney.id.au>, Sat, 16 Apr 2016 15:45:50 +1000