https://github.com/ptomulik/pkg-yaul
Packaging yaul libraries
https://github.com/ptomulik/pkg-yaul
Last synced: 3 months ago
JSON representation
Packaging yaul libraries
- Host: GitHub
- URL: https://github.com/ptomulik/pkg-yaul
- Owner: ptomulik
- Created: 2015-06-07T00:38:20.000Z (about 10 years ago)
- Default Branch: default
- Last Pushed: 2015-06-08T00:18:02.000Z (about 10 years ago)
- Last Synced: 2025-01-18T02:28:44.393Z (5 months ago)
- Language: Makefile
- Size: 3.65 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
Awesome Lists containing this project
README
pkg-yaul
========
This projects maintains the packaging and releasing process of yaul_ library.
- for debian packages we use git-buildpackage_,
Branches
--------
The repository contains several separate branches for different purposes
+---------------------------------+-----------------------------------------------------------------------------------------------------------+
| Branch | Purpose |
+=================================+===========================================================================================================+
| *default* | default branch with common scripts, instructions and files, not used for actual packaging |
+---------------------------------+-----------------------------------------------------------------------------------------------------------+
| *debian-debian/* | the Debian packaging for a (e.g., jessie, wheezy, sid or experimental) |
+---------------------------------+-----------------------------------------------------------------------------------------------------------+
| *debian-upstream/* | the upstream sources for a release matching one of the above |
+---------------------------------+-----------------------------------------------------------------------------------------------------------+
| *debian-security/* | security updates for a certain release |
+---------------------------------+-----------------------------------------------------------------------------------------------------------+
| *debian-backports/* | backports to a certain release |
+---------------------------------+-----------------------------------------------------------------------------------------------------------+
| *debian-dfsg/* | the dfsg clean upstream sources in case the cleanup is done via a Git merge from upstream to this branch. |
+---------------------------------+-----------------------------------------------------------------------------------------------------------+
Tasks
-----
General: Creating soruce tarball
````````````````````````````````
- Create tarball out of upstream's ``yaul-0.1.1`` tag::
git checkout default
./scripts/create-tarball yaul-0.1.1
- Create source tarball from most recent upstream commit::
git checkout default
./scripts/create-tarball master
The script requires an access to temporary directory (usually ``/tmp``, see
``mktemp(1)``) where it clones the upstream repository and manipulates files.
Debian: Creating soruce tarball
```````````````````````````````
- Create normal source tarball and rename it appropriatelly::
git checkout default
./scripts/create-tarball yaul-0.1.1
mv ../yaul-0.1.1.tar.gz ../yaul0.1_0.1.1.orig.tar.gz
Debian: Enable support for new Debian release
`````````````````````````````````````````````
In the following replace ``stretch`` with your preferred release codename.
- Prepare initial ``debian`` directory::
git checkout default
./scripts/create-debian-release stretch 0.1.1
this shall create ``debian.stretch`` with the initial contents of ``debian``
directory for stretch release.
- create branch for debian upstream::
git checkout --orphan debian-upstream/stretch
git rm -rf --cached .
git commit --allow-empty -m 'initial commit for debian-upstream/stretch'
- create branch for debian packaging::
git checkout -b debian-debian/stretch
git commit --allow-empty -m 'initial commit for debian-debian/stretch'
- put initial files to branches::
git checkout debian-upstream/stretch
rm -rf .gitignore
mv gitignore.debian-upstream .gitignore
git add .gitignore
git commit -m 'added .gitignore'
git checkout debian-debian/stretch
rm -rf .gitignore debian
mv gitignore.debian-packaging .gitignore
mv debian.stretch debian
git add .gitignore debian
git commit -m 'added .gitignore and debian/'
- prepare a source tarball::
git checkout default
./scripts/create-tarball yaul-0.1.1
mv ../yaul-0.1.1.tar.gz ../yaul0.1_0.1.1.orig.tar.gz
- import the source tarball::
git checkout debian-debian/stretch
gbp import-orig ../yaul0.1_0.1.1.orig.tar.gz
- build the package::
gbp buildpackage
Debian: Build package
`````````````````````
.. code::
git checkout debian-debian/stretch
debian/rules clean
gbp buildpackage
Debian: New release of package
``````````````````````````````
.. code::
git checkout debian-debian/stretch
gbp --release --auto
.. _yaul: https://github.com/ptomulik/yaul
.. _git-buildpackage: https://honk.sigxcpu.org/piki/projects/git-buildpackage/
.. _gbp-manual: http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/gbp.html
..