README.source 2.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
  1. ===================================================
  2. Debian source package for Inform 6 standard library
  3. ===================================================
  4. Build source package from VCS
  5. =============================
  6. The source for the Debian packaging is managed in these conventional
  7. Git branches:
  8. * master: The current released code base.
  9. * packaging: Debian packaging development branch.
  10. * upstream: Upstream source code base, as imported from tarballs.
  11. * pristine-tar: Metadata for reproducibly generating upstream tarball.
  12. To build the source package from the Git VCS, use the Debian ‘gitpkg’
  13. tool to generate all the files::
  14. $ git checkout master
  15. $ gitpkg packaging upstream
  16. The ‘dpkg-source’ process will complain about the “deletion” of
  17. upstream source. This is because the upstream source is not present at
  18. all in the ‘packaging’ branch exported, but in the ‘upstream’ branch.
  19. The upstream source is safely exported earlier in its own tarball.
  20. The generated source package is the source control file
  21. ‘../deb-packages/inform6-library/inform6-library_$DEBIANVER.dsc’ and
  22. its associated files in that directory.
  23. Omitted components
  24. ==================
  25. Components that have been omitted from Debian because they lack a
  26. clear written grant, from the copyright holders, of free-software
  27. license terms in their work:
  28. * The convenience API for Glk:
  29. Files: infglk.h
  30. Copyright:
  31. © 2009–2016 Andrew Plotkin <erkyrath@eblong.com>
  32. License: all-rights-granted
  33. License-Grant:
  34. Written by Andrew Plotkin. This tool is in the public domain.
  35. Comment:
  36. This is not the source form of the work, and its corresponding
  37. source and build tools are not available under free-software
  38. terms for inclusion in Debian.
  39. .
  40. The only tool to build this (‘dispatch_dump’ from the ‘glk-dev’
  41. code base) itself requires the non-free ‘cheapglk’ library, so
  42. cannot be in Debian.
  43. -- Ben Finney <ben+debian@benfinney.id.au>, Sat, 16 Apr 2016 15:45:50 +1000