======================================================
Building the Debian source package for ‘lojban-common’
======================================================


Upstream provides no versioned files
====================================

The pristine upstream source is provided as separate files, with no version
for the collection.

The ‘debian/rules’ target “get-orig-source” (as specified in Debian Policy
§4.9) is provided to get the source files from upstream.


Files to install
----------------

Update the ‘debian/upstream.sha1sums’ file. This file is formatted as per
the input to the ‘sha1sum(1)’ program.

This file is used as input to:

* The ‘debian/get-orig-source’ program, to check the downloaded file
  contents: the SHA-1 hash values must match.

* ‘debian/rules’, to determine which files the package will install: every
  file to install must be listed.


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 “draft correlation between gismu and Roget categories”.

  Files: wordlists/roget.txt
  Copyright:
      © 1991, by the Logical Language Group, Inc.
  License: copy-only-for-promoting-lojban
      All rights reserved. Permission to copy granted subject to your
      verification that this is the latest version of this document,
      that your distribution be for the promotion of Lojban, that
      there is no charge for the product, and that this copyright
      notice is included intact in the copy.


Package maintenance in VCS
==========================

The ‘debian/control’ file declares the VCS repository used for
tracking the Debian package maintenance work.


VCS branches for package maintenance
------------------------------------

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/lojban-common/lojban-common_$DEBIANVER.dsc’ and its
associated files in that directory.


 -- Ben Finney <bignose@debian.org>, Fri, 12 Aug 2016 17:28:01 +1000


..
    Local variables:
    coding: utf-8
    mode: text
    mode: rst
    End:
    vim: fileencoding=utf-8 filetype=rst :
