=========================================
Debian source package for ‘jaraco.stream’
=========================================


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

The source for the Debian packaging is managed in the ‘main’ branch of the
Git repository.


Work on a release in VCS
------------------------

* Get the correct upstream source, using UScan::

      $ uscan --download-current-version

* In the ‘main’ branch, create a new Debian changelog entry.

  Because the release is not complete, many aspects have not been decided and
  should not be recorded in the VCS:

  * The target destination (in the header) is “UNRELEASED”.

  * The person and timestamp of the release is undecided, so should be empty:
    the signature line should have no content, just the “ --” leader.

* While working on the package, temporarily finalise the signature line for
  testing the build.

  This ephemeral state should not be part of the VCS history, though, so do not
  commit that finalised changelog entry; revert it to the above state to
  continue development.


Build the source package from VCS
---------------------------------

* Ensure the ‘main’ branch contains all the changes that are intended for the
  release to Debian.

* Until the work is ready for release, do not commit a finalised Debian
  changelog entry. The changelog entry should be in the state described in
  “Work on a release in VCS”, above.

  This correctly leaves the decision of which destination for the upload, who
  uploads and when, to the point in time where that decision is made: the time
  of finalising the release.

* Rebase a working branch, e.g. ‘wip/release/1.16.5+dfsg.1-2’, from the HEAD of
  ‘main’.

* In this branch, finalise the ‘debian/changelog’:

  * Declare a release name, e.g. “* The “Faisal Arefin Dipan” release.”

  * Set the target distribution, e.g. “unstable”.

  * Set the signature line containing the correct person and timestamp,
    e.g. “Ben Finney <bignose@debian.org>  Tue, 09 Aug 2016 06:05:28 +1000”.

  * Commit the finalised changelog with a commit message of the form
    “Finalise release “1.16.5+dfsg.1-2”.”

* Test the source package:

  * Export the source package::

        $ gbp buildpackage -S

  * Test the source package by building it in a SBuild or PBuilder
    environment, with all Lintian checks enabled.

* Only when the package builds satisfactorily from the source package:

  * Switch to the ‘main’ branch.

  * Pull the work-in-progress branch ‘wip/release/1.16.5+dfsg.1-2’ to ‘main’.

  * Create and sign a tag for the release, ‘release/1.16.5+dfsg.1-2’ with
    the commit message “Debian release “1.16.5+dfsg.1-2.”::

        $ git tag --sign \
            --message "Debian release “1.16.5+dfsg.1-2”." \
            "release/1.16.5+dfsg.1-2"

* Upload the successfully-built source package to Debian.

* Prepare the ‘main’ branch for ongoing work:

  * Delete the work-in-progress branch ‘wip/release/1.16.5+dfsg.1-2’.

  * Optionally: Create a new work-in-progress for an upcoming release,
    as described in “Work on a release in VCS”, above.


..
    Copyright © 2015–2024 Ben Finney <bignose@debian.org>
    This is free software: you may copy, modify, and/or distribute this work
    under the terms of the GNU General Public License as published by the
    Free Software Foundation; version 3 of that license or any later version.
    No warranty expressed or implied.

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

drwxr-xr-x root/root         0 2024-11-14 03:05 ./
drwxr-xr-x root/root         0 2024-11-14 03:05 ./usr/
drwxr-xr-x root/root         0 2024-11-14 03:05 ./usr/lib/
drwxr-xr-x root/root         0 2024-11-14 03:05 ./usr/lib/python3/
drwxr-xr-x root/root         0 2024-11-14 03:05 ./usr/lib/python3/dist-packages/
drwxr-xr-x root/root         0 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco/
drwxr-xr-x root/root         0 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco/stream/
-rw-r--r-- root/root       426 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco/stream/__init__.py
-rw-r--r-- root/root      3200 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco/stream/buffer.py
-rw-r--r-- root/root      1296 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco/stream/gzip.py
-rw-r--r-- root/root      2429 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco/stream/test_gzip.py
drwxr-xr-x root/root         0 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco.stream-0.0.0.dist-info/
-rw-r--r-- root/root         7 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco.stream-0.0.0.dist-info/INSTALLER
-rw-r--r-- root/root      2201 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco.stream-0.0.0.dist-info/METADATA
-rw-r--r-- root/root        91 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco.stream-0.0.0.dist-info/WHEEL
-rw-r--r-- root/root         7 2024-11-14 03:05 ./usr/lib/python3/dist-packages/jaraco.stream-0.0.0.dist-info/top_level.txt
drwxr-xr-x root/root         0 2024-11-14 03:05 ./usr/share/
drwxr-xr-x root/root         0 2024-11-14 03:05 ./usr/share/doc/
drwxr-xr-x root/root         0 2024-11-14 03:05 ./usr/share/doc/python3-jaraco.stream/
-rw-r--r-- root/root       169 2024-11-14 03:05 ./usr/share/doc/python3-jaraco.stream/changelog.Debian.gz
-rw-r--r-- root/root        90 2024-08-21 20:34 ./usr/share/doc/python3-jaraco.stream/changelog.gz
-rw-r--r-- root/root      2089 2024-11-14 03:05 ./usr/share/doc/python3-jaraco.stream/copyright

Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: jaraco.stream
Upstream-Contact: Jason R. Coombs <jaraco@jaraco.com>
Source: https://github.com/jaraco/jaraco.functools/

Files: *
Copyright:
    © 2016–2024 Jason R. Coombs <jaraco@jaraco.com>
License: Expat

Files: debian/*
Copyright:
    © 2010–2024 Ben Finney <bignose@debian.org>
License: GPL-3+
License-Grant:
    This is free software: you may copy, modify, and/or distribute this work
    under the terms of the GNU General Public License as published by the
    Free Software Foundation; version 3 of that license or any later version.
    No warranty expressed or implied.


License: Expat
    Permission is hereby granted, free of charge, to any person obtaining a
    copy of this software and associated documentation files (the "Software"),
    to deal in the Software without restriction, including without limitation
    the rights to use, copy, modify, merge, publish, distribute, sublicense,
    and/or sell copies of the Software, and to permit persons to whom the
    Software is furnished to do so, subject to the following conditions:
    .
    The above copyright notice and this permission notice shall be included in
    all copies or substantial portions of the Software.
    .
    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    DEALINGS IN THE SOFTWARE.

License: GPL-3+
    On Debian systems, the complete text of the GNU General Public License
    version 3 can be found in the file ‘/usr/share/common-licenses/GPL-3’.


# Local variables:
# coding: utf-8
# mode: debian-copyright
# fill-column: 78
# End:
# vim: fileencoding=utf-8 textwidth=78 :