debmake-4.1.7/0000775000175000017500000000000012416770056013417 5ustar osamuosamu00000000000000debmake-4.1.7/MANIFEST.in0000664000175000017500000000010512416763277015160 0ustar osamuosamu00000000000000include MANIFEST.in include MANIFEST include manpages/* include TODO debmake-4.1.7/MANIFEST0000664000175000017500000000530012416770056014546 0ustar osamuosamu00000000000000# file GENERATED by distutils, do NOT edit MANIFEST MANIFEST.in README TODO setup.py debmake/__init__.py debmake/analyze.py debmake/cat.py debmake/compat.py debmake/control.py debmake/copyright.py debmake/debian.py debmake/debs.py debmake/debug.py debmake/dist.py debmake/grep.py debmake/kludge.py debmake/lc.py debmake/origtar.py debmake/para.py debmake/read.py debmake/sanity.py debmake/scanfiles.py debmake/sed.py debmake/tar.py debmake/untar.py debmake/yn.py desc/META.yml.short desc/Rakefile.short desc/python.long desc/python.short desc/python3.long desc/python3.short desc/specin.long desc/specin.short doc/debmake.html doc/examples.tar.xz doc/maint-guide.html extra0/changelog extra0/rules extra0desc_long/_long extra0desc_long/bin extra0desc_long/data extra0desc_long/dbg extra0desc_long/dev extra0desc_long/doc extra0desc_long/lib extra0desc_long/perl extra0desc_long/python extra0desc_long/python3 extra0desc_long/ruby extra0desc_long/script extra0export/compiler extra0export/java extra0export/vala extra0override/autogen extra0override/autoreconf extra0override/dbg extra0override/java extra0override/judge extra0override/multiarch extra0override/pythons extra1/README.Debian extra1/compat extra1/watch extra1patches/series extra1source/format extra1source/local-options extra2bin/package.install extra2data/package.install extra2dev/package.install extra2doc/package.doc-base extra2doc/package.docs extra2doc/package.examples extra2doc/package.info extra2doc/package.install extra2doc/package.manpages extra2lib/package.install extra2lib/package.symbols extra2multi/clean extra2multi/package.links extra2multi/package.menu extra2multi/package.postinst extra2multi/package.postrm extra2multi/package.preinst extra2multi/package.prerm extra2single/clean extra2single/install extra2single/links extra2single/menu extra2single/postinst extra2single/postrm extra2single/preinst extra2single/prerm extra3/manpage.1.ex extra3/manpage.asciidoc.ex extra3/manpage.sgml.ex extra3/manpage.xml.ex extra3/package.bug-control.ex extra3/package.bug-presubj.ex extra3/package.bug-script.ex extra3/package.conffiles.ex extra3/package.cron.d.ex extra3/package.cron.daily.ex extra3/package.cron.hourly.ex extra3/package.cron.monthly.ex extra3/package.cron.weekly.ex extra3/package.default.ex extra3/package.dirs.ex extra3/package.emacsen-install.ex extra3/package.emacsen-remove.ex extra3/package.emacsen-startup.ex extra3/package.init.ex extra3/package.lintian-overrides.ex extra3/package.service.ex extra3/package.tmpfile.ex extra3/package.upstrat.ex extra3/source.lintian-overrides.ex extra4/Apache-2.0 extra4/Artistic-1.0 extra4/BSD-3-Clause extra4/GPL-2.0+ extra4/GPL-3.0+ extra4/LGPL-2.1+ extra4/LGPL-3.0+ extra4/MIT manpages/debmake.1 scripts/debmake debmake-4.1.7/extra2bin/0000775000175000017500000000000012416770056015315 5ustar osamuosamu00000000000000debmake-4.1.7/extra2bin/package.install0000664000175000017500000000016612416763277020312 0ustar osamuosamu00000000000000### Candidates as below and see dh_install(1). ###bin ###etc ###sbin ###usr/bin ###usr/sbin ###usr/share/@BINPACKAGE@ debmake-4.1.7/extra0/0000775000175000017500000000000012416770056014622 5ustar osamuosamu00000000000000debmake-4.1.7/extra0/changelog0000664000175000017500000000023412416766073016477 0ustar osamuosamu00000000000000@PACKAGE@ (@VERREV@) UNRELEASED; urgency=low * Initial release. Closes: #nnnn -- @FULLNAME@ <@EMAIL@> @DATE@ debmake-4.1.7/extra0/rules0000664000175000017500000000144212416766073015704 0ustar osamuosamu00000000000000#!/usr/bin/make -f ### See debhelper(7) (uncomment to enable) ### This is a autogenerated template for debian/rules. ### You must remove unused comment lines for the released package. ### ### Output every command that modifies files on the build system. #DH_VERBOSE = 1 ### ### Define DEB_HOST_* and DEB_BUILD_* variables using ### dpkg-architecture(1) if they are used in this file. E.g.: ###DEB_HOST_MULTIARCH = $(shell dpkg-architecture -qDEB_HOST_MULTIARCH) ###DEB_HOST_ARCH_OS = $(shell dpkg-architecture -qDEB_HOST_ARCH_OS) ### ### Copy some variable definitions from pkg-info.mk and vendor.mk ### under /usr/share/dpkg/ to here if they are useful. ### @EXPORT@### main packaging script based on dh7 syntax %: dh $@ @DHWITH@ @DHBUILDSYSTEM@ ### debmake generated override targets @OVERRIDE@ debmake-4.1.7/extra4/0000775000175000017500000000000012416770056014626 5ustar osamuosamu00000000000000debmake-4.1.7/extra4/Apache-2.00000664000175000017500000000157712416763277016250 0ustar osamuosamu00000000000000Files: * Copyright: License: Apache-2.0 Files: debian/* Copyright: @YEAR@ @FULLNAME@ <@EMAIL@> License: Apache-2.0 License: Apache-2.0 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at . http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. . On Debian systems, the complete text of the Apache version 2.0 license can be found in "/usr/share/common-licenses/Apache-2.0". debmake-4.1.7/extra4/MIT0000664000175000017500000000234412416763277015214 0ustar osamuosamu00000000000000Files: * Copyright: License: MIT Files: debian/* Copyright: @YEAR@ @FULLNAME@ <@EMAIL@> License: MIT License: MIT 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. debmake-4.1.7/extra4/LGPL-2.1+0000664000175000017500000000175312416763277015675 0ustar osamuosamu00000000000000Files: * Copyright: License: LGPL-2.1+ Files: debian/* Copyright: @YEAR@ @FULLNAME@ <@EMAIL@> License: LGPL-2.1+ License: LGPL-2.1+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. . You should have received a copy of the GNU General Public License along with this program. If not, see . . On Debian systems, the complete text of the GNU Lesser General Public License can be found in "/usr/share/common-licenses/LGPL-2.1". debmake-4.1.7/extra4/GPL-3.0+0000664000175000017500000000173212416763277015556 0ustar osamuosamu00000000000000Files: * Copyright: License: GPL-3.0+ Files: debian/* Copyright: @YEAR@ @FULLNAME@ <@EMAIL@> License: GPL-3.0+ License: GPL-3.0+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this program. If not, see . . On Debian systems, the complete text of the GNU General Public License version 3 can be found in "/usr/share/common-licenses/GPL-3". debmake-4.1.7/extra4/GPL-2.0+0000664000175000017500000000173112416763277015554 0ustar osamuosamu00000000000000Files: * Copyright: License: GPL-2.0+ Files: debian/* Copyright: @YEAR@ @FULLNAME@ <@EMAIL@> License: GPL-2.0+ License: GPL-2.0+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this program. If not, see . On Debian systems, the complete text of the GNU General Public License version 2 can be found in "/usr/share/common-licenses/GPL-2". debmake-4.1.7/extra4/LGPL-3.0+0000664000175000017500000000175112416763277015673 0ustar osamuosamu00000000000000Files: * Copyright: License: LGPL-3.0+ Files: debian/* Copyright: @YEAR@ @FULLNAME@ <@EMAIL@> License: LGPL-3.0+ License: LGPL-3.0+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. . You should have received a copy of the GNU General Public License along with this program. If not, see . . On Debian systems, the complete text of the GNU Lesser General Public License can be found in "/usr/share/common-licenses/LGPL-3". debmake-4.1.7/extra4/Artistic-1.00000664000175000017500000000126212416763277016637 0ustar osamuosamu00000000000000Files: * Copyright: License: Artistic Files: debian/* Copyright: @YEAR@ @FULLNAME@ <@EMAIL@> License: Artistic-1.0 License: Artistic-1.0 This program is free software; you can redistribute it and/or modify it under the terms of the "Artistic License" which comes with Debian. . THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. . On Debian systems, the complete text of the Artistic License can be found in "/usr/share/common-licenses/Artistic". debmake-4.1.7/extra4/BSD-3-Clause0000664000175000017500000000323712416763277016547 0ustar osamuosamu00000000000000Files: * Copyright: License: BSD-3-Clause Files: debian/* Copyright: @YEAR@ @FULLNAME@ <@EMAIL@> License: BSD-3-Clause License: BSD-3-Clause Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. . THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. debmake-4.1.7/desc/0000775000175000017500000000000012416770056014335 5ustar osamuosamu00000000000000debmake-4.1.7/desc/python3.long0000775000175000017500000000005612416763277016635 0ustar osamuosamu00000000000000#!/bin/sh python3 setup.py --long-description debmake-4.1.7/desc/META.yml.short0000775000175000017500000000017112416763277016755 0ustar osamuosamu00000000000000#!/bin/sh # perl sed -n -e '/^abstract:/s/abstract: *//p' META.yml | sed -e "s/^'//" -e "s/'$//" -e 's/^"//' -e 's/"$//' debmake-4.1.7/desc/specin.long0000775000175000017500000000011712416763277016510 0ustar osamuosamu00000000000000#!/bin/sh # spec file sed -e '1,/^%description/d' *.spec.in | sed -e '/^%/,$d' debmake-4.1.7/desc/python.short0000775000175000017500000000005012416763277016744 0ustar osamuosamu00000000000000#!/bin/sh python setup.py --description debmake-4.1.7/desc/python3.short0000775000175000017500000000005112416763277017030 0ustar osamuosamu00000000000000#!/bin/sh python3 setup.py --description debmake-4.1.7/desc/python.long0000775000175000017500000000005512416763277016551 0ustar osamuosamu00000000000000#!/bin/sh python setup.py --long-description debmake-4.1.7/desc/specin.short0000775000175000017500000000010712416763277016707 0ustar osamuosamu00000000000000#!/bin/sh # spec file sed -n -e '/^Summary:/p/Summary: *//p' *.spec.in debmake-4.1.7/desc/Rakefile.short0000775000175000017500000000020212416763277017144 0ustar osamuosamu00000000000000#!/bin/sh # ruby sed -n -e '/gem.summary *=/s/gem.summary *= *//p' Rakefile | sed -e "s/^'//" -e "s/'$//" -e 's/^"//' -e 's/"$//' debmake-4.1.7/extra1source/0000775000175000017500000000000012416770056016044 5ustar osamuosamu00000000000000debmake-4.1.7/extra1source/format0000664000175000017500000000001512416763277017262 0ustar osamuosamu00000000000000@PKGFORMAT@ debmake-4.1.7/extra1source/local-options0000664000175000017500000000014412416763277020560 0ustar osamuosamu00000000000000### Uncomment to active options. See dpkg-source(1) ###abort-on-upstream-changes ###unapply-patches debmake-4.1.7/extra2dev/0000775000175000017500000000000012416770056015323 5ustar osamuosamu00000000000000debmake-4.1.7/extra2dev/package.install0000664000175000017500000000015412416763277020315 0ustar osamuosamu00000000000000### Candidates as below and see dh_install(1). ###usr/include ###usr/lib/*/*.so ###usr/lib/*/pkgconfig/*.pc debmake-4.1.7/extra2single/0000775000175000017500000000000012416770056016026 5ustar osamuosamu00000000000000debmake-4.1.7/extra2single/links0000664000175000017500000000002312416763277017073 0ustar osamuosamu00000000000000### See dh_link(1) debmake-4.1.7/extra2single/menu0000664000175000017500000000063012416763277016723 0ustar osamuosamu00000000000000### Menu template (edit and rename to debian/menu to activate) ### See dh_installmenu(1) ### /usr/share/doc/menu/html/* ### http://www.debian.org/doc/manuals/maint-guide/dother.en.html#menu ### ###?package(@PACKAGE@):needs="X11|text|vc|wm" \ ### section="Applications/see-menu-manual"\ ### title="@PACKAGE@" \ ### command="/usr/bin/@PACKAGE@" debmake-4.1.7/extra2single/clean0000664000175000017500000000002412416763277017036 0ustar osamuosamu00000000000000### See dh_clean(1) debmake-4.1.7/extra2single/preinst0000664000175000017500000000136712416763277017453 0ustar osamuosamu00000000000000#!/bin/sh set -e ### see: dh_installdeb(1) ### http://www.debian.org/doc/manuals/maint-guide/dother.en.html#maintscripts ### summary of how this script can be called: ### * `install' ### * `install' ### * `upgrade' ### * `abort-upgrade' ### for details, see http://www.debian.org/doc/debian-policy/ or ### the debian-policy package case "$1" in install|upgrade) ;; abort-upgrade) ;; *) echo "preinst called with unknown argument \`$1'" >&2 exit 1 ;; esac ### dh_installdeb will replace this with shell code automatically ### generated by other debhelper scripts. #DEBHELPER# exit 0 debmake-4.1.7/extra2single/prerm0000664000175000017500000000167212416763277017113 0ustar osamuosamu00000000000000#!/bin/sh set -e ### see: dh_installdeb(1) ### http://www.debian.org/doc/manuals/maint-guide/dother.en.html#maintscripts ### summary of how this script can be called: ### * `remove' ### * `upgrade' ### * `failed-upgrade' ### * `remove' `in-favour' ### * `deconfigure' `in-favour' ### `removing' ### ### for details, see http://www.debian.org/doc/debian-policy/ or ### the debian-policy package case "$1" in remove|upgrade|deconfigure) ;; failed-upgrade) ;; *) echo "prerm called with unknown argument \`$1'" >&2 exit 1 ;; esac ### dh_installdeb will replace this with shell code automatically ### generated by other debhelper scripts. #DEBHELPER# exit 0 debmake-4.1.7/extra2single/postrm0000664000175000017500000000176212416763277017312 0ustar osamuosamu00000000000000#!/bin/sh set -e ### see: dh_installdeb(1) ### http://www.debian.org/doc/manuals/maint-guide/dother.en.html#maintscripts ### summary of how this script can be called: ### * `remove' ### * `purge' ### * `upgrade' ### * `failed-upgrade' ### * `abort-install' ### * `abort-install' ### * `abort-upgrade' ### * `disappear' ### ### for details, see http://www.debian.org/doc/debian-policy/ or ### the debian-policy package case "$1" in purge|remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear) ;; *) echo "postrm called with unknown argument \`$1'" >&2 exit 1 ;; esac ### dh_installdeb will replace this with shell code automatically ### generated by other debhelper scripts. #DEBHELPER# exit 0 debmake-4.1.7/extra2single/install0000664000175000017500000000002612416763277017424 0ustar osamuosamu00000000000000### See dh_install(1) debmake-4.1.7/extra2single/postinst0000664000175000017500000000201112416763277017635 0ustar osamuosamu00000000000000#!/bin/sh set -e ### see: dh_installdeb(1) ### http://www.debian.org/doc/manuals/maint-guide/dother.en.html#maintscripts ### summary of how this script can be called: ### * `configure' ### * `abort-upgrade' ### * `abort-remove' `in-favour' ### ### * `abort-remove' ### * `abort-deconfigure' `in-favour' ### `removing' ### ### for details, see http://www.debian.org/doc/debian-policy/ or ### the debian-policy package case "$1" in configure) ;; abort-upgrade|abort-remove|abort-deconfigure) ;; *) echo "postinst called with unknown argument \`$1'" >&2 exit 1 ;; esac ### dh_installdeb will replace this with shell code automatically ### generated by other debhelper scripts. #DEBHELPER# exit 0 debmake-4.1.7/PKG-INFO0000664000175000017500000000120512416770056014512 0ustar osamuosamu00000000000000Metadata-Version: 1.1 Name: debmake Version: 4.1.7 Summary: Debian package making utility Home-page: http://people.debian.org/~osamu/ Author: Osamu Aoki Author-email: osamu@debian.org License: MIT License Description: Debian source package making utility to populate the debian directory. Platform: POSIX Classifier: Development Status :: 3 - Alpha Classifier: Environment :: Console Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Natural Language :: English Classifier: Operating System :: POSIX :: Linux Classifier: Programming Language :: Python :: 3 Classifier: Topic :: Utilities debmake-4.1.7/extra0desc_long/0000775000175000017500000000000012416770056016500 5ustar osamuosamu00000000000000debmake-4.1.7/extra0desc_long/perl0000664000175000017500000000005112416763277017370 0ustar osamuosamu00000000000000 This package contains the perl program. debmake-4.1.7/extra0desc_long/python30000664000175000017500000000005412416763277020035 0ustar osamuosamu00000000000000 This package contains the python3 program. debmake-4.1.7/extra0desc_long/python0000664000175000017500000000005312416763277017751 0ustar osamuosamu00000000000000 This package contains the python program. debmake-4.1.7/extra0desc_long/dev0000664000175000017500000000005612416763277017211 0ustar osamuosamu00000000000000 This package contains the development files. debmake-4.1.7/extra0desc_long/bin0000664000175000017500000000006712416763277017205 0ustar osamuosamu00000000000000 This package contains the compiled binary executable. debmake-4.1.7/extra0desc_long/lib0000664000175000017500000000005312416763277017176 0ustar osamuosamu00000000000000 This package contains the shared library. debmake-4.1.7/extra0desc_long/doc0000664000175000017500000000006012416763277017173 0ustar osamuosamu00000000000000 This package contains the documentation files. debmake-4.1.7/extra0desc_long/script0000664000175000017500000000005312416763277017734 0ustar osamuosamu00000000000000 This package contains the script program. debmake-4.1.7/extra0desc_long/ruby0000664000175000017500000000005112416763277017407 0ustar osamuosamu00000000000000 This package contains the ruby program. debmake-4.1.7/extra0desc_long/data0000664000175000017500000000007212416763277017342 0ustar osamuosamu00000000000000 This package contains the architecture independent data. debmake-4.1.7/extra0desc_long/dbg0000664000175000017500000000005612416763277017167 0ustar osamuosamu00000000000000 This package contains the debugging symbols. debmake-4.1.7/extra0desc_long/_long0000664000175000017500000000220112416763277017523 0ustar osamuosamu00000000000000 This Debian binary package was auto-generated by the debmake(1) command provided by the debmake package. . ===== This comes from the unmodified template file ===== . Please edit this template file (debian/control) and other package files (debian/*) to make them meet all the requirements of the Debian Policy before uploading this package to the Debian archive. . See * http://www.debian.org/doc/manuals/maint-guide/dreq.en.html#control * http://www.debian.org/doc/manuals/developers-reference/best-pkging-practices.html#bpp-debian-control . The synopsis description at the top should be about 60 characters and written as a phrase. No extra capital letters or a final period. No articles — "a", "an", or "the". . The package description for general-purpose applications should be written for a less technical user. This means that we should avoid jargon. GNOME or KDE is fine but GTK+ is probably not. . Use the canonical forms of words: * Use X Window System, X11, or X; not X Windows, X-Windows, or X Window. * Use GTK+, not GTK or gtk. * Use GNOME, not Gnome. * Use PostScript, not Postscript or postscript. debmake-4.1.7/extra2doc/0000775000175000017500000000000012416770056015312 5ustar osamuosamu00000000000000debmake-4.1.7/extra2doc/package.doc-base0000664000175000017500000000003212416763277020306 0ustar osamuosamu00000000000000### See dh_installdocs(1) debmake-4.1.7/extra2doc/package.install0000664000175000017500000000011112416763277020275 0ustar osamuosamu00000000000000### Candidates as below and see dh_install(1). ###usr/share/@BINPACKAGE@ debmake-4.1.7/extra2doc/package.docs0000664000175000017500000000003312416763277017562 0ustar osamuosamu00000000000000### See dh_installdocs(1) debmake-4.1.7/extra2doc/package.manpages0000664000175000017500000000003712416763277020431 0ustar osamuosamu00000000000000### See dh_installmanpages(1) debmake-4.1.7/extra2doc/package.examples0000664000175000017500000000003712416763277020454 0ustar osamuosamu00000000000000### See dh_installexamples(1) debmake-4.1.7/extra2doc/package.info0000664000175000017500000000003312416763277017565 0ustar osamuosamu00000000000000### See dh_installinfo(1) debmake-4.1.7/TODO0000664000175000017500000000010112416763277014106 0ustar osamuosamu00000000000000TODO ==== * better perl build support * better CMake support debmake-4.1.7/extra0override/0000775000175000017500000000000012416770056016362 5ustar osamuosamu00000000000000debmake-4.1.7/extra0override/autogen0000664000175000017500000000102212416766106017743 0ustar osamuosamu00000000000000### Initialize source with autogen.sh found in the upstream override_dh_autoreconf: dh_autoreconf -- autogen.sh ### Alternatively ### support for -Wl,--as-needed to ltmain.sh with autoreconf -f -i ###override_dh_autoreconf: ### dh_autoreconf --as-needed ### ### Set options for ./configure ###CONFIGURE_FLAGS = ###overrride_dh_configure: ### dh_configure -- $(CONFIGURE_FLAGS) ### ### Do not install libtool archive, python .pyc .pyo override_dh_install: dh_install --list-missing -X.la -X.pyc -X.pyo debmake-4.1.7/extra0override/autoreconf0000664000175000017500000000061112416766106020451 0ustar osamuosamu00000000000000### Support for -Wl,--as-needed to ltmain.sh with autoreconf -f -i override_dh_autoreconf: dh_autoreconf --as-needed ### ### Set options for ./configure ###CONFIGURE_FLAGS = ###overrride_dh_configure: ### dh_configure -- $(CONFIGURE_FLAGS) ### ### Do not install libtool archive, python .pyc .pyo override_dh_install: dh_install --list-missing -X.la -X.pyc -X.pyo debmake-4.1.7/extra0override/judge0000664000175000017500000000024412416766106017404 0ustar osamuosamu00000000000000### This is to speed up and avoid build failure for -j option ### This should not be in debian/rules of the packaged source override_dh_auto_test: : # do nothing debmake-4.1.7/extra0override/java0000664000175000017500000000010512416766106017223 0ustar osamuosamu00000000000000### Set debian/javabuild as /usr/share/doc/javahelper/tutorial.html debmake-4.1.7/extra0override/multiarch0000664000175000017500000000025512416766106020300 0ustar osamuosamu00000000000000### This is example for Cmake (See http://bugs.debian.org/641051 ) ###override_dh_auto_configure: ### dh_auto_configure -- \ ### -DCMAKE_LIBRARY_PATH=$(DEB_HOST_MULTIARCH) debmake-4.1.7/extra0override/pythons0000664000175000017500000000142012416766106020007 0ustar osamuosamu00000000000000### Too cmplicated to provide examples here. ### ### Check situation of Python on Debian ### https://wiki.debian.org/Python ### ### For transition to dh_python2 (jessie and later) ### https://wiki.debian.org/Python/TransitionToDHPython2 ### ### To support python2.7 and python3, there are 2 ways to package: ### * packaging with --buildsystem=pybuild (jessie and later) ### https://wiki.debian.org/Python/Pybuild ### https://wiki.debian.org/Python/LibraryStyleGuide ### ### * packaging without --buildsystem=pybuild (wheezy) ### https://wiki.debian.org/Python/AppStyleGuide ### ### To update the upstream source to support python3, see ### https://wiki.python.org/moin/Python2orPython3 ### https://wiki.python.org/moin/PortingToPy3k/BilingualQuickRef debmake-4.1.7/extra0override/dbg0000664000175000017500000000017212416766106017042 0ustar osamuosamu00000000000000### See https://www.debian.org/doc/manuals/developers-reference/best-pkging-practices.html#bpp-dbg override_dh_strip: {} debmake-4.1.7/extra0export/0000775000175000017500000000000012416770056016064 5ustar osamuosamu00000000000000debmake-4.1.7/extra0export/compiler0000664000175000017500000000050512416766101017615 0ustar osamuosamu00000000000000### See FEATURE AREAS in dpkg-buildflags(1) #export DEB_BUILD_MAINT_OPTIONS = hardening=+all ### ### See ENVIRONMENT in dpkg-buildflags(1) ### Package maintainers to append CFLAGS #export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic ### Package maintainers to append LDFLAGS #export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed debmake-4.1.7/extra0export/vala0000664000175000017500000000014112416766101016722 0ustar osamuosamu00000000000000### Vala source requires this. VALAFLAGS:=$(foreach w,$(CPPFLAGS) $(CFLAGS) $(LDFLAGS),-X $(w)) debmake-4.1.7/extra0export/java0000664000175000017500000000026112416766101016723 0ustar osamuosamu00000000000000### Java source requires these. export JAVA_HOME=/usr/lib/jvm/default-java export CLASSPATH=/usr/share/java/csv.jar:/usr/share/java/debug-disable.jar:/usr/share/java/itext.jar debmake-4.1.7/extra2lib/0000775000175000017500000000000012416770056015313 5ustar osamuosamu00000000000000debmake-4.1.7/extra2lib/package.install0000664000175000017500000000010312416763277020277 0ustar osamuosamu00000000000000### Candidates as below and see dh_install(1). ###usr/lib/*/*.so.* debmake-4.1.7/extra2lib/package.symbols0000664000175000017500000000024212416763277020325 0ustar osamuosamu00000000000000### See dh_makeshlibs(1) ### For C library, please fill this file with pertinent data. ### For C++ library, you may remove this to use shlibs mechanism instead. debmake-4.1.7/manpages/0000775000175000017500000000000012416770056015212 5ustar osamuosamu00000000000000debmake-4.1.7/manpages/debmake.10000664000175000017500000005061712416767353016703 0ustar osamuosamu00000000000000'\" t .\" Title: debmake .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets v1.78.1 .\" Date: 10/14/2014 .\" Manual: Debmake Manual .\" Source: DEBMAKE 4.0 .\" Language: English .\" .TH "DEBMAKE" "1" "10/14/2014" "DEBMAKE 4\&.0" "Debmake Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" debmake \- program to make the Debian source package .SH "SYNOPSIS" .sp \fBdebmake\fR [\fB\-h\fR] [\fB\-c\fR | \fB\-k\fR] [\fB\-n\fR | \fB\-a\fR \fIpackage\-version\fR\fB\&.orig\&.tar\&.gz\fR | \fB\-d\fR | \fB\-t\fR ] [\fB\-p\fR \fIpackage\fR] [\fB\-u\fR \fIversion\fR] [\fB\-r\fR \fIrevision\fR] [\fB\-z\fR \fIextension\fR] [\fB\-b\fR "\fIbinarypackage\fR\fI, \&...\fR]" [\fB\-e\fR \fIfoo@example\&.org\fR] [\fB\-f\fR "\fIfirstname lastname\fR"] [\fB\-i\fR "\fIbuildtool\fR" | \fB\-j\fR] [\fB\-l\fR \fIlicense_file\fR] [\fB\-m\fR] [\fB\-o\fR \fIfile\fR] [\fB\-q\fR] [\fB\-s\fR] [\fB\-v\fR] [\fB\-w\fR "\fIaddon, \&...\fR"] [\fB\-x\fR [01234]] [\fB\-y\fR] [\fB\-Q\fR] .SH "DESCRIPTION" .sp \fBdebmake\fR helps to build the Debian package from the upstream source\&. Normally, this is done as follows: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} The upstream tarball is downloaded as the \fIpackage\-version\fR\fB\&.tar\&.gz\fR file\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} It is untared to create many files under the \fIpackage\-version/\fR directory\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} debmake is invoked in the \fIpackage\-version/\fR directory possibly without any arguments\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Files in the \fIpackage\-version\fR\fB/debian/\fR directory are manually adjusted\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdpkg\-buildpackage\fR (usually from its wrapper \fBdebuild\fR or \fBpdebuild\fR) is invoked in the \fIpackage\-version/\fR directory to make debian packages\&. .RE .sp Make sure to protect the arguments of the \fB\-b\fR, \fB\-f\fR, \fB\-l\fR, and \fB\-w\fR options from the shell interference by quoting them properly\&. .SS "optional arguments:" .PP \fB\-h\fR, \fB\-\-help\fR .RS 4 show this help message and exit\&. .RE .PP \fB\-c\fR, \fB\-\-copyright\fR .RS 4 scan source for copyright+license text and exit\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-c\fR: sinple output style .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-cc\fR: normal output style (similar to the \fBdebian/copyright\fR file) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-ccc\fR: debug output style .RE .RE .PP \fB\-k\fR, \fB\-\-kludge\fR .RS 4 compare the \fBdebian/copyright\fR file with the source and exit\&. .sp The \fBdebian/copyright\fR file must be organized to list the generic file patterns before the specific exceptions\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-k\fR: basic output style .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-kk\fR: verbose output style .RE .RE .PP \fB\-n\fR, \fB\-\-native\fR .RS 4 make a native Debian source package without \fB\&.orig\&.tar\&.gz\fR\&. This makes the "\fB3\&.0 (native)\fR" format package\&. .sp If you are thinking to package a Debian specific source tree with \fBdebian/\fR* in it into a native Debian package, please think otherwise\&. You can use "\fBdebmake \-d \-i debuild\fR" or "\fBdebmake \-t \-i debuild\fR" to make the "\fB3\&.0 (quilt)\fR" format non\-native Debian package\&. The only difference is that the \fBdebian/changelog\fR file must use the non\-native version scheme: \fIversion\-revision\fR\&. The non\-native package is more friendly to the downstream distributions\&. .RE .PP \fB\-a\fR \fIpackage\-version\fR\fB\&.tar\&.gz\fR, \fB\-\-archive\fR \fIpackage\-version\fR\fB\&.tar\&.gz\fR .RS 4 use the upstream source tarball directly\&. (\fB\-p\fR, \fB\-u\fR, \fB\-z\fR: overridden) .sp The upstream tarball may be specified as \fIpackage_version\fR\fB\&.orig\&.tar\&.gz\fR and \fBtar\&.gz\fR for all cases may be \fBtar\&.bz2\fR, or \fBtar\&.xz\fR\&. .sp If the specified upstream tarball name contains uppercase letters, the Debian package name is generated by converting them to lowercase letters\&. .sp If the specified argument is the URL (http://, https://, or ftp://) to the upstream tarball, the upstream tarball is downloaded from the URL using \fBwget\fR or \fBcurl\fR\&. .RE .PP \fB\-d\fR, \fB\-\-dist\fR .RS 4 run "make dist" equivalent first to generate upstream tarball and use it\&. .sp "\fBdebmake \-d\fR" is designed to run in the \fIpackage/\fR directory hosting the upstream VCS with the build system supporting "\fBmake dist\fR" equivalents\&. (automake/autoconf, Python distutils, \&...) .RE .PP \fB\-t\fR, \fB\-\-tar\fR .RS 4 run "\fBtar\fR" to generate upstream tarball and use it .sp "\fBdebmake \-t\fR" is designed to run in the \fIpackage/\fR directory hosting the upstream VCS\&. Unless you provide the upstream version with the \fB\-u\fR option or with the \fBdebian/changelog\fR file, a snapshot upstream version is generated in the 0~%y%m%d%H%M format, e\&.g\&., 0~1403012359, from the UTC date and time\&. The generated tarball excludes the \fBdebian/\fR directory found in the upstream VCS\&. (It also excludes typical VCS directories: \fB\&.git/ \&.hg/ \&.svn/ \&.CVS/\fR) .RE .PP \fB\-p\fR \fIpackage\fR, \fB\-\-package\fR \fIpackage\fR .RS 4 set the Debian package name\&. .RE .PP \fB\-u\fR \fIversion\fR, \fB\-\-upstreamversion\fR \fIversion\fR .RS 4 set the upstream package version\&. .RE .PP \fB\-r\fR \fIrevision\fR, \fB\-\-revision\fR \fIrevision\fR .RS 4 set the Debian package revision\&. .RE .PP \fB\-z\fR \fIextension\fR, \fB\-\-targz\fR \fIextension\fR .RS 4 set the tarball type, \fIextension\fR=(\fBtar\&.gz\fR|\fBtar\&.bz2\fR|\fBtar\&.xz\fR) (alias: \fBz\fR, \fBb\fR, \fBx\fR) .RE .PP \fB\-b\fR "\fIbinarypackage[:type],\&...\fR", \fB\-\-binaryspec\fR "\fIbinarypackage[:type],\&...\fR" .RS 4 set binary package specs by the comma separated list of \fIbinarypackage:type\fR pairs, e\&.g\&., in full form "\fBfoo:bin,foo\-doc:doc,libfoo1:lib,libfoo1\-dbg:dbg,libfoo\-dev:dev\fR" or in short form "\fB,\-doc,libfoo1,libfoo1\-dbg, libfoo\-dev\fR"\&. .sp Here, \fIbinarypackage\fR is the binary package name; and optional \fItype\fR is chosen from the following \fItype\fR values: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbin\fR: C/C++ compiled ELF binary code package (any, foreign) (default, alias: \fB""\fR, i\&.e\&., \fInull\-string\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdata\fR: Data (fonts, graphics, \&...) package (all, foreign) (alias: \fBda\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdbg\fR: Debug symbol package (any, same) (alias: \fBdb\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdev\fR: Library development package (any, same) (alias: \fBde\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdoc\fR: Documentation package (all, foreign) (alias: \fBdo\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBlib\fR: Library package (any, same) (alias: \fBl\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBperl\fR: Perl script package (all, foreign) (alias: \fBpl\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBpython\fR: Python script package (all, foreign) (alias: \fBpy\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBpython3\fR: Python3 script package (all, foreign) (alias: \fBpy3\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBruby\fR: Ruby script package (all, foreign) (alias: \fBrb\fR) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBscript\fR: Shell script package (all, foreign) (alias: \fBsh\fR) .RE .sp The pair values in the parentheses, such as (any, foreign), are the \fBArchitecture\fR and \fBMulti\-Arch\fR stanza values set in the \fBdebian/control\fR file\&. .sp In many cases, the \fBdebmake\fR command makes good guesses for \fItype\fR from \fIbinarypackage\fR\&. If \fItype\fR is not obvious, \fItype\fR is set to \fBbin\fR\&. For example, \fBlibfoo\fR sets \fItype\fR to \fBlib\fR, and \fBfont\-bar\fR sets \fItype\fR to \fBdata\fR, \&... .sp If the source tree contents do not match settings for \fItype\fR, \fBdebmake\fR warns you\&. .RE .PP \fB\-e\fR \fIfoo@example\&.org\fR, \fB\-\-email\fR \fIfoo@example\&.org\fR .RS 4 set e\-mail address\&. .sp The default is taken from the value of the environment variable \fB$DEBEMAIL\fR\&. .RE .PP \fB\-f\fR "\fIfirstname lastname\fR", \fB\-\-fullname\fR "\fIfirstname lastname\fR" .RS 4 set the fullname\&. .sp The default is taken from the value of the environment variable \fB$DEBFULLNAME\fR\&. .RE .PP \fB\-i\fR "\fIbuildtool\fR", \fB\-\-invoke\fR "\fIbuildtool\fR" .RS 4 invoke "\fIbuildtool\fR" at the end of execution\&. "\fIbuildtool\fR" may be "\fBdpkg\-buildpackage\fR", "\fBdebuild\fR", "\fBpdebuild\fR", "\fBpdebuild \-\-pbuilder cowbuilder\fR", etc\&.\&. .sp The default is not to execute any program\&. .RE .PP \fB\-j\fR, \fB\-\-judge\fR .RS 4 run \fBdpkg\-depcheck\fR to judge build dependencies and identify file paths\&. Log files are in the parent directory\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIpackage\fR\fB\&.build\-dep\&.log\fR: Log file for \fBdpkg\-depcheck\fR\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIpackage\fR\fB\&.install\&.log\fR: Log file recording files in the \fBdebian/tmp\fR directory\&. .RE .RE .PP \fB\-l\fR "\fIlicense_file,\&...\fR", \fB\-\-license\fR "\fIlicense_file,\&...\fR" .RS 4 add formatted license text to the end of the \fBdebian/copyright\fR file holding license scan results .sp The default is add \fBCOPYING\fR and \fBLICENSE\fR and \fIlicense_file\fR needs to list only the additional file names all separated by "\fB,\fR"\&. .RE .PP \fB\-m\fR, \fB\-\-monoarch\fR .RS 4 force packages to be non\-multiarch\&. .RE .PP \fB\-o\fR \fIfile\fR, \fB\-\-option\fR \fIfile\fR .RS 4 read optional parameters from file\&. (This is not for everyday use\&.) .sp The \fIfile\fR is sourced as the Python3 code at the end of \fBpara\&.py\fR\&. For example, the package description can be specified by the following file\&. .sp .if n \{\ .RS 4 .\} .nf para[\*(Aqdesc\*(Aq] = \*(Aqprogram short description\*(Aq para[\*(Aqdesc_long\*(Aq] = \*(Aq\*(Aq\*(Aq\e program long description which you wish to include\&. \&. Empty line is space + \&. You keep going on \&.\&.\&. \*(Aq\*(Aq\*(Aq .fi .if n \{\ .RE .\} .RE .PP \fB\-q\fR, \fB\-\-quitearly\fR .RS 4 quit early before creating files in the \fBdebian/\fR directory\&. .RE .PP \fB\-s\fR, \fB\-\-spec\fR .RS 4 use upstream spec (setup\&.py for Python, etc\&.) for the package description\&. .RE .PP \fB\-v\fR, \fB\-\-version\fR .RS 4 show version information\&. .RE .PP \fB\-w\fR "\fIaddon,\&...\fR", \fB\-\-with\fR "\fIaddon,\&...\fR" .RS 4 add extra arguments to the \fB\-\-with\fR option of the \fBdh\fR(1) command as \fIaddon\fR in \fBdebian/rules\fR\&. .sp The \fIaddon\fR values are listed all separated by "\fB,\fR", e\&.g\&., \fB\-w "python2,autoreconf"\fR\&. .sp For Autotools based packages, setting \fBautoreconf\fR as \fIaddon\fR forces to run "\fBautoreconf \-i \-v \-f\fR" for every package building\&. Otherwise, \fBautotools\-dev\fR as \fIaddon\fR is used as default\&. .sp For Autotools based packages, if they install Python programs, \fBpython2\fR as addon is needed for packages with \fBcompat < 9\fR since this is non\-obvious\&. But for \fBsetup\&.py\fR based packages, \fBpython2\fR as \fIaddon\fR is not needed since this is obvious and it is automatically set for the \fBdh\fR(1) command by the \fBdebmake\fR command when it is required\&. .RE .PP \fB\-x\fR \fIn\fR, \fB\-\-extra\fR \fIn\fR .RS 4 generate extra configuration files as templates\&. .sp The number \fIn\fR changes which configuration templates are generated\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-x0\fR: bare minimum configuration files\&. (default if these files exist already) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-x1\fR: ,, + desirable configuration files\&. (default for new packages) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-x2\fR: ,, + interesting configuration files\&. (recommended for experts, multi binary aware) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-x3\fR: ,, + unusual configuration template files with the extra \fB\&.ex\fR suffix to ease their removal\&. (recommended for new users) To use these as configuration files, rename their file names into ones without the \fB\&.ex\fR suffix\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-x4\fR: ,, + copyright file examples\&. .RE .RE .PP \fB\-y\fR, \fB\-\-yes\fR .RS 4 force "yes" for all prompts\&. (without option: "ask [Y/n]"; doubled option: force "no") .RE .PP \fB\-Q\fR, \fB\-\-quiet\fR .RS 4 quiet tutorial comment lines marked with \fB###\fR in template files .RE .SH "EXAMPLES" .sp For a well behaving source, you can build a good\-for\-local\-use installable single Debian binary package easily with one command\&. Test install of such a package generated in this way offers a good alternative to traditional "\fBmake install\fR" to the \fB/usr/local\fR directory since the Debian package can be removed cleanly by the "\fBdpkg \-P\fR \fI\&...\fR" command\&. Here are some examples of how to build such test packages\&. (These should work in most cases\&. If the \fB\-d\fR does not work, try \fB\-t\fR instead\&.) .sp For a typical C program source tree packaged with autoconf/automake: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdebmake \-d \-i debuild\fR .RE .sp For a typical python module source tree: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdebmake \-s \-d \-b":python" \-i debuild\fR .RE .sp For a typical python module in the \fIpackage\-version\fR\fB\&.tar\&.gz\fR archive: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdebmake \-s \-a \fR\fB\fIpackage\-version\fR\fR\fB\&.tar\&.gz \-b":python" \-i debuild\fR .RE .sp For a typical perl module in the \fIPackage\-version\fR\fB\&.tar\&.gz\fR archive: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdebmake \-a \fR\fB\fIPackage\-version\fR\fR\fB\&.tar\&.gz \-b":perl" \-i debuild\fR .RE .SH "HELPER PACKAGES" .sp Packaging may require installation of some additional specialty helper packages\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Python3 program may require the \fBdh\-python\fR package\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Autotools (Autoconf + Automake) build system may require \fBautotools\-dev\fR or \fBdh\-autoreconf\fR package\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Ruby program may require the \fBgem2deb\fR package\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Java program may require the \fBjavahelper\fR package\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Gnome programs may require the \fBgobject\-introspection\fR package\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} etc\&. .RE .SH "CAVEAT" .sp \fBdebmake\fR is meant to provide template files for the package maintainer to work on\&. Comment lines started by \fB###\fR are the tutorial text\&. You must remove or edit such comment lines before uploading to the Debian archive\&. .sp There are some limitations for what characters may be used as a part of the Debian package\&. The most notable limitation is the prohibition of uppercase letters in the package name\&. Here is the summary in the regular expression\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Upstream package name (\fB\-p\fR): [\-+\&.a\-z0\-9]{2,} .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Binary package name (\fB\-b\fR): [\-+\&.a\-z0\-9]{2,} .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Upstream version (\fB\-u\fR): [0\-9][\-+\&.:~a\-z0\-9A\-Z]* .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Debian revision (\fB\-r\fR): [0\-9][+\&.~a\-z0\-9A\-Z]* .RE .sp See the exact definition in Chapter 5 \- Control files and their fields of the \(lqDebian Policy Manual\(rq\&. .SH "DEBUG" .sp The character set in the environment variable \fB$DEBUG\fR determines the logging output level\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBp\fR: list all global parameters .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBd\fR: list parsed parameters for all binary packages .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBf\fR: input filename for the copyright scan .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBy\fR: year/name split of copyright line .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBs\fR: line scanner for format_state .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBb\fR: content_state scan loop: begin\-loop .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBm\fR: content_state scan loop: after regex match .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBe\fR: content_state scan loop: end\-loop .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBc\fR: print copyright section text .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBl\fR: print license section text .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBa\fR: print author/translator section text .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBk\fR: sort key for debian/copyright stanza .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBn\fR: scan result of debian/copyright (debmake \-k) .RE .sp Use this as: .sp .if n \{\ .RS 4 .\} .nf $ DEBUG=pdfbmeclak debmake \&.\&.\&. .fi .if n \{\ .RE .\} .SH "AUTHOR" .sp Copyright \(co 2014 Osamu Aoki .SH "LICENSE" .sp MIT License .SH "SEE ALSO" .sp The debamake package provides following HTML documents: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} A simple tutorial: /usr/share/doc/debmake/debmake\&.html .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} A full tutorial document for the Debian packaging with packaging examples: /usr/share/doc/debmake/maint\-guide\&.html .RE .sp Also, please read the original Debian New Maintainers\*(Aq Guide provided by the the \fBmaint\-guide\fR package\&. .sp See also \fBdpkg\-source\fR(1), \fBdeb\-control\fR(5), \fBdebhelper\fR(7), \fBdh\fR(1), \fBdpkg\-buildpackage\fR(1), \fBdebuild\fR(1), \fBquilt\fR(1), \fBdpkg\-depcheck\fR(1), \fBpdebuild\fR(1), \fBpbuilder\fR(8), \fBcowbuilder\fR(8), \fBgbp\-buildpackage\fR(1), \fBgbp\-pq\fR(1), and \fBgit\-pbuilder\fR(1) manpages\&. debmake-4.1.7/README0000664000175000017500000000600612416763277014310 0ustar osamuosamu00000000000000README for debmake ------------------ This is the new debmake program written in Python. This provides convenient command to make a Debian package from the upstream VCS/tarball/source-tree. See the TUTORIAL file for the introductory guide. LICENSE for the entire source ----------------------------- 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. HISTORY ------- The author thanks previous efforts on this topic (GPL): * debmake: 1996-1997 Christoph Lameter 1997-2006 Santiago Vila command: deb-make, version up to 3.8 (shell script) * dh-make: 1998-2012 Craig Small command: dh_make (perl script) FILES outside of extra/ ----------------------- Copyright © 2013 Osamu Aoki FILES in extra/ --------------- Copyright © Jim Van Zandt Copyright © Santiago Vila Copyright © Dirk Eddelbuettel Copyright © Nils Naumann Copyright © Jim Van Zandt Copyright © 2013 Osamu Aoki These are originally generated by the output of the dh_make command. The output has been edited by Osamu Aoki to fit into this package. The dh-make package came with the GPL license with the following permissive exception: As a special exception, when the template files are copied by dh-make into dh-make output files, you may use those output files without restriction. This special exception was added by Craig Small in version 0.37 of dh-make. Since this exception is permissive, I am releasing the entire source package under permissive MIT license as above. How to install -------------- Debian: $ sudo apt-get install debmake Non-Debian POSIX system with Python3 (user: ~/.local) $ python3 setup.py install --user ($PATH should include ~/.local/bin ) Non-Debian POSIX system with Python3 (system: /usr/local) $ sudo python3 setup.py install -- Osamu Aoki Sat, 20 Apr 2013 04:09:26 +0900 debmake-4.1.7/debmake/0000775000175000017500000000000012416770056015007 5ustar osamuosamu00000000000000debmake-4.1.7/debmake/origtar.py0000775000175000017500000000513312416763277017044 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import os import subprocess import sys ########################################################################### # origtar: called from debmake.main() ########################################################################### def origtar(package, version, targz, tarball, srcdir): # cd .. os.chdir('..') print('I: pwd = "{}"'.format(os.getcwd()), file=sys.stderr) ####################################################################### # make package_versdion.orig.tar.gz in the parent directory if not exist # source is in srcdir ####################################################################### origtargz = package + '_' + version + '.orig.' + targz if os.path.isfile(tarball): if tarball == origtargz: print('I: Use existing "{}" as upstream tarball'.format(tarball), file=sys.stderr) else: command = 'ln -sf ' + tarball + ' ' + origtargz print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: failed to create symlink.', file=sys.stderr) exit(1) elif os.path.isfile(origtargz): print('I: Use existing "{}" as upstream tarball'.format(origtargz), file=sys.stderr) else: print('E: missing "{}".'.format(tarball), file=sys.stderr) exit(1) os.chdir(srcdir) # calling side ensures this print('I: pwd = "{}"'.format(os.getcwd()), file=sys.stderr) return if __name__ == '__main__': print('no test') debmake-4.1.7/debmake/tar.py0000775000175000017500000000701612416763277016165 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import glob import os import re import subprocess import sys import debmake.yn ########################################################################### # tar: called from debmake.main() ########################################################################### # tarball = package-version.tar.gz (or package_version.orig.tar.gz) # targz = tar.gz # srcdir = package-version # parent = parent directory name # yes = True if -y, False as default ########################################################################### def tar(tarball, targz, srcdir, parent, yes): print('I: pwd = "{}"'.format(os.getcwd()), file=sys.stderr) ####################################################################### # make distribution tarball using tar excluding debian/ directory # VCS tree are not copied. ####################################################################### os.chdir('..') print('I: pwd = "{}"'.format(os.getcwd()), file=sys.stderr) if srcdir == parent: print('I: good, -t (--tar) run in the versioned directory', file=sys.stderr) else: if os.path.isdir(srcdir): debmake.yn.yn('remove "{}" directory in tar'.format(srcdir), 'rm -rf ' + srcdir, yes) # copy from parent to srcdir using hardlinks (with debian/* data) command = 'rsync -aCv --link-dest=' + os.getcwd() + '/' + parent + ' ' + parent + '/. ' + srcdir print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: rsync -aCv failed.', file=sys.stderr) exit(1) # tar while excluding VCS and debian directories command = 'tar --exclude=\'' + srcdir + '/debian\' --anchored --exclude-caches --exclude-vcs ' if targz == 'tar.gz': command += '-cvzf ' elif targz == 'tar.bz2': command += '--bzip2 -cvf ' elif targz == 'tar.xz': command += '--xz -cvf ' else: print('E: Wrong file format "{}".'.format(targz), file=sys.stderr) exit(1) command += tarball + ' ' + srcdir print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: tar failed {}.'.format(tarball), file=sys.stderr) exit(1) print('I: {} tarball made'.format(tarball), file=sys.stderr) os.chdir(srcdir) print('I: pwd = "{}"'.format(os.getcwd()), file=sys.stderr) return if __name__ == '__main__': print('No test program') debmake-4.1.7/debmake/sanity.py0000775000175000017500000002230712416763277016706 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import datetime import glob import os import re import subprocess import sys ########################################################################### # sanity: called from debmake.main() ########################################################################### def sanity(para): ####################################################################### # Normalize para[] for each exclusive build case (-d -t -a) ####################################################################### package = '' version = '' revision = '' targz = '' if para['archive']: # -a # remote URL reurl = re.match(r'(http://|https://|ftp://).*/([^/]+)$', para['tarball']) if reurl: url = para['tarball'] para['tarball'] = reurl.group(2) if os.path.isfile('/usr/bin/wget'): command = '/usr/bin/wget ' + url elif os.path.isfile('/usr/bin/curl'): command = '/usr/bin/curl ' + url else: print('E: please install wget or curl.', file=sys.stderr) exit(1) print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: wget/curl failed.', file=sys.stderr) exit(1) parent = '' # tarball: ibus-1.5.5-2.fc19.src.rpm resrcrpm = re.match(r'([^/_]+-[^/_-]+)-[0-9]+\.[^.]+\.src\.rpm$', os.path.basename(para['tarball'])) if resrcrpm: command = 'rpm2cpio ' + para['tarball'] + '|cpio -dium' print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: rpm2cpioc ... | cpio -dium failed.', file=sys.stderr) exit(1) files = glob.glob(resrcrpm.group(1) + '*.tar.gz') + \ glob.glob(resrcrpm.group(1) + '*.tar.bz2') + \ glob.glob(resrcrpm.group(1) + '*.tar.xz') if files: para['tarball'] = files[0] else: print('E: no tar found in src.rpm.', file=sys.stderr) exit(1) if not os.path.isfile(para['tarball']): print('E: Non-existing tarball name {}'.format(para['tarball']), file=sys.stderr) exit(1) if os.path.abspath(os.path.dirname(para['tarball'])) != os.getcwd(): command = 'cp ' + para['tarball'] + ' ' + os.path.basename(para['tarball']) print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: {} failed.'.format(command), file=sys.stderr) exit(1) para['tarball'] = os.path.basename(para['tarball']) # tarball: package_version.orig.tar.gz reorigtar = re.match(r'([^/_]+)_([^-/_]+)\.orig\.(tar\.gz|tar\.bz2|tar\.xz)$', para['tarball']) # tarball: package-version.tar.gz or package_version.tar.gz rebasetar = re.match(r'([^/_]+)[-_]([^-/_]+)\.(tar\.gz|tar\.bz2|tar\.xz)$', para['tarball']) if reorigtar: package = reorigtar.group(1).lower() version = reorigtar.group(2) targz = reorigtar.group(3) elif rebasetar: package = rebasetar.group(1).lower() version = rebasetar.group(2) targz = rebasetar.group(3) else: print('E: Non-supported tarball name {}'.format(para['tarball']), file=sys.stderr) exit(1) ####################################################################### if not para['archive']: # not -a parent = os.path.basename(os.getcwd()) # check changelog for package/version/revision (non-native package) if not para['native'] and os.path.isfile('debian/changelog'): with open('debian/changelog', 'r') as f: line = f.readline() pkgver = re.match('([^ \t]+)[ \t]+\(([^()]+)-([^-()]+)\)', line) if pkgver: package = pkgver.group(1).lower() version = pkgver.group(2) revision = pkgver.group(3) else: print('E: changelog start with "{}"'.format(line), file=sys.stderr) exit(1) ####################################################################### if para['tar']: # -t if version == '': version = datetime.datetime.utcnow().strftime("0~%y%m%d%H%M") # 0~YYMMDDHHmm ####################################################################### # set parent/srcdir/tarball/package/version/revision para['parent'] = parent if para['package'] == '': para['package'] = package elif para['package'] != package: print('W: -p "{}" != auto set value "{}"'.format(para['package'], package), file=sys.stderr) if para['version'] == '': para['version'] = version elif para['version'] != version: print('W: -u "{}" != auto set value "{}"'.format(para['version'], version), file=sys.stderr) ####################################################################### if not para['archive']: # not -a if para['revision'] == '': para['revision'] = revision elif para['revision'] != revision: print('W: -r "{}" != auto set value "{}"'.format(para['revision'], revision), file=sys.stderr) ####################################################################### if para['archive']: # -a if para['targz'] == '': para['targz'] = targz elif para['targz'] != targz: print('W: -r "{}" != auto set value "{}"'.format(para['targz'], targz), file=sys.stderr) ####################################################################### if not para['archive']: # not -a # set para['targz'] if para['targz'] == '': para['targz'] = 'tar.gz' elif para['targz'][0] == 'g': para['targz'] = 'tar.gz' elif para['targz'][0] == 'b': para['targz'] = 'tar.bz2' elif para['targz'][0] == 'x': para['targz'] = 'tar.xz' elif para['targz'] == 'tar.gz': pass elif para['targz'] == 'tar.bz2': pass elif para['targz'] == 'tar.xz': pass else: print('E: --targz (-z) value is invalid: {}'.format(para['targz']), file=sys.stderr) exit(1) ####################################################################### if para['archive']: para['srcdir'] = para['package'] + '-' + para['version'] # para['tar'] may be Foo-1.0.tar.xz and keep it so. elif para['dist']: # -d pass # differ package/version/tarball/srcdir else: # normal (native/non-native) or -t if para['version'] == '':# -u missing pkgver = re.match('^([^_]+)-([^-_]+)$', parent) if pkgver: if para['package'] == '': # both -p and -u missing para['package'] = pkgver.group(1).lower() para['version'] = pkgver.group(2) # -u missing else: print('E: invalid parent directory for setting package/version: {}'.format(parent), file=sys.stderr) print('E: rename parent directory to "package-version".', file=sys.stderr) exit(1) elif para['package'] == '': # -u set, -p missing para['package'] = parent.lower() para['srcdir'] = para['package'] + '-' + para['version'] para['tarball'] = para['package'] + '-' + para['version'] + '.' + para['targz'] ####################################################################### if para['revision'] == '': para['revision'] = '1' ####################################################################### # Dynamic content with package name etc. ####################################################################### para['section'] = 'unknown' para['priority'] = 'extra' para['homepage'] = '' para['vcsvcs'] = 'git://anonscm.debian.org/collab-maint/' + para['package'] + '.git' para['vcsbrowser'] = 'http://anonscm.debian.org/gitweb/?p=collab-maint/' + para['package'] + '.git' return para debmake-4.1.7/debmake/kludge.py0000775000175000017500000002075212416763277016654 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import collections import glob import itertools import operator import os import re import sys import debmake.copyright import debmake.scanfiles re_round0 = re.compile(r'\.0') def copydiff(mode): ########################################################################### # parse existing debian/copyright against source tree ########################################################################### if not os.path.isfile('debian/copyright'): print('E: You need debian/copyright.') exit(1) with open('debian/copyright', 'r') as f: lines = f.readlines() patterns_for_license = [] license = '' f_file = False f_cont = False f_license = False patterns = [] iptn = -1 licenses_old = {} file_to_pattern = {} for line in lines + ['']: # easy sure EOF line = line.rstrip() if line == '': # summarize data if patterns_for_license != [] and license != '': for ptn in patterns_for_license: patterns.append(ptn) iptn += 1 # 0, 1, 2, 3 ... globbed_file_or_dirs = glob.glob(ptn) if globbed_file_or_dirs: for file_or_dir in globbed_file_or_dirs: if os.path.isfile(file_or_dir): file_to_pattern[file_or_dir] = (iptn, ptn) licenses_old[file_or_dir] = license debmake.debug.debug('Dn: Pattern #{:02}: {}, file={}, {}'.format(iptn, ptn, file_or_dir, license), type='n') elif os.path.isdir(file_or_dir): for dir, subdirs, files in os.walk(file_or_dir): #debmake.debug.debug('Dn: Pattern #{:02}: {}, dir={}, files={}'.format(iptn, ptn, dir, files), type='n') for file in files: filepath = os.path.join(dir, file) file_to_pattern[filepath] = (iptn, ptn) licenses_old[filepath] = license debmake.debug.debug('Dn: Pattern #{:02}: {}, filepath={}, {}'.format(iptn, ptn, filepath, license), type='n') else: file_to_pattern['__MISSING__'] = (iptn, ptn) licenses_old['__MISSING__'] = license debmake.debug.debug('Dn: Pattern #{:02}: {}, file={}, {}'.format(iptn, ptn, '__MISSING__', license), type='n') # Next stanza patterns_for_license = [] license = '' f_file = False f_cont = False f_license = False elif line[:6].lower() == 'files:': patterns_for_license += line[6:].split() f_file = True f_cont = True elif line[:8].lower() == 'license:': license = line[8:].strip() f_cont = False elif f_cont == True and line[:1] == ' ': patterns_for_license += line.split() elif f_cont == True and line[:1] == '\t': patterns_for_license += line.split() elif line[:1].lower() != ' ': f_cont = False else: pass nptn = iptn + 1 ########################################################################### iptn_to_ptn = {} iptn_to_files = collections.defaultdict(list) for file, (iptn, ptn) in file_to_pattern.items(): iptn_to_ptn[iptn] = ptn iptn_to_files[iptn].append(file) debmake.debug.debug('Dn: file="{}", iptn="{}", ptn="{}"'.format(file, iptn, ptn), type='n') if nptn != len(iptn_to_ptn): print("W: ***** Number of patterns unused: {} out of range(0, {}) *****".format(nptn - len(iptn_to_ptn), nptn), file=sys.stderr) ########################################################################### # scan copyright of the source tree and create license_new[] ########################################################################### (nonlink_files, xml_html_files, binary_files, huge_files, extcount, extcountlist) = debmake.scanfiles.scanfiles() data_new = debmake.copyright.check_copyright(nonlink_files, mode=1) licenses_new = {} for (licenseid, licensetext, files, copyright_lines) in data_new: licenseid = licenseid.strip() debmake.debug.debug('Dn: debian/copyright: "{}": {}'.format(licenseid, files), type='n') for file in files: licenses_new[file] = licenseid ########################################################################### # generate data with before/after ########################################################################### data = [] for iptn in range(0, nptn): if iptn in iptn_to_ptn.keys(): ptn = iptn_to_ptn[iptn] files = iptn_to_files[iptn] else: print('W: ***** Pattern #{:02}: "{}" unused, reorder debian/copyright *****'.format(iptn, patterns[iptn]), file=sys.stderr) for file in files: old = licenses_old[file] if file in licenses_new.keys(): new = licenses_new[file] else: new = '' if old == new and mode <= 5: printdiff = False # exact match elif old.lower() == new.lower() and mode <= 4: printdiff = False # case insensitive match elif old.lower() == re_round0.sub('', new.lower()) and mode <= 4: printdiff = False # ignore tailing .0 elif new =='' and mode <= 3: printdiff = False elif new[:2] == '__' and mode <= 2: printdiff = False else: # (old, new) not the same or mode >= 6 printdiff = True data.append((iptn, ptn, file, printdiff, old, new)) return data def kludge(mode): basedata = copydiff(mode) iptn_group_data = [] data = sorted(basedata, key=operator.itemgetter(0)) for k, g in itertools.groupby(basedata, operator.itemgetter(0)): iptn_group_data.append(list(g)) # Store group iterator as a list data_iptn_licenses = [] for iptn_group in iptn_group_data: licenses_group_data = [] iptn_group = sorted(iptn_group, key=operator.itemgetter(4, 5)) for k, g in itertools.groupby(iptn_group, operator.itemgetter(4, 5)): licenses_group_data.append(list(g)) # Store group iterator as a list data_iptn_licenses.append(licenses_group_data) print('=== debian/copyright checked for {} data ==='.format(len(basedata))) outdata = [] for match_iptn in data_iptn_licenses: for match_licenses in match_iptn: files = [] for match_iptn_licenses in match_licenses: (iptn, ptn, file, printdiff, old, new) = match_iptn_licenses if printdiff: files.append(file) if files: outdata.append((iptn, ptn, files, printdiff, old, new)) for outx in outdata: (iptn, ptn, files, printdiff, old, new) = outx print('Pattern #{:02}: {}'.format(iptn, ptn)) print(' File: {}'.format('\n '.join(files))) print('- {}'.format(old)) print('+ {}'.format(new)) print() ############################################################################## if __name__ == '__main__': kludge(1) debmake-4.1.7/debmake/para.py0000775000175000017500000003010012416763277016310 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import argparse import os import pwd import sys import time import debmake.read ########################################################################### # undefined environment variable -> '' def env(var): try: return os.environ[var] except KeyError: return '' ####################################################################### # Initialize parameters ####################################################################### def para(para): debmail = env('DEBEMAIL') if not debmail: debmail = os.getlogin() + '@localhost' debfullname = env('DEBFULLNAME') if not debfullname: debfullname = pwd.getpwnam(os.getlogin())[4].split(',')[0] ####################################################################### # command line setting ####################################################################### p = argparse.ArgumentParser( formatter_class=argparse.RawDescriptionHelpFormatter, description = '''\ {0}: make Debian source package Version: {1} {2} {0} helps to build the Debian package from the upstream source. Normally, this is done as follows: * The upstream tarball is downloaded as the package-version.tar.gz file. * It is untared to create many files under the package-version/ directory. * {0} is invoked in the package-version/ directory possibly without any arguments. * Files in the package-version/debian/ directory are manually adjusted. * dpkg-buildpackage (usually from its wrapper debuild or pdebuild) is invoked in the package-version/ directory to make debian packages. Argument may need to be quoted to protect from the shell. '''.format( para['program_name'], para['program_version'], para['program_copyright']), epilog='See debmake(1) manpage for more.') ck = p.add_mutually_exclusive_group() ck.add_argument( '-c', '--copyright', action = 'count', default = 0, help = 'scan source for copyright+license text and exit') ck.add_argument( '-k', '--kludge', action = 'count', default = 0, help = 'compare debian/copyright with the source and exit') sp = p.add_mutually_exclusive_group() sp.add_argument( '-n', '--native', action = 'store_true', default = False, help = 'make a native source package without .orig.tar.gz') sp.add_argument( '-a', '--archive', type = str, action = 'store', default = '', help = 'use the upstream source tarball directly (-p, -u, -z: overridden)', metavar = 'package-version.tar.gz') sp.add_argument( '-d', '--dist', action = 'store_true', default = False, help = 'run "make dist" equivalent first to generate upstream tarball and use it') sp.add_argument( '-t', '--tar', action = 'store_true', default = False, help = 'run "tar" to generate upstream tarball and use it') p.add_argument( '-p', '--package', action = 'store', default = '', help = 'set the Debian package name', metavar = 'package') p.add_argument( '-u', '--upstreamversion', action = 'store', default = '', help = 'set the upstream package version', metavar = 'version') p.add_argument( '-r', '--revision', action = 'store', default = '', help = 'set the Debian package revision', metavar = 'revision') p.add_argument( '-z', '--targz', action = 'store', default = '', help = 'set the tarball type, extension=(tar.gz|tar.bz2|tar.xz)', metavar = 'extension') p.add_argument( '-b', '--binaryspec', action = 'store', default = '', help = 'set binary package specs as comma separated list of "binarypackage":"type" pairs, e.g., in full form "foo:bin,foo-doc:doc,libfoo1:lib,libfoo1-dbg:dbg,libfoo-dev:dev" or in short form ",-doc,libfoo1,libfoo1-dbg, libfoo-dev". Here, "binarypackage" is the binary package name; and optional "type" is chosen from "bin", "data", "dbg", "dev", "doc", "lib", "perl", "python", "python3", "ruby", and "script". If "type" is not specified but obvious, it is set by "binarypackage". Otherwise it is set to "bin" for the compiled ELF binary.', metavar = 'binarypackage[:type]') p.add_argument( '-e', '--email', action = 'store', default = debmail, help = 'set e-mail address', metavar = 'foo@example.org') p.add_argument( '-f', '--fullname', action = 'store', default = debfullname, help = 'set the fullname', metavar = '"firstname lastname"') # p.add_argument( # '-g', # '--gui', # action = 'store_true', # default = False, # help = 'run GUI configuration') # # -h : used by argparse for --help ep = p.add_mutually_exclusive_group() ep.add_argument( '-i', '--invoke', default = '', action = 'store', help = 'invoke package build tool', metavar = '[debuild|pdebuild|...]') ep.add_argument( '-j', '--judge', action = 'store_true', default = False, help = 'run "dpkg-depcheck" to judge build dependencies and identify file paths') p.add_argument( '-l', '--license', default = '', action = 'store', help = 'add formatted license to debian/copyright', metavar = '"license_file"') p.add_argument( '-m', '--monoarch', action = 'store_true', default = False, help = 'force packages to be non-multiarch') p.add_argument( '-o', '--option', default = '', action = 'store', help = 'read optional parameters from "file"', metavar = '"file"') p.add_argument( '-q', '--quitearly', action = 'store_true', default = False, help='quit early before creating files in the debian directory') p.add_argument( '-s', '--spec', action = 'store_true', default = False, help = 'use upstream spec') p.add_argument( '-v', '--version', action = 'store_true', default = False, help = 'show version information') p.add_argument( '-w', '--with', action = 'store', default = '', dest = 'withargs', help = 'set additional "dh --with" option arguments', metavar = 'args') p.add_argument( '-x', '--extra', default = '', action = 'store', help = 'generate extra configuration files as templates', metavar = '[01234]') p.add_argument( '-y', '--yes', action = 'count', default = 0, help = 'force "yes" for all prompts') p.add_argument( '-Q', '--quiet', action = 'store_true', default = False, help='quiet tutorial comment lines marked with ### in template files') args = p.parse_args() ####################################################################### # Set parameter values ####################################################################### ############################################# -a if args.archive: para['archive'] = True para['tarball'] = args.archive else: para['archive'] = False para['tarball'] = '' ############################################# para['binaryspec'] = args.binaryspec # -b para['copyright'] = min(args.copyright, 6) # -c if para['copyright'] >=4: para['copyright'] = 3 - para['copyright'] # 0: debian/copyright, +/-1: simple, +/-2: standard +/-3: extensive para['dist'] = args.dist # -d para['email'] = args.email # -e para['fullname'] = args.fullname # -f # para['gui'] = args.gui # -g para['invoke'] = args.invoke # -i para['judge'] = args.judge # -j if para['judge']: para['override'].update({'judge'}) para['kludge'] = args.kludge # -k ############################################# -l # --license: args.license -> para['license'] as set if args.license == '': para['license'] = set({'[Cc][Oo][Pp][Yy][Ii][Nn][Gg]*', '[Ll][Ii][Cc][Ee][Nn][Ss][Ee]*'}) # default else: para['license'] = set(args.copyright.split(',')) ############################################# para['monoarch'] = args.monoarch # -m para['native'] = args.native # -n para['package'] = args.package.lower() # -p ############################################# para['quitearly'] = args.quitearly # -q para['revision'] = args.revision # -r para['spec'] = args.spec # -s para['tar'] = args.tar # -t para['version'] = args.upstreamversion # -u para['print_version'] = args.version # -v ############################################# -w # --with: args.withargs -> para['dh_with'] as set if args.withargs == '': para['dh_with'] = set() # default is empty set else: para['dh_with'] = set(args.withargs.split(',')) ############################################# para['extra'] = args.extra # -x para['yes'] = min(args.yes, 2) # -y # 0: ask, 1: yes, 2: no para['targz'] = args.targz # -z para['quiet'] = args.quiet # -Q ############################################# -o if args.option: exec(debmake.read.read(args.option)) ####################################################################### # return command line parameters ####################################################################### return para ####################################################################### # Test code ####################################################################### if __name__ == '__main__': for p, v in para().items(): print("para['{}'] = \"{}\"".format(p,v)) debmake-4.1.7/debmake/grep.py0000775000175000017500000000457712416763277016345 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import os import re import sys ####################################################################### # grep rtext file def grep(file, rtext, *range): lines = '' if not os.path.isfile(file): print('I: skipping :: {} (missing file)'.format(file), file=sys.stderr) else: reg = re.compile(rtext) if len(range) == 0: lbgn = 0 lend = -1 elif len(range) == 1: lbgn = range[0] lend = -1 else: lbgn = range[0] lend = range[1] with open(file, 'r') as f: for (i, l) in enumerate(f.readlines()): if ( i >= lbgn ) and (( lend < 0 ) or ( lend > i)): match = reg.search(l) if match: lines += l return lines ####################################################################### # Test script ####################################################################### if __name__ == '__main__': print(grep('/bin/zcat', r'^#!', 0, 2), end='') print('----') print(grep('/bin/zcat', r'terms', 0, 10), end='') print('----') if grep('/bin/zcat', r'terms', 0, 10): print('found') print('----') if not grep('/bin/zcat', r'teXXXXs', 0, 10): print('not found') debmake-4.1.7/debmake/read.py0000775000175000017500000000317712416763277016316 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ ####################################################################### def read(file): ################################################################### # file: path to the file ################################################################### with open(file, 'r') as f: text = f.read() return text ####################################################################### # Test script ####################################################################### if __name__ == '__main__': print(read('read.py')) debmake-4.1.7/debmake/control.py0000775000175000017500000002002112416763277017046 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import re import debmake.read ####################################################################### def control(para): ndebs = len(para['debs']) types = set() for deb in para['debs']: types.add(deb['type']) ntypes = len(types) # msg = control_src(para) if para['desc'].strip(): desc = para['desc'].strip() else: desc = 'auto-generated package by debmake' # if para['desc_long'].rstrip(): desc_long = para['desc_long'].rstrip() elif para['desc'].strip(): desc_long = ' ' + para['desc'].strip() else: desc_long = '' if desc_long: desc_long_xtra = '' else: desc_long_xtra = debmake.read.read(para['base_path'] + '/share/debmake/extra0desc_long/_long').rstrip() for i, deb in enumerate(para['debs']): desc_long_type = debmake.read.read(para['base_path'] + '/share/debmake/extra0desc_long/' + deb['type']).rstrip() if ndebs == 1: # single binary deb['desc'] = desc elif ndebs == ntypes: # all uniq *type* -> no index deb['desc'] = desc + ': {}'.format(deb['type']) else: deb['desc'] = desc + ': {} #{}'.format(deb['type'], i) if ndebs == 1: # single binary if desc_long: deb['desc_long'] = desc_long + '\n' else: deb['desc_long'] = desc_long_xtra + '\n' elif ndebs == ntypes: # all uniq *type* -> no index if i == 0: if desc_long: deb['desc_long'] = desc_long_type + '\n .\n' + desc_long + '\n' else: deb['desc_long'] = desc_long_type + '\n .\n' + desc_long_xtra + '\n' else: if desc_long: deb['desc_long'] = desc_long_type + '\n .\n' + desc_long + '\n' else: deb['desc_long'] = desc_long_type + '\n' else: if i == 0: if desc_long: deb['desc_long'] = desc_long_type + ': #{}\n .\n'.format(i) + desc_long + '\n' else: deb['desc_long'] = desc_long_type + ': #{}\n .\n'.format(i) + desc_long_xtra + '\n' else: if desc_long: deb['desc_long'] = desc_long_type + ': #{}\n .\n'.format(i) + desc_long + '\n' else: deb['desc_long'] = desc_long_type + ': #{}\n'.format(i) msg += control_bin(para, deb) return msg ####################################################################### def control_src(para): msg = '''\ Source: {0} Section: {1} Priority: {2} Maintainer: {3} <{4}> Build-Depends: {5} Standards-Version: {6} Homepage: {7} {8}: {9} {10}: {11} '''.format( para['package'], para['section'], para['priority'], para['fullname'], para['email'], ',\n\t'.join(para['build_depends']), para['standard_version'], para['homepage'], guess_vcsvcs(para['vcsvcs']), para['vcsvcs'], guess_vcsbrowser(para['vcsbrowser']), para['vcsbrowser']) if 'python2' in para['dh_with']: msg += 'X-Python-Version: >= 2.6\n' if 'python3' in para['dh_with']: msg += 'X-Python3-Version: >= 3.2\n' # anything for perl and others XXX FIXME XXX msg += '\n' return msg ####################################################################### def guess_vcsvcs(vcsvcs): if re.search('\.git$', vcsvcs): return '#Vcs-Git' elif re.search('\.hg$', vcsvcs): return '#Vcs-Hg' elif re.search('^:pserver:', vcsvcs): # CVS :pserver:anonymous@anonscm.debian.org:/cvs/webwml return '#Vcs-Cvs' elif re.search('^:ext:', vcsvcs): # CVS :ext:username@cvs.debian.org:/cvs/webwml return '#Vcs-Cvs' elif re.search('^svn[:+]', vcsvcs): # SVN svn://svn.debian.org/ddp/manuals/trunk manuals # SVN svn+ssh://svn.debian.org/svn/ddp/manuals/trunk return '#Vcs-Svn' else: return '#Vcs-Git' ####################################################################### def guess_vcsbrowser(vcsbrowser): if re.search('\.git$', vcsbrowser): return '#Vcs-Browser' elif re.search('\.hg$', vcsbrowser): return '#Vcs-Browser' elif re.search('^:pserver:', vcsbrowser): # CVS :pserver:anonymous@anonscm.debian.org:/cvs/webwml return '#Vcs-Browser' elif re.search('^:ext:', vcsbrowser): # CVS :ext:username@cvs.debian.org:/cvs/webwml return '#Vcs-Browser' elif re.search('^svn[:+]', vcsbrowser): # SVN svn://svn.debian.org/ddp/manuals/trunk manuals # SVN svn+ssh://svn.debian.org/svn/ddp/manuals/trunk return '#Vcs-Browser' else: return '#Vcs-Browser' ####################################################################### def control_bin(para, deb): # non M-A if para['monoarch']: multiarch = '' predepends = '' # M-A + lib (pre-depends line) elif deb['pre-depends']: multiarch = 'Multi-Arch: ' + deb['multiarch'] + '\n' predepends = 'Pre-Depends: ' + ',\n\t'.join(deb['pre-depends']) + '\n' # M-A + non-lib else: multiarch = 'Multi-Arch: ' + deb['multiarch'] + '\n' predepends = '' if deb['type'] == 'dbg': section = 'Section: debug\n' elif deb['type'] == 'dev': section = 'Section: libdevel\n' elif deb['type'] == 'lib': section = 'Section: libs\n' elif deb['type'] == 'doc': section = 'Section: doc\n' else: section = '' ################################################################### return '''\ Package: {0} {1}Architecture: {2} {3}{4}Depends: {5} Description: {6} {7} '''.format( deb['package'], section, deb['arch'], multiarch, predepends, ',\n\t'.join(deb['depends']), deb['desc'], deb['desc_long']) ####################################################################### # Test script ####################################################################### if __name__ == '__main__': import debmake.debs para = {} para['package'] = 'package' para['section'] = 'misc' para['priority'] = 'normal' para['fullname'] = 'Osamu Aoki' para['email'] = 'osamu@debian.org' para['standard_version'] = '4.0.2' para['build_depends'] = set() para['homepage'] = 'http://www.debian.org' para['vcsvcs'] = 'git:git.debian.org' para['vcsbrowser'] = 'http://anonscm.debian.org' para['debs'] = set() para['dh_with'] = set() print(control(para)) print('***********************************************************') para['dh_with'] = set({'python3'}) para['binaryspec'] = '-:python,-doc:doc,lib' para['monoarch'] = False para['debs'] = debmake.debs.debs(para['binaryspec'], para['package'], para['monoarch'], para['dh_with']) print(control(para)) debmake-4.1.7/debmake/yn.py0000775000175000017500000000444012416763277016023 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import os import subprocess import sys ########################################################################### # yn: ask mes and execute command ########################################################################### def yn(mes, command, yes): if yes == 1: yn = 'y' elif yes == 2: yn = 'n' else: yn = input('?: {} [Y/n]: '.format(mes)) if yn == '': yn = 'y' else: yn = yn[0].lower() if (yn =='y'): if command: print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: failed to run command.', file=sys.stderr) exit(1) else: print('E: terminating since "n" chosen at Y/n question.', file=sys.stderr) exit(1) print('I: pwd = "{}"'.format(os.getcwd()), file=sys.stderr) return if __name__ == '__main__': print('I: ask', file=sys.stderr) yn("list current directory (ask)", "ls -la", 0) print('I: always yes', file=sys.stderr) yn("list current directory (always yes)", "ls -la", 1) print('I: never yes', file=sys.stderr) yn("list current directory (never yes)", "ls -la", 2) debmake-4.1.7/debmake/compat.py0000775000175000017500000000341512416763277016661 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import os ####################################################################### def compat(paracompat): ################################################################### # file: path to the file ################################################################### if os.path.isfile('debian/compat'): with open('debian/compat', 'r') as f: number = int(f.read().strip()) else: number = int(paracompat.strip()) return number ####################################################################### # Test script ####################################################################### if __name__ == '__main__': print(compat('99')) debmake-4.1.7/debmake/dist.py0000775000175000017500000001671512416763277016350 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import glob import os import re import subprocess import sys ########################################################################### # dist: called from debmake.main() ########################################################################### def dist(para): print('I: pwd = "{}"'.format(os.getcwd()), file=sys.stderr) ####################################################################### # make distribution tarball using the Autotools ####################################################################### if os.path.isfile('configure.ac') and os.path.isfile('Makefile.am'): command = 'autoreconf -ivf && ./configure --prefix "/usr" && make distcheck' print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: autotools failed.', file=sys.stderr) exit(1) distdir = '.' ####################################################################### # make distribution tarball using setup.py ####################################################################### elif os.path.isfile('setup.py'): # Python distutils with open('setup.py', 'r') as f: line = f.readline() if re.search('python3', line): # http://docs.python.org/3/distutils/ command = 'python3 setup.py sdist' else: # http://docs.python.org/2/distutils/ command = 'python setup.py sdist' print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: setup.py failed.', file=sys.stderr) exit(1) distdir = 'dist' ####################################################################### # make distribution tarball using Build.PL ####################################################################### elif os.path.isfile('Build.PL'): # perl Build.PL command = 'perl Build.PL && ./Build distcheck && ./Build disttest && ./Build dist' print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: perl Build.PL failed.', file=sys.stderr) exit(1) distdir = '.' ####################################################################### # make distribution tarball using Makefile.PL ####################################################################### elif os.path.isfile('Makefile.PL'): # perl Makefile.PL command = 'perl Makefile.PL && make dist' print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: perl Makefile.PL failed.', file=sys.stderr) exit(1) distdir = '.' ####################################################################### # make distribution tarball for other sources ####################################################################### else: if os.path.isfile('CMakeLists.txt'): # CMake source tree print('E: CMake. Use --tar (-t).', file=sys.stderr) exit(1) else: # Non standard source tree print('E: unsupported for --dist (-d). Use --tar (-t).', file=sys.stderr) exit(1) ####################################################################### # set version by the tarball name ####################################################################### somepackage1 = distdir + '/*.tar.xz' somepackage2 = distdir + '/*.tar.gz' somepackage3 = distdir + '/*.tar.bz2' files = glob.glob(somepackage1) + glob.glob(somepackage2) + glob.glob(somepackage3) if files: for file in files: print('I: -> {} created'.format(file), file=sys.stderr) para['tarball'] = files[0][len(distdir)+1:] print('I: {} picked for packaging'.format(para['tarball']), file=sys.stderr) matchtar = re.match(r'(?P[^_]*)[-_](?P[^-_]*)\.(?Ptar\..{2,3})$', para['tarball']) if matchtar: if para['package'] == "": para['package'] = matchtar.group('package').lower() if para['version'] =='': para['version'] = matchtar.group('version') elif para['version'] != matchtar.group('version'): print('E: generated tarball version "{}".'.format(matchtar.group('version')), file=sys.stderr) print('E: expected version "{}" (from -u option or debian/changelog).'.format(para['version']), file=sys.stderr) print('E: update version number in places such as AC_INIT of configure.ac.', file=sys.stderr) exit(1) if para['targz'] =='': para['targz'] = matchtar.group('targz') elif para['targz'] != matchtar.group('targz'): print('W: override -z "{}" by actual value "{}".'.format(para['targz'], matchtar.group('targz')), file=sys.stderr) para['targz'] = matchtar.group('targz') else: print('W: {} can not be split into package-version.tar.gz style.'.format(para['tarball']), file=sys.stderr) else: print('E: {} can not be found.'.format(distpackage), file=sys.stderr) print('E: not even likely tarball found', file=sys.stderr) exit(1) ####################################################################### # copy tar to the parent directory (out of source tree) ####################################################################### # cd .. os.chdir('..') print('I: pwd = "{}"'.format(os.getcwd()), file=sys.stderr) # cp -f parent/dist/foo-1.0.tar.gz foo-1.0.tar.gz command = 'cp -f ' + para['parent'] + '/' + distdir + '/' + para['tarball'] + ' ' + para['tarball'] print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: failed to copy', file=sys.stderr) exit(1) para['srcdir'] = para['package'] + '-' + para['version'] if para['srcdir'] == para['parent']: # avoid erasing VCS in untar process. print('E: the parent directory should be like {} (never {}).'.format(para['package'], para['srcdir']), file=sys.stderr) print('E: terminate to protect the VCS data possibly in the original directory.', file=sys.stderr) exit(1) return para if __name__ == '__main__': print('No test program') debmake-4.1.7/debmake/debian.py0000775000175000017500000002550412416763277016623 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import glob import os import subprocess import sys import debmake.cat import debmake.control import debmake.copyright import debmake.sed ####################################################################### def debian(para): ################################################################### # set level for the extra file outputs ################################################################### if para['extra'] == '': # default if os.path.isfile('debian/changelog'): print('I: found "debian/changelog"', file=sys.stderr) para['extra'] = '0' elif os.path.isfile('debian/control'): print('I: found "debian/control"', file=sys.stderr) para['extra'] = '0' elif os.path.isfile('debian/copyright'): print('I: found "debian/copyright"', file=sys.stderr) para['extra'] = '0' elif os.path.isfile('debian/rules'): print('I: found "debian/rules"', file=sys.stderr) para['extra'] = '0' elif len(para['debs']) == 1: print('I: single binary package', file=sys.stderr) para['extra'] = '1' else: print('I: multi binary packages: {}'.format(len(para['debs'])), file=sys.stderr) para['extra'] = '2' try: extra = int(para['extra']) except: extra = 4 print('I: debmake -x "{}" ...'.format(extra), file=sys.stderr) ################################################################### # common variables ################################################################### package = para['debs'][0]['package'] # the first binary package name substlist = { '@PACKAGE@': para['package'], '@UCPACKAGE@': para['package'].upper(), '@YEAR@': para['year'], '@FULLNAME@': para['fullname'], '@EMAIL@': para['email'], '@SHORTDATE@': para['shortdate'], '@DATE@': para['date'], '@DEBMAKEVER@': para['program_version'], '@BINPACKAGE@': package, '@COMPAT@': para['compat'], } if para['native']: substlist['@PKGFORMAT@'] = '3.0 (native)' substlist['@VERREV@'] = para['version'] else: substlist['@PKGFORMAT@'] = '3.0 (quilt)' substlist['@VERREV@'] = para['version'] + '-' + para['revision'] ################################################################### # check which package have the documentation ################################################################### if para['doc'] == []: docpackage = para['debs'][0]['package'] # 1st package else: docpackage = '' ####################################################################### # set export string ####################################################################### export_dir = para['base_path'] + '/share/debmake/extra0export/' substlist['@EXPORT@'] = '' if 'compiler' in para['export']: substlist['@EXPORT@'] += debmake.read.read(export_dir + 'compiler').rstrip() + '\n\n' if 'java' in para['export']: substlist['@EXPORT@'] += debmake.read.read(export_dir + 'java').rstrip() + '\n\n' if 'vala' in para['export']: substlist['@EXPORT@'] += debmake.read.read(export_dir + 'vala').rstrip() + '\n\n' ####################################################################### # set override string ####################################################################### override_dir = para['base_path'] + '/share/debmake/extra0override/' substlist['@OVERRIDE@'] = '' if len(para['debs']) == 1: build_dir = 'debian/' + para['debs'][0]['package'] else: build_dir = 'debian/tmp' if 'autogen' in para['override']: substlist['@OVERRIDE@'] += debmake.read.read(override_dir + 'autogen').rstrip() + '\n\n' if 'autoreconf' in para['override']: substlist['@OVERRIDE@'] += debmake.read.read(override_dir + 'autoreconf').rstrip() + '\n\n' if 'dbg' in para['override']: substlist['@OVERRIDE@'] += debmake.read.read(override_dir + 'dbg').format(para['dh_strip']).rstrip() + '\n\n' if 'java' in para['override']: substlist['@OVERRIDE@'] += debmake.read.read(override_dir + 'java').rstrip() + '\n\n' if 'judge' in para['override']: substlist['@OVERRIDE@'] += debmake.read.read(override_dir + 'judge').rstrip() + '\n\n' if 'multiarch' in para['override']: substlist['@OVERRIDE@'] += debmake.read.read(override_dir + 'multiarch').rstrip() + '\n\n' if 'pythons' in para['override']: substlist['@OVERRIDE@'] += debmake.read.read(override_dir + 'pythons').rstrip() + '\n\n' ################################################################### # 4 configuration files which must exist (level=0) ################################################################### debmake.cat.cat('debian/control', debmake.control.control(para), quiet=para['quiet']) debmake.cat.cat('debian/copyright', debmake.copyright.copyright(para['package'], para['license'], para['cdata'], para['xml_html_files'], para['binary_files'], para['huge_files']), quiet=para['quiet']) if para['dh_with'] == set(): # no dh_with substlist['@DHWITH@'] = '' else: substlist['@DHWITH@'] = '--with {}'.format(','.join(para['dh_with'])) if para['dh_buildsystem'] == '': # no --buildsystem substlist['@DHBUILDSYSTEM@'] = '' else: substlist['@DHBUILDSYSTEM@'] = '--buildsystem={}'.format(para['dh_buildsystem']) confdir = para['base_path'] + '/share/debmake/extra0/' debmake.sed.sed(confdir, 'debian/', substlist, package, quiet=para['quiet']) # changelog, rules os.chmod('debian/rules', 0o755) ################################################################### # These should be created for the new source (level=1) # Basic configuration files for debhelper(7) etc. # No interactive editting required to work. ################################################################### if extra >= 1: confdir = para['base_path'] + '/share/debmake/extra1/' debmake.sed.sed(confdir, 'debian/', substlist, package, quiet=para['quiet']) confdir = para['base_path'] + '/share/debmake/extra1source/' debmake.sed.sed(confdir, 'debian/source/', substlist, package, quiet=para['quiet']) if not para['native']: confdir = para['base_path'] + '/share/debmake/extra1patches/' debmake.sed.sed(confdir, 'debian/patches/', substlist, package, quiet=para['quiet']) ################################################################### # Optional files which is nice to be created for the new source (level=2) # Harmless but some interactive editting are desirable. # * create templates only for the first binary package: # package.menu, package.docs, package.examples, package.manpages, # package.preinst, package.prerm, package.postinst, package.postrm # * create for all but dbg binary packages: package.install # * create for lib package: package.symbol ################################################################### binlist = {'bin', 'perl', 'python', 'python3', 'ruby', 'script'} if extra >= 2: if len(para['debs']) == 1: # if single binary deb confdir = para['base_path'] + '/share/debmake/extra2single/' debmake.sed.sed(confdir, 'debian/', substlist, package, quiet=para['quiet']) else: # if multi-binary debs confdir = para['base_path'] + '/share/debmake/extra2multi/' debmake.sed.sed(confdir, 'debian/', substlist, package, quiet=para['quiet']) for deb in para['debs']: substlist['@BINPACKAGE@'] = deb['package'] type = deb['type'] if type in binlist: type = 'bin' confdir = para['base_path'] + '/share/debmake/extra2' + type + '/' debmake.sed.sed(confdir, 'debian/', substlist, deb['package'], quiet=para['quiet']) if deb['package'] == docpackage: type = 'doc' confdir = para['base_path'] + '/share/debmake/extra2' + type + '/' debmake.sed.sed(confdir, 'debian/', substlist, deb['package'], quiet=para['quiet']) ################################################################### # Rarely used optional files (level=3) # Provided as the dh_make compatibilities. (files with ".ex" postfix) # (create templates only for the first binary package) ################################################################### substlist['@BINPACKAGE@'] = package # just in case if extra >= 3: confdir = para['base_path'] + '/share/debmake/extra3/' debmake.sed.sed(confdir, 'debian/', substlist, package, quiet=para['quiet']) ################################################################### # copyright file examples (level=4) ################################################################### if extra >= 4: confdir = para['base_path'] + '/share/debmake/extra4/' debmake.sed.sed(confdir, 'debian/license-examples/', substlist, package, quiet=para['quiet']) else: print('I: run "debmake -x{}" to get more template files'.format(extra + 1), file=sys.stderr) ################################################################### # wrap-and-sort ################################################################### command = 'wrap-and-sort' print('I: $ {}'.format(command), file=sys.stderr) if subprocess.call(command, shell=True) != 0: print('E: failed to run wrap-and-sort.', file=sys.stderr) exit(1) return ####################################################################### # Test script ####################################################################### if __name__ == '__main__': print('no test') debmake-4.1.7/debmake/analyze.py0000775000175000017500000005056312416763277017047 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import glob import os import re import sys import subprocess import debmake.grep import debmake.read import debmake.compat import debmake.copyright import debmake.scanfiles import debmake.yn ########################################################################### # get master name (remove -dev -dbg) ########################################################################### # re.sub: drop "-dev" re_dev = re.compile(r'''(-dev$)''') def masterdev(name): if re_dev.search(name): name = re_dev.sub('',name) else: print('E: development package "{}" does not end with "-dev"'.format(name), file=sys.stderr) exit(1) return name # re.sub: drop "-dbg" re_dbg = re.compile(r'''(-dbg$)''') def masterdbg(name): if re_dbg.search(name): name = re_dbg.sub('',name) else: print('E: debug package "{}" does not end with "-dbg"'.format(name), file=sys.stderr) exit(1) return name ########################################################################### # popular: warn binary dependency etc. if they are top 3 popular files ########################################################################### def popular(exttype, msg, debs, extcountlist, yes): n = 3 # check files with the top 3 popular extension types if exttype in dict(extcountlist[0:n]).keys(): settype = False for deb in debs: type = deb['type'] # -b (python3 also reports python) if type == exttype: settype = True break if exttype == 'python' and type == 'python3': settype = True break if not settype: print('W: many ext = "{}" type extension programs without matching -b set.'.format(exttype, type), file=sys.stderr) debmake.yn.yn(msg, '', yes) return ########################################################################### # description: read from the upstream packaging system ########################################################################### def description(type, base_path): text = '' command = base_path + '/lib/debmake/' + type + '.short' p = subprocess.Popen(command, shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT) for line in p.stdout.readlines(): text += line.decode('utf-8').strip() + ' ' if p.wait() != 0: print('E: "{}" returns "{}"'.format(command, p.returncode), file=sys.stderr) exit(1) return text.strip() ########################################################################### # description_long: read from the upstream packaging system ########################################################################### def description_long(type, base_path): text = '' command = base_path + '/lib/debmake/' + type + '.long' p = subprocess.Popen(command, shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT) for line in p.stdout.readlines(): l = line.decode('utf-8').rstrip() if l: text += ' ' + l + '\n' else: text += ' .\n' if p.wait() != 0: print('E: "{}" returns "{}"'.format(command, p.returncode), file=sys.stderr) exit(1) if text == ' .\n': text = '' return text ########################################################################### # analyze: called from debmake.main() ########################################################################### def analyze(para): ################################################################### # package list by types (first pass) ################################################################### para['bin'] = [] para['lib'] = [] para['dev'] = [] para['dbg'] = [] para['data'] = [] para['doc'] = [] para['scripts'] = [] for i, deb in enumerate(para['debs']): if deb['type'] == 'bin': para['bin'].append(deb['package']) elif deb['type'] == 'lib': para['lib'].append(deb['package']) elif deb['type'] == 'dev': para['dev'].append(deb['package']) elif deb['type'] == 'dbg': para['dbg'].append(deb['package']) elif deb['type'] == 'doc': para['doc'].append(deb['package']) elif deb['type'] == 'data': para['data'].append(deb['package']) else: para['scripts'].append(deb['package']) if len(para['debs']) != 1 and len(para['dev']) != len(para['lib']): print('E: # of "dev":{} != # of "lib": {}.'.format(len(para['dev']), len(para['lib'])), file=sys.stderr) exit(1) if len(para['dbg']) != 0 and len(para['dbg']) != (len(para['bin']) + len(para['lib'])): print('E: # of "dbg":{} != # of "bin+lib": {}.'.format(len(para['dev']), len(para['bin']) + len(para['lib'])), file=sys.stderr) exit(1) if para['lib'] != []: setmultiarch = True elif para['bin'] != [] and len(para['debs']) == 1: setmultiarch = True else: setmultiarch = False # for override if para['monoarch']: setmultiarch = False ################################################################### # package list by types (second pass) ################################################################### para['dh_strip'] = '' for i, deb in enumerate(para['debs']): if deb['type'] == 'bin': para['export'].update({'compiler'}) for libpkg in para['lib']: para['debs'][i]['depends'].update({libpkg + ' (= ${binary:Version})'}) elif deb['type'] == 'lib': para['export'].update({'compiler'}) elif deb['type'] == 'dev': pkg = masterdev(deb['package']) match = False for libpkg in para['lib']: if libpkg[:len(pkg)] == pkg: para['debs'][i]['depends'].update({libpkg + ' (= ${binary:Version})'}) match = True break if not match: print('E: {} does not have matching library in "{}".'.format(deb['package'], ', '.join(para['lib'])), file=sys.stderr) exit(1) elif deb['type'] == 'dbg': para['override'].update({'dbg'}) pkg = masterdbg(deb['package']) pkgs = para['bin'] + para['lib'] if pkg in pkgs: para['debs'][i]['depends'].update({pkg + ' (= ${binary:Version})'}) else: print('E: {} does not match package in "{}".'.format(deb['package'], ', '.join(para['bin'] + para['lib'])), file=sys.stderr) exit(1) pkgs.remove(pkg) if pkgs == []: para['dh_strip'] += '\tdh_strip --dbg-package={}\n'.format(deb['package']) else: para['dh_strip'] += '\tdh_strip -X{} --dbg-package={}\n'.format(' -X'.join(pkgs), deb['package']) elif deb['type'] == 'perl': for libpkg in para['lib']: para['debs'][i]['depends'].update({libpkg + ' (>= ${source:Version})'}) elif deb['type'] == 'python': para['dh_with'].update({'python2'}) # better to be explicit para['build_depends'].update({'python-all'}) for libpkg in para['lib']: para['debs'][i]['depends'].update({libpkg + ' (>= ${source:Version}), ' + libpkg + ' (<< ${source:Upstream-Version}.0~)'}) elif deb['type'] == 'python3': para['dh_with'].update({'python3'}) para['build_depends'].update({'python3-all', 'dh-python'}) for libpkg in para['lib']: para['debs'][i]['depends'].update({libpkg + ' (>= ${source:Version}), ' + libpkg + ' (<< ${source:Upstream-Version}.0~)'}) elif deb['type'] == 'ruby': para['dh_with'].update({'ruby'}) # may not be needed para['build_depends'].update({'ruby'}) for libpkg in para['lib']: para['debs'][i]['depends'].update({libpkg + ' (>= ${source:Version}), ' + libpkg + ' (<< ${source:Upstream-Version}.0~)'}) elif deb['type'] == 'script': for libpkg in para['lib']: para['debs'][i]['depends'].update({libpkg + ' (>= ${source:Version}), ' + libpkg + ' (<< ${source:Upstream-Version}.0~)'}) else: pass ####################################################################### # auto-set build system by files in the base directory ####################################################################### para['build_type'] = '' # reset value para['dh_buildsystem'] = '' # normally not needed # check if '*.pro' for Qmake project exist in advance. pro = glob.glob('*.pro') if pro: pro = pro[0] else: pro = '' # check if '*.spec.in' for RPM specs = glob.glob('*.spec.in') if specs: spec = specs[0] else: spec = '' # GNU coding standard with autotools = autoconf+automake if os.path.isfile('configure.ac') and \ os.path.isfile('Makefile.am') and \ not ('autotools-dev' in para['dh_with']): para['dh_with'].update({'autoreconf'}) para['build_type'] = 'Autotools with autoreconf' para['build_depends'].update({'dh-autoreconf'}) if os.path.isfile('autogen.sh'): para['override'].update({'autogen'}) else: para['override'].update({'autoreconf'}) elif os.path.isfile('configure.in') and \ os.path.isfile('Makefile.am') and \ not ('autotools-dev' in para['dh_with']): para['dh_with'].update({'autoreconf'}) para['build_type'] = 'Autotools with autoreconf (old)' para['build_depends'].update({'dh-autoreconf'}) if os.path.isfile('autogen.sh'): para['override'].update({'autogen'}) else: para['override'].update({'autoreconf'}) print('W: Use of configure.in has been deprecated since 2001.', file=sys.stderr) elif os.path.isfile('configure.ac') and \ os.path.isfile('Makefile.am') and \ os.path.isfile('configure'): para['dh_with'].update({'autotools-dev'}) para['build_type'] = 'Autotools' para['build_depends'].update({'autotools-dev'}) elif os.path.isfile('configure.in') and \ os.path.isfile('Makefile.am') and \ os.path.isfile('configure'): para['dh_with'].update({'autotools-dev'}) para['build_type'] = 'Autotools (old)' para['build_depends'].update({'autotools-dev'}) print('W: Use of configure.in has been deprecated since 2001.', file=sys.stderr) elif 'autoreconf' in para['dh_with']: print('E: missing configure.ac or Makefile.am required for "dh $@ --with autoreconf".', file=sys.stderr) exit(1) elif 'autotools-dev' in para['dh_with']: print('E: missing configure.ac or Makefile.am or configure required for "dh $@ --with autotools-dev".', file=sys.stderr) exit(1) # GNU coding standard with configure elif os.path.isfile('configure'): para['build_type'] = 'configure' if setmultiarch: para['override'].update({'multiarch'}) # GNU coding standard with make elif os.path.isfile('Makefile'): para['build_type'] = 'make' if setmultiarch: para['override'].update({'multiarch'}) # GNU coding standard with Cmake elif os.path.isfile('CMakeLists.txt'): para['build_type'] = 'Cmake' para['build_depends'].update({'cmake'}) if setmultiarch: para['override'].update({'multiarch'}) # Python distutils elif os.path.isfile('setup.py'): if debmake.grep.grep('setup.py', 'python3', 0, 1): # http://docs.python.org/3/distutils/ para['dh_with'].update({'python3'}) if debmake.grep.grep('setup.py', r'from\s+setuptools\s+import\s+setup'): para['build_depends'].update({'python3-all', 'dh-python', 'python3-setuptools'}) elif debmake.grep.grep('setup.py', r'from\s+distutils.core\s+import\s+setup'): para['build_depends'].update({'python3-all', 'dh-python'}) else: print('W: neither distutils nor setuptools. check setup.py.', file=sys.stderr) para['build_depends'].update({'python3-all', 'dh-python'}) para['dh_buildsystem'] = 'pybuild' if 'python2' in para['dh_with']: para['build_depends'].update({'python-all'}) if para['spec']: if para['desc'] == '': para['desc'] = description('python3', para['base_path']) if para['desc_long'] =='': para['desc_long'] = description_long('python3', para['base_path']) elif debmake.grep.grep('setup.py', 'python', 0, 1): # http://docs.python.org/2/distutils/ para['dh_with'].update({'python2'}) para['build_type'] = 'Python distutils' if debmake.grep.grep('setup.py', r'from\s+setuptools\s+import\s+setup'): para['build_depends'].update({'python3-all', 'dh-python', 'python-setuptools'}) elif debmake.grep.grep('setup.py', r'from\s+distutils.core\s+import\s+setup'): para['build_depends'].update({'python3-all', 'dh-python'}) else: print('W: neither distutils nor setuptools. check setup.py.', file=sys.stderr) para['build_depends'].update({'python3-all', 'dh-python'}) if 'python3' in para['dh_with']: para['build_depends'].update({'python3-all', 'dh-python'}) para['dh_buildsystem'] = 'pybuild' if para['spec']: if para['desc'] == '': para['desc'] = description('python', para['base_path']) if para['desc_long'] =='': para['desc_long'] = description_long('python', para['base_path']) else: print('E: unknown python version. check setup.py.', file=sys.stderr) exit(1) # Perl elif os.path.isfile('Build.PL'): # Prefered over Makefile.PL after debhelper v8 para['build_type'] = 'Perl Module::Build' para['build_depends'].update({'perl'}) elif os.path.isfile('Makefile.PL'): para['build_type'] = 'Perl ExtUtils::MakeMaker' para['build_depends'].update({'perl'}) # Ruby elif os.path.isfile('setup.rb'): print('W: dh-make-ruby(1) (gem2deb package) may provide better packaging results.', file=sys.stderr) para['build_type'] = 'Ruby setup.rb' para['build_depends'].update({'ruby', 'gem2deb'}) # Java elif os.path.isfile('build.xml'): para['build_type'] = 'Java ant' para['dh_with'].update({'javahelper'}) # XXX FIXME XXX which compiler to use? para['build_depends'].update({'javahelper', 'gcj'}) para['export'].update({'java', 'compiler'}) para['override'].update({'java'}) if setmultiarch: para['override'].update({'multiarch'}) # Qmake elif os.path.isfile(pro): # XXX FIXME XXX Is this right? para['build_type'] = 'QMake' para['build_depends'].update({'qt4-qmake'}) if setmultiarch: para['override'].update({'multiarch'}) else: para['build_type'] = 'Unknown' if setmultiarch: para['override'].update({'multiarch'}) print('I: build_type = {}'.format(para['build_type']), file=sys.stderr) ####################################################################### # high priority spec source, first if para['spec']: if para['desc'] == '' and os.path.isfile('META.yml'): para['desc'] = description('META.yml', para['base_path']) if para['desc'] == '' and os.path.isfile('Rakefile'): para['desc'] = description('Rakefile', para['base_path']) if para['desc'] == '' and spec: para['desc'] = description('spec', para['base_path']) if para['desc_long'] =='' and spec: para['desc_long'] = description_long('spec', para['base_path']) ####################################################################### # analize copyright+license content + file extensions # copyright, control: build/binary dependency, rules export/override ####################################################################### print('I: scan source for copyright+license text and file extensions', file=sys.stderr) (para['nonlink_files'], para['xml_html_files'], para['binary_files'], para['huge_files'], para['extcount'], para['extcountlist']) \ = debmake.scanfiles.scanfiles() # skip slow license+copyright check if debian/copyright exists if os.path.isfile('debian/copyright'): para['cdata'] = [] else: para['cdata'] = debmake.copyright.check_copyright(para['nonlink_files'], mode=2) ####################################################################### # compiler: set build dependency etc. if they are used if 'c' in para['extcount'].keys(): para['export'].update({'compiler'}) if setmultiarch and para['build_type'][0:9] != 'Autotools': para['override'].update({'multiarch'}) if 'java' in para['extcount'].keys(): if para['build_type'][0:4] != 'Java': # Non-ant build system if para['build_type']: para['build_type'] = 'Java + ' + para['build_type'] else: para['build_type'] = 'Java' para['dh_with'].update({'javahelper'}) para['build_depends'].update({'javahelper', 'gcj'}) para['export'].update({'java', 'compiler'}) para['override'].update({'java'}) if setmultiarch and para['build_type'][0:9] != 'Autotools': para['override'].update({'multiarch'}) if para['build_type'][0:4] == 'Java': print('W: Java support is not perfect. (/usr/share/doc/javahelper/tutorials.html)', file=sys.stderr) if 'vala' in para['extcount'].keys(): para['build_type'] = 'Vala' para['build_depends'].update({'valac'}) para['export'].update({'vala', 'compiler'}) if setmultiarch and para['build_type'][0:9] != 'Autotools': para['override'].update({'multiarch'}) ####################################################################### # set build dependency and override if --with python2/python3 ####################################################################### if 'python2' in para['dh_with']: para['build_depends'].update({'python-all'}) para['override'].update({'pythons'}) if 'python3' in para['dh_with']: para['build_depends'].update({'python3-all', 'dh-python'}) para['override'].update({'pythons'}) ####################################################################### # interpreter: warn binary dependency etc. if they are top 3 popular files ####################################################################### popular('perl', '-b":perl, ..." missing. Continue?', para['debs'], para['extcountlist'], para['yes']) popular('python', '-b":python, ..." or -b":python3" missing. Continue?', para['debs'], para['extcountlist'], para['yes']) popular('ruby', '-b":ruby, ..." missing. Continue?', para['debs'], para['extcountlist'], para['yes']) ####################################################################### return para if __name__ == '__main__': print('no test') debmake-4.1.7/debmake/cat.py0000775000175000017500000000426212416763277016146 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import os import sys ####################################################################### # cat >file def cat(file, text, end='', quiet=False): if os.path.isfile(file) and os.stat(file).st_size != 0: # skip if a file exists and non-zero content print('I: skipping :: {} (file exists)'.format(file), file=sys.stderr) return if quiet: newtext = '' for line in text.split('\n'): if line[:3] != '###' or line[:4] == '####': newtext += line + '\n' text = newtext path = os.path.dirname(file) if path: os.makedirs(path, exist_ok=True) with open(file, 'w') as f: print(text, file=f, end=end) print('I: creating => {}'.format(file), file=sys.stderr) return ####################################################################### # Test script ####################################################################### if __name__ == '__main__': cat('testfile0.tmp', 'fooo\n###barrrr\n####CCCC\nbazzzzz', quiet=False) cat('testfile1.tmp', 'fooo\n###barrrr\n####CCCC\nbazzzzz', quiet=True) debmake-4.1.7/debmake/scanfiles.py0000775000175000017500000002021712416763277017344 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import collections import operator import os import re import sys ################################################################### # Define constants ################################################################### MAX_FILE_SIZE = 1024*1024 # 1 MiB SKIP_FILES = [ 'COPYING', 'LICENSE', 'ChangeLog', 'changelog', ] # Skip these files for scanning # 'INSTALL', # 'README', # 'README.txt', # 'README.Debian', # 'Makefile.in', # 'aclocal.m4', # 'compile', # 'config.guess', # 'config.h.in', # 'config.sub', # 'configure', # 'depcomp', # 'install-sh', # 'ltconfig', # 'ltmain.sh', # 'missing', # 'mkinstalldirs', # 'py-compile' # First 2 are specified by --license extequiv = {'pl': 'perl', 'PL': 'perl', 'pm': 'perl', 'py': 'python', 'pyc': 'python', 'rb': 'ruby', 'javac': 'java', 'js': 'javascript', 'ml': 'ocml', 'vala': 'vala', 'h' : 'c', 'cpp': 'c', 'CPP': 'c', 'cc': 'c', 'C': 'c', 'cxx': 'c', 'CXX': 'c', 'c++': 'c', 'hh': 'c', 'H': 'c', 'hxx': 'c', 'Hxx': 'c', 'HXX': 'c', 'hpp': 'c', 'h++': 'c', 'asm': 'c', 's': 'c', 'S': 'c', 'TXT': 'text', 'txt': 'text', 'doc': 'text', 'html': 'text', 'htm': 'text', 'xml': 'text', 'dbk': 'text', 'dtd': 'text', 'odt': 'text', 'sda': 'text', 'sdb': 'text', 'sdc': 'text', 'sdd': 'text', 'sds': 'text', 'sdw': 'text', 'a': 'binary', 'class': 'binary', 'jar': 'binary', 'exe': 'binary', 'com': 'binary', 'dll': 'binary', 'obj': 'binary', 'zip': 'archive', 'tar': 'archive', 'cpio': 'archive', 'afio': 'archive', 'jpeg': 'media', 'jpg': 'media', 'm4a': 'media', 'png': 'media', 'gif': 'media', 'GIF': 'media', 'svg': 'media', 'ico': 'media', 'mp3': 'media', 'ogg': 'media', 'wav': 'media', 'ttf': 'media', 'TTF': 'media', 'otf': 'media', 'OTF': 'media', 'wav': 'media' } ################################################################### # re.search file name extension re_ext = re.compile(r'\.(?P[^.]+)(?:\.in|\.gz|\.bz2|\.xz|\.Z\|.z|~)*$') ################################################################### # Check if binary file ################################################################### def typefile(file, blocksize=4048): buff = open(file, 'rb').read(blocksize) if b'<' == buff[:1]: return 2 # XML/SGML/HTML elif b'\x00' in buff: return 0 # Binary elif b'\xff\xff' in buff: return 0 # Binary else: return 1 # Text ################################################################### # Get all files to be analyzed under dir ################################################################### def get_all_files(): nonlink_files = [] binary_files = [] xml_html_files = [] huge_files = [] extensions = [] # extensions : representative code type # binary means possible non-DFSG component for dir, subdirs, files in os.walk("."): for file in files: # dir iterates over ./ ./foo ./foo/bar/ ./foo/bar/baz ... filepath = os.path.join(dir[2:], file) if os.path.islink(filepath): pass # skip symlink (both for file and dir) elif file in SKIP_FILES: pass # skip automatically generated files else: re_ext_match = re_ext.search(file) if re_ext_match: ext = re_ext_match.group('ext') if ext in extequiv.keys(): extrep = extequiv[ext] else: extrep = ext extensions.append(extrep) type_of_file = typefile(filepath) if type_of_file == 2: # XML/SGML/HTML xml_html_files.append(filepath) elif type_of_file == 0: # Binary binary_files.append(filepath) elif os.path.getsize(filepath) > MAX_FILE_SIZE: huge_files.append(filepath) else: # type_of_file == 1 Text nonlink_files.append(filepath) # do not decend to VCS dirs for vcs in ['CVS', '.svn', '.pc', '.git', '.hg', '.bzr']: if vcs in subdirs: subdirs.remove(vcs) # skip VCS # do not decend to symlink dirs symlinks = [] for subdir in subdirs: dirpath = os.path.join(dir, subdir) if os.path.islink(dirpath): symlinks.append(subdir) # do not change subdirs inside looping over subdirs for symlink in symlinks: subdirs.remove(symlink) # skip symlinks print('W: get_all_files(dir) skip symlink dir', file=sys.stderr) return (nonlink_files, xml_html_files, binary_files, huge_files, extensions) ####################################################################### # complete scanfiles ####################################################################### def scanfiles(): (nonlink_files, xml_html_files, binary_files, huge_files, extensions) = get_all_files() if len(extensions): delta = 100.0 / len(extensions) else: delta = 100.0 counter = collections.Counter(extensions) count_list = sorted(list(counter.items()), key=operator.itemgetter(1), \ reverse=True) for ext, count in count_list: if ext == 'binary' or ext == 'archive': print('W: {} type exists. Maybe non-DFSG!'.format(ext), file=sys.stderr) print('I: {1:3.0f} %, ext = {0}'.format(ext, count * delta), file=sys.stderr) return (nonlink_files, xml_html_files, binary_files, huge_files, counter, count_list) ####################################################################### # Test script ####################################################################### if __name__ == '__main__': (nonlink_files, xml_html_files, binary_files, huge_files, counter, count_list) = scanfiles() print('Number of nonlink_files: {}'.format(len(nonlink_files))) print('Number of xml_html_files: {}'.format(len(xml_html_files))) print('Number of binary_files: {}'.format(len(binary_files))) print('Number of huge_files: {}'.format(len(huge_files))) print('I: counts of file extensions', file=sys.stderr) for ext, count in count_list: print('{1} files for ext = {0}'.format(ext, count)) debmake-4.1.7/debmake/sed.py0000775000175000017500000000545412416763277016156 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import glob import os import sys import debmake.cat ####################################################################### def sed(confdir, destdir, substlist, package, mask='*', quiet=False): ################################################################### # confdir: configuration file directory with / at the end # destdir: destination directory with / at the end # substlist: substitution dictionary # package: binary package name # mask: source file mask for glob. Usually, * ################################################################### lconfdir = len(confdir) for file in glob.glob(confdir + mask): with open(file, 'r') as f: text = f.read() for k in substlist.keys(): text = text.replace(k, substlist[k]) if file[lconfdir:lconfdir+7] == 'package': newfile = destdir + package + file[lconfdir+7:] else: newfile = destdir + file[lconfdir:] debmake.cat.cat(newfile, text, quiet=quiet) return ####################################################################### # Test script ####################################################################### if __name__ == '__main__': quiet = False substlist = { '@BINPACKAGE@': 'binpackage', '@PACKAGE@': 'package', '@UCPACKAGE@': 'package'.upper(), '@YEAR@': '2014', '@FULLNAME@': 'fullname', '@EMAIL@': 'email@example.org', '@SHORTDATE@': '11 Jan. 2013', } sed('../extra2/', 'debian/', substlist, 'package', quiet=quiet) sed('../extra3/', 'debian/', substlist, 'package', quiet=quiet) sed('../extra4/', 'debian/copyright-example/', substlist, 'package', quiet=quiet) debmake-4.1.7/debmake/debs.py0000775000175000017500000002644412416763277016322 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import sys ########################################################################### def match_prefix(name, prefix): l = len(prefix) return (len(name) > 1) and (name[:l] == prefix) def match_suffix(name, suffix): l = len(suffix) return (len(name) > 1) and (name[-l:] == suffix) ########################################################################### # sanity: called from debmake.main() ########################################################################### def debs(binaryspec, package, monoarch, dh_with): ####################################################################### # parse binary package names and their specification: binaryspec -> debs ####################################################################### debs = [] # list pset = set() tset = set() for x0 in binaryspec.split(','): x = x0.strip() ################################################################### # split: y[0] = bin-package-name-marker y[1] = bin-package-type ################################################################### y = x.split(':') if len(y) >= 3: print('E: -b does not support the 3rd argument yet: {}'.format(x), file=sys.stderr) exit(1) ################################################################### # get real binary package name: p ################################################################### p = y[0].strip() if p == '': p = package elif p == '-': p = package elif p[0] == '-': p = package + p # first default values and then override or update values a = 'any' # arch m = 'foreign' # muiti-arch t = '' # type dp = {'${misc:Depends}'} pd = set() ################################################################### # Prefix names should come first to be overriden later ################################################################### if match_prefix(p, 'lib'): a = 'any' m = 'same' t = 'lib' elif match_prefix(p, 'fonts-'): a = 'all' m = 'foreign' t = 'data' elif match_prefix(p, 'python-'): a = 'all' m = 'foreign' t = 'python' elif match_prefix(p, 'python3-'): a = 'all' m = 'foreign' t = 'python3' else: pass # Suffix names override if match_suffix(p, '-perl'): a = 'all' m = 'foreign' t = 'perl' elif match_suffix(p, '-dev'): a = 'any' m = 'same' t = 'dev' elif match_suffix(p, '-dbg'): a = 'any' m = 'same' t = 'dbg' elif match_suffix(p, '-bin') or \ match_suffix(p, 'tools') or \ match_suffix(p, 'utils'): a = 'any' m = 'foreign' t = 'bin' elif match_suffix(p, '-doc') or \ match_suffix(p, '-manual') or \ match_suffix(p, '-html'): a = 'all' m = 'foreign' t = 'doc' elif match_suffix(p, '-common'): a = 'all' m = 'foreign' t = 'data' else: pass ################################################################### # override if explicit 2nd argument exists, e.g. all in foo:all ################################################################### # The shorter match comes after the longer match if len(y) >= 2: t = y[1].strip() if match_prefix(t, 'an') or \ match_prefix(t, 'f'): # any foreign (deprecated) a = 'any' m = 'foreign' if t =='': t = 'bin' if match_prefix(t, 'b'): # bin a = 'any' m = 'foreign' t = 'bin' elif match_prefix(t, 'da'): # data a = 'all' m = 'foreign' t = 'data' elif match_prefix(t, 'db'): # dbg a = 'any' m = 'same' t = 'dbg' elif match_prefix(t, 'de'): # dev a = 'any' m = 'same' t = 'dev' elif match_prefix(t, 'do'): # doc a = 'all' m = 'foreign' t = 'doc' elif match_prefix(t, 'l'): # lib a = 'any' m = 'same' t = 'lib' elif match_prefix(t, 'pe') or (t == 'pl'): # perl a = 'all' m = 'foreign' t = 'perl' elif match_prefix(t, 'python3') or (t == 'py3'): # python3 a = 'all' m = 'foreign' t = 'python3' elif match_prefix(t, 'py'): # python a = 'all' m = 'foreign' t = 'python' elif match_prefix(t, 'ruby') or (t == 'rb'): # ruby a = 'all' m = 'foreign' t = 'ruby' elif match_prefix(t, 'sc') or (t == 'sh'): # script a = 'all' m = 'foreign' t = 'script' ############################################################### # ambiguous type values (but clear about arch/multi-arch ############################################################### elif match_prefix(t, 'an') or \ match_prefix(t, 'f'): # any foreign a = 'any' m = 'foreign' if t =='': t = 'bin' elif match_prefix(t, 'a'): # all a = 'all' m = 'foreign' if t =='': t = 'script' elif match_prefix(t, 'sa'): # same a = 'any' m = 'same' if t =='': t = 'lib' else: print('E: -b: {} has undefined type: {}'.format(p, t), file=sys.stderr) exit(1) ################################################################### # update binary package type from dh_with and arch setting ################################################################### if t == '': if 'perl_build' in dh_with: a = 'all' t = 'perl' elif 'perl_makemaker' in dh_with: a = 'all' t = 'perl' elif 'python2' in dh_with: a = 'all' t = 'python' elif 'python3' in dh_with: a = 'all' t = 'python3' else: if a == 'any': t = 'bin' else: t = 'script' # t always have non NULL string value ! ################################################################### # monoarch = non-multi-arch ################################################################### if monoarch: m = '' ################################################################### # multi arch and library package ################################################################### if (not monoarch) and t == 'lib': # set this only for M-A library packages pd.update({'${misc:Pre-Depends}'}) ################################################################### # update binary package dependency by package type etc. ################################################################### if t == 'bin': # executable dp.update({'${shlibs:Depends}'}) elif t == 'lib': # library dp.update({'${shlibs:Depends}'}) elif t == 'perl': # dh_perl(1) dp.update({'${perl:Depends}'}) elif t == 'python': # dh_python2 dp.update({'${python:Depends}'}) elif t == 'python3': # dh_python3 dp.update({'${python3:Depends}'}) elif t == 'ruby': # gem2deb ??? XXXX FIXME XXXX dp.update({'${ruby:Depends}'}) else: pass ################################################################### # loging and sanity check ################################################################### print('I: binary package={} Type={} / Arch={} M-A={}'.format(p, t, a, m), file=sys.stderr) if p in pset: print('E: duplicate definition of package name "{}"'.format(p), file=sys.stderr) exit(1) pset.update({p}) if t in tset: print('W: duplicate definition of package type "{}"'.format(t), file=sys.stderr) if t != 'dbg': print('W: *** manual modifiocation of debian/{}.install required ***'.format(p), file=sys.stderr) tset.update({t}) ################################################################### # append dictionary to a list ################################################################### debs.append({'package': p, 'arch': a, 'multiarch': m, 'depends': dp, 'pre-depends': pd, 'type': t}) ################################################################### return debs ####################################################################### # Test script ####################################################################### if __name__ == '__main__': print(match_prefix('deb', 'deb')) if match_prefix('deb', 'deb'): print('deb match deb') else: print('deb not match deb') print('----- no dh_with') # dh_with = set() # binaryspec = '-,-doc:doc,libpackage1, libpackage-dev, libpackage1-dbg' # monoarch = False # debs(binaryspec, 'package', monoarch, dh_with) # print('----- dh_with python3') # dh_with = set({'python3'}) # debs(binaryspec, 'package', monoarch, dh_with) # print('----- monoarch True dh_with python3') # monoarch = True # debs(binaryspec, 'package', monoarch, dh_with) debmake-4.1.7/debmake/copyright.py0000775000175000017500000011436312416763277017413 0ustar osamuosamu00000000000000#!/usr/bin/python3 # vim:se tw=0 sts=4 ts=4 et ai: """ Copyright © 2014 Osamu Aoki 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. """ import glob import hashlib import itertools import operator import os import re import subprocess import sys import debmake.debug import debmake.lc ################################################################### # Parse year within a copyright line ################################################################### re_year_1900 = re.compile(r''' (?P
.*?)
        (?P19\d\d)\s*[-,]\s*
        (?P\d\d)
        (?P\D.*|$)''', re.IGNORECASE | re.VERBOSE)

re_year_2000 = re.compile(r'''
        (?P
.*?)
        (?P20\d\d)\s*[-,]\s*
        (?P\d\d)
        (?P\D.*|$)''', re.IGNORECASE | re.VERBOSE)

def normalize_year_span(line):
    # 1990-91 -> 1990-1991 etc.
    while True:
        m = re_year_1900.search(line)
        if m:
            line = m.group('pre') + m.group('n1') + '-19' + \
                    m.group('n2') + m.group('post')
        else:
            break
    # 2010-11 -> 2010-2011 etc.
    while True:
        m = re_year_2000.search(line)
        if m:
            line = m.group('pre') + m.group('n1') + '-20' + \
                    m.group('n2') + m.group('post')
        else:
            break
    return line

re_year_yn = re.compile(r'''^\s*
        (?P(?:\d\d+[-,.;\s]*)+)[.,;:]?\s*
        (?P\D.*\D)\s*\.?$''', re.IGNORECASE | re.VERBOSE)

re_year_ny = re.compile(r'''^\s*
        (?P.*?\D)\s*
        (?P(?:\d\d+[-.,;\s]*)+)[.,;:]?\s*$''', re.IGNORECASE | re.VERBOSE)

def split_year_span(line):
    # split line into years and name
    m1 = re_year_yn.search(line)
    m2 = re_year_ny.search(line)
    if m1:
        years = m1.group('year').strip()
        name = m1.group('name').strip()
    elif m2:
        years = m2.group('year').strip()
        name = m2.group('name').strip()
    elif line:
        years = 'NO_MATCH' # sign for funkey line
        name = line.strip()
    else:
        years = ''
        name = ''
    if name[:2].lower() == 'by':
        name = name[2:].strip()
    debmake.debug.debug('Dy: years="{}", name="{}" <- "{}"'.format(years, name, line), type='y')
    return (years, name)

re_year = re.compile(r'\d\d+')

def get_year_range(years):
    # year range
    year_min = 9999
    year_max = 0
    for year_string in re_year.findall(years):
        year = int(year_string)
        year_min =  min(year_min, year)
        year_max =  max(year_max, year)
    return (year_min, year_max)

###################################################################
# Parse name within a copyright line
###################################################################
re_name_drop = re.compile(r'''(?:
        All\s+Rights\s+Reserved\.?|
        originally\s+by.*$|
        (?:originally\s+)?written\s+by.*$)
        ''', re.IGNORECASE | re.VERBOSE)

re_fsf_addr = re.compile(r'^Free\s+Software\s+Foundation,\s+Inc\.',
        re.IGNORECASE)

def cleanup_name(name):
    if re_fsf_addr.search(name): # FSF without address etc.
        name = 'Free Software Foundation, Inc.'
    return name

###################################################################
# Parse (year, name) within all copyright lines
###################################################################
def analyze_copyright(copyright_lines):
    copyright_data = {}
    for line in copyright_lines:
        line = line.strip()
        line = normalize_year_span(line).strip()
        line = re_name_drop.sub('', line).strip()
        (years, name) = split_year_span(line)
        name = cleanup_name(name).strip()
        (year_min, year_max) = get_year_range(years)
        if name in copyright_data.keys():
            (year0_min, year0_max) = copyright_data[name]
            year_min =  min(year_min, year0_min)
            year_max =  max(year_max, year0_max)
        if name:
            copyright_data[name] = (year_min, year_max)
        else:
            print('W: analyze_copyright: skip name="", years="{}" <- line"{}"'.format(years, line), file=sys.stderr)
    return copyright_data

###################################################################
# A format state machine parser to extract copyright+license by format
###################################################################
fs = [
'F_BLNK  ', # blank line
'F_QUOTE ',
'F_BLKP  ',
'F_BLKPE ',
'F_BLKP0 ',
'F_BLKQ  ',
'F_BLKQE ',
'F_BLKQ0 ',
'F_BLKC  ',
'F_BLKCE ',
'F_BLKC2 ',
'F_BLKC1 ',
'F_BLKC0 ',
'F_PLAIN1',
'F_PLAIN2',
'F_PLAIN3',
'F_PLAIN4',
'F_PLAIN5',
'F_PLAIN6',
'F_PLAIN7',
'F_PLAIN8',
'F_PLAIN9',
'F_PLAIN10',
'F_PLAIN0', # always match
'F_EOF   ', # force EOF before processing the next line
]
# enum(fs)
for i, name in enumerate(fs):
    exec('{} = {}'.format(name.strip(), i))
F_EOF = -1 # override

# entry format style id list
all_non_entry_formats = {
F_BLKPE, F_BLKP0,
F_BLKQE, F_BLKQ0,
F_BLKCE, F_BLKC2, F_BLKC1, F_BLKC0,
F_EOF}

all_entry_formats = set()
for name in fs:
    id = eval(name.strip())
    if id not in all_non_entry_formats:
        all_entry_formats.add(id)

formats = {} # dictionary
# define next format state
# formats[*][0]: regex to match
# formats[*][1]: next format state allowed
# formats[*][2]: format state allowed (persistent)

formats[F_BLNK] = (
        re.compile(r'^(?P)(?P)(?P)$'),
        all_entry_formats,
        {F_BLNK}
        )

formats[F_QUOTE] = (
        re.compile(r'^(?P/\*)\**(?P.*?)\**(?P\*/)$'),  # C /*...*/
        all_entry_formats,
        {F_QUOTE, F_BLKC, F_BLKCE, F_BLKC2, F_BLKC1, F_BLKC0, F_BLNK}
        )

# python block mode start with '''
formats[F_BLKP] = (
        re.compile(r'^.*?(?P\'\'\')(?P.*)(?P)$'),  # Python
        [F_BLKPE, F_BLKP0],
        {F_BLKP, F_BLKPE, F_BLKP0, F_BLNK}
        )
formats[F_BLKPE] = (
        re.compile(r'^(?P)(?P.*?)(?P\'\'\').*$'),  # Python
        all_entry_formats,
        {F_BLKP, F_BLKPE, F_BLKP0, F_BLNK}
        )
formats[F_BLKP0] = (
        re.compile(r'^(?P)\s*(?P.*)\s*(?P)$'),
        [F_BLKPE, F_BLKP0],
        {F_BLKP, F_BLKPE, F_BLKP0, F_BLNK}
        )

# python block mode start with """
formats[F_BLKQ] = (
        re.compile(r'^.*?(?P""")(?P.*)(?P)$'),  # Python
        [F_BLKQE, F_BLKQ0],
        {F_BLKQ, F_BLKQE, F_BLKQ0, F_BLNK}
        )
formats[F_BLKQE] = (
        re.compile(r'^(?P)(?P.*?)(?P""").*$'),  # Python
        all_entry_formats,
        {F_BLKQ, F_BLKQE, F_BLKQ0, F_BLNK}
        )
formats[F_BLKQ0] = (
        re.compile(r'^(?P)\s*(?P.*)\s*(?P)$'),
        [F_BLKQE, F_BLKQ0],
        {F_BLKQ, F_BLKQE, F_BLKQ0, F_BLNK}
        )

# C block mode start with """
formats[F_BLKC] = (
        re.compile(r'^(?P/\*)\s*\**(?P.*)(?P)$'),  # C /*...
        [F_BLKCE, F_BLKC2, F_BLKC1, F_BLKC0],
        {F_QUOTE, F_BLKC, F_BLKCE, F_BLKC2, F_BLKC1, F_BLKC0, F_BLNK}
        )
formats[F_BLKCE] = (
        re.compile(r'^(?P\*\s|)(?P.*?)\s*\**?(?P\*/).*$'),  # C ...*/
        all_entry_formats,
        {F_QUOTE, F_BLKC, F_BLKCE, F_BLKC2, F_BLKC1, F_BLKC0, F_BLNK}
        )
formats[F_BLKC2] = (
        re.compile(r'^(?P\*)\**?(?P.*?)\**?(?P\*)$'),  # C *...*
        [F_BLKCE, F_BLKC2],
        {F_QUOTE, F_BLKC, F_BLKCE, F_BLKC2, F_BLKC1, F_BLKC0, F_BLNK}
        )
formats[F_BLKC1] = (
        re.compile(r'^(?P\*)\**?(?P.*)(?P)$'),  # C *...
        [F_BLKCE, F_BLKC1],
        {F_QUOTE, F_BLKC, F_BLKCE, F_BLKC2, F_BLKC1, F_BLKC0, F_BLNK}
        )
formats[F_BLKC0] = (
        re.compile(r'^(?P)(?P.*?)(?P)$'),
        [F_BLKCE, F_BLKC0],
        {F_QUOTE, F_BLKC, F_BLKCE, F_BLKC2, F_BLKC1, F_BLKC0, F_BLNK}
        )

# comment start with something
formats[F_PLAIN1] = (
        re.compile(r'^(?P#)#*(?P.*)(?P)$'),   # Shell/Perl/Python
        all_entry_formats,
        {F_PLAIN1, F_BLNK}
        )

formats[F_PLAIN2] = (
        re.compile(r'^(?P//)/*(?P.*)(?P)$'),  # C++ //
        all_entry_formats,
        {F_PLAIN2, F_BLNK}
        )

formats[F_PLAIN3] = (
        re.compile(r'^(?P--)-*(?P.*)(?P)$'),  # Lua --
        all_entry_formats,
        {F_PLAIN3, F_BLNK}
        )

formats[F_PLAIN4] = (
        re.compile(r'^(?P\.\\")(?P.*)(?P)$'), # manpage
        all_entry_formats,
        {F_PLAIN4, F_BLNK}
        )

formats[F_PLAIN5] = (
        re.compile(r'^(?P@%:@)(?P.*)(?P)$'),  # autom4te.cache
        all_entry_formats,
        {F_PLAIN5, F_BLNK}
        )

formats[F_PLAIN6] = (
        re.compile(r'^(?P@c)\s+(?P.*)(?P)$'), # Texinfo @c
        all_entry_formats,
        {F_PLAIN6, F_BLNK}
        )

formats[F_PLAIN7] = (
        re.compile(r"^(?P')(?P.*)(?P)$"),# Basic
        all_entry_formats,
        {F_PLAIN7, F_BLNK}
        )

formats[F_PLAIN8] = (
        re.compile(r'^(?P;);*(?P.*)(?P)$'),# vim
        all_entry_formats,
        {F_PLAIN8, F_BLNK}
        )

formats[F_PLAIN9] = (
        re.compile(r'^(?Pdnl)\s+(?P.*)(?P)$'),# m4 dnl
        all_entry_formats,
        {F_PLAIN9, F_BLNK}
        )

formats[F_PLAIN10] = (
        re.compile(r'^(?P%)\s+(?P.*)(?P)$'),# texinfo.tex
        all_entry_formats,
        {F_PLAIN10, F_BLNK}
        )

# This is the last rule (always match, no blank line comes here)
formats[F_PLAIN0] = (
        re.compile(r'^(?P)(?P.+)(?P)$'),     # Text
        all_entry_formats,
        {F_PLAIN0, F_BLNK}
        )

# drop lines such as "All Rights Reserved" and treat them blank
re_dropline = re.compile(r'''(?:
        ^timestamp=|                        # timestamp line
        ^scriptversion=|                    # version line
        ^All\s+Rights\s+Reserved|           # possible leader
        ^written\s+by|
        ^This\s+file\s+is\s+part\s+of\s+GNU|
        ^Last\s+update:\s|
        ^\.bp\s                             # manpage
        )''', re.IGNORECASE | re.VERBOSE)

def check_format_style(line, xformat_state):
    line = line.strip()
    if line[:1] == '+': # hack to drop patch (1 level)
        line = line[1:].strip()
    prefix = ''
    postfix = ''
    format_state = F_EOF
    formats_allowed = formats[xformat_state][1]
    for f in formats_allowed:
        regex = formats[f][0]
        m = regex.search(line)
        if m:
            line = m.group('text').strip()
            prefix = m.group('prefix') # for debug output
            postfix = m.group('postfix') # for debug output
            format_state = f
            break
    if re_dropline.match(line): # hack to drop line
        line = ''
        if format_state != F_EOF:
            format_state = F_BLNK
    debmake.debug.debug('Ds: format={}->{}, prefix="{}", postfix="{}": "{}"'.format(fs[xformat_state], fs[format_state], prefix, postfix, line), type='s')
    return (line, format_state)

###################################################################
# Clean copyright
###################################################################
# substitute: \(co or (c) or  @copyright{} -> ©
re_co = re.compile(r'(?:\\\(co|\(c\)|@copyright\{\})', re.IGNORECASE) # fake match )

# search to allow leading jank words
re_copyright_line = re.compile(r'''
        (?:(?:Copyright|Copyr\.)(?:\s*©)?|
        ©\s*(?:Copyright|Copyr\.)|
        ©)\s*(?P.*)$
        ''', re.IGNORECASE | re.VERBOSE)

def clean_copyright(line):
    # simplify '©' handling: no (c) from C MACRO here
    line = re_co.sub('©', line)
    m = re_copyright_line.search(line)
    if m:
        line = m.group('copyright').strip()
    else:
        print("W: no match @clean_copyright line={}".format(line), file=sys.stderr)
    return line

###################################################################
# Clean license
###################################################################
def clean_license(license_lines):
    lines = license_lines
    while len(lines) > 0 and lines[0] == '':
        del lines[0]
    while len(lines) > 0 and lines[-1:][0] == '':
        del lines[-1:]
    return lines

###################################################################
# Extract copyright+license from a source file
###################################################################
# content_state
cs = [
'C_INIT',  # initial content_state
'C_COPY',  # copyright found
'C_COPYB', # blank after C_COPY
'C_AUTH',  # AUTHOR: like
'C_AUTHB', # blank after C_AUTH
'C_LICN',  # license found
'C_EOF',   # EOF found at the end of line
]
# enum(cs)
for i, name in enumerate(cs):
    exec('{} = {}'.format(name.strip(), i))
C_EOF = -1 # override

re_copyright_mark_maybe = re.compile(r'''
        (?:Copyright|Copyr\.|\(C\)|©|\\\(co) # fake )
        ''', re.IGNORECASE | re.VERBOSE)

re_copyright_mark_exclude = re.compile(r'''(?:
        [=?$]|                  # C MACRO
        Copyright\s+holder|     # copyright holders ...
        copyright\s+and\s+license| # copyright and license
        Copyright[!-')-~]|      # no coding variables
        Copyright:?$|           # ... copyright
        if\s+\(C\)|             # C code
        ^modified\s+version|    # ... of Copyright
        [^h][-+*/_a-su-z0-9]\(C\)|  # C MACRO (but Copyright(C) is OK)
        (?:def|if|return)\s.*\(C\)| # Python/C
        switch\s+\(C\)|         # C code
        ^This\s                 # This ...  Copyright
        )''', re.IGNORECASE | re.VERBOSE)

re_copyright_nomark_year = re.compile(r'''
        ^[12]\d\d\d\d
        ''', re.IGNORECASE | re.VERBOSE)

re_author_init = re.compile(r'''^(?:
        authors?:?|
        maintainers?:?|
        translators?:?)
        \s*(?P.*)\s*$
        ''', re.IGNORECASE | re.VERBOSE)
re_author_cont = re.compile(r'^(?:.*@.*\..*|[^ ]*(?: [^ ]*){1,4})$')

re_license_start_maybe = re.compile(r'''(
        \sare\s|
        \sis\s|
        ^Copying\s|
        ^Everyone\s|
        ^Licensed\s|
        ^License\s|
        ^Permission\s|
        ^Redistribution\s|
        ^This\s|
        ^Unless\s
        )''', re.IGNORECASE | re.VERBOSE)
re_license_start_sure = re.compile(r'''(
        ^Copying\s+and\s+distribution\s+of\s+this\s+file|       # PERMISSIVE
        ^Distributed\s+under\s+the\s+Boost\s+Software\s+License,|   # Boost
        ^Everyone\s+is\s+permitted\s+to\s+copy\s+and\s+distribute|  # GNU FULL
        ^Distribute\s+under\s[AL]?GPL\s+version|                # GPL short
        ^Licensed\s+to\s+the\s+Apache\s+Software\s+Foundation|  #Apache-2.0_var1
        ^Licensed\s+under\s+|                                   # ECL
        ^Licensed\s+under\s+the\s+Apache\s+License|             #Apache-2.0_var2
        ^License\s+Applicability.\s+Except\s+to\s+the\s+extent\s+portions|  # SGI
        ^Permission\s+is\s+granted\s+to\s+copy,\s+distribute|   # GFDL 1.1
        ^Permission\s+is\s+hereby\s+granted|                    # MIT
        ^Permission\s+to\suse,\s+copy,\s+modify|                # ISC
        ^Redistribution\s+and\s+use\s+in\s+source\s+and\s+binary\s+forms|   # Apache 1.0/BSD
        ^The\s+contents\s+of\s+this\s+file|                     # ErlPL, ...
        ^The\s+contents\s+of\s+this\s+file\s+are\s+subject\s+to| # MPL-1.0 1.1
        ^This\s+.{2,40}\s+is\s+free\s+software|                 # makefile.in etc.
        ^This\s+file\s+is\s+distributed\s+under\s+the\s+same\s+license\s+as\s+.{5,40}\.$| # same
        ^This\s+library\s+is\s+free\s+software|                 # LGPL variants
        ^This\s+license\s+is\s+a\s+modified\s+version\s+of\s+the|   # AGPL-1.0
        ^This\s+program\s+can\s+redistributed|                  # LaTeX LPPL 1.0
        ^This\s+program\s+is\s+free\s+software|                 # GPL variants
        ^This\s+program\s+may\s+be\s+redistributed|             # LaTeX LPPL 1.1 1.2
        ^This\s+software\s+is\s+furnished\s+under\s+license|    # DEC
        ^This\s+software\s+is\s+provided\s+|                    # Zlib
        ^This\s+Source\s+Code\s+Form\s+is\s+subject\s+to\s+the\s+terms\s+of| # MPL 2.0
        ^This\s+work\s+is\s+distributed\s+under|                # W3C
        ^This\s+work\s+may\s+be\s+redistributed|                # LaTeX LPPL 1.3
        ^unless\s+explicitly\s+acquired\s+and\s+licensed        # Watcom
        )''', re.IGNORECASE | re.VERBOSE)

re_license_end_start = re.compile(r'''(
        ^EOT$|^EOF$|^EOL$|^END$|        # shell <{}, content={}->{}, copyright={}, license={}: "{}"'.format(fs[xformat_state], fs[format_state], cs[xcontent_state], cs[content_state], copyright_found, license_found, line), file=sys.stderr)
            print('W: !!!!! assertion error, exit loop !!!!!', file=sys.stderr)
            break
        debmake.debug.debug('De: *end* format={}->{}, content={}->{}, copyright={}, license={}: "{}"'.format(fs[xformat_state], fs[format_state], cs[xcontent_state], cs[content_state], copyright_found, license_found, line), type='e')
    ##########################################################################
    # main loop for lines (end)
    ##########################################################################
    copyright_data = analyze_copyright(copyright_lines)
    license_lines = clean_license(license_lines)
    debmake.debug.debug('Da: AUTHOR(s)/TRANSLATOR(s):', type='a')
    for line in author_lines:
        debmake.debug.debug('Da: {}'.format(line), type='a')
    if copyright_data == {} and license_lines == []:
        # no copyright and no license
        copyright_data = {'__NO_COPYRIGHT_NOR_LICENSE__':(0, 0)}
    elif copyright_data == {}:
        # no copyright and but with license (Maybe __UNKNOWN__ license)
        copyright_data = {'__NO_COPYRIGHT__':(0, 0)}
    return (copyright_data, license_lines)

###################################################################
# Check license of a text file
###################################################################
def check_license(file, encoding='utf-8'):
    ###################################################################
    # Start analyzing file (default encoding)
    ###################################################################
    try:
        with open(file, 'r', encoding=encoding) as fd:
            (copyright_data, license_lines) = check_lines(fd.readlines())
    ###################################################################
    # Fall back for analyzing file (latin-1 encoding)
    ###################################################################
    except UnicodeDecodeError as e:
        print('W: Non-UTF-8 char found, using latin-1: {}'.format(file), file=sys.stderr)
        fd.close()
        with open(file, 'r', encoding='latin-1') as fd:
            (copyright_data, license_lines) = check_lines(fd.readlines())
    return (copyright_data, license_lines)

###################################################################
# Check all appearing copyright and license texts
###################################################################
# data[*][0]: license name ID: licenseid
# data[*][1]: file name (bunched, list): files
# data[*][2]: copyright holder info (data=dictionary): copyright_lines
# data[*][3]: license text (original: list of lines): license_lines
###################################################################
def check_all_licenses(files, encoding='utf-8', mode=0):
    adata = []
    license_cache = {} # hashtable for quicker license scan
    if len(files) == 0:
        print('W: check_all_licenses(files) should have files', file=sys.stderr)
    if sys.hexversion >= 0x03030000: # Python 3.3 ...
        print('I: ', file=sys.stderr, end='', flush=True)
    for file in files:
        debmake.debug.debug('Df: check_all_licenses file={}'.format(file), type='f')
        if os.path.isfile(file):
            if sys.hexversion >= 0x03030000: # Python 3.3 ...
                print('.', file=sys.stderr, end='', flush=True)
            (copyright_data, license_lines) = check_license(file, encoding=encoding)
            norm_text = debmake.lc.normalize(license_lines)
            md5hash = hashlib.md5()
            md5hash.update(norm_text.encode())
            md5hashkey = md5hash.hexdigest()
            if md5hashkey in license_cache.keys():
                (licenseid, licensetext) = license_cache[md5hashkey]
            else:
                (licenseid, licensetext) = debmake.lc.lc(norm_text, license_lines, mode)
                license_cache[md5hashkey] = (licenseid, licensetext)
            adata.append((md5hashkey, copyright_data, licenseid, licensetext, file))
        else:
            print('W: check_all_licenses on non-existing file: {}'.format(file), file=sys.stderr)
        for c in copyright_data.keys():
            debmake.debug.debug('Dc: {}-{}: {}'.format(copyright_data[c][0], copyright_data[c][0], c), type='c')
        for l in license_lines:
            debmake.debug.debug('Dl: {}'.format(l), type='l')
    print('\nI: check_all_licenses completed for {} files.'.format(len(files)), file=sys.stderr)
    return adata

def bunch_all_licenses(adata):
    # group scan result by license
    group_by_license = []
    adata = sorted(adata, key=operator.itemgetter(0)) # sort by md5hashkey
    for k, g in itertools.groupby(adata, operator.itemgetter(0)):
        group_by_license.append(list(g))      # Store group iterator as a list
    # bunch the same license for reporting
    bdata = []
    for data_by_license in group_by_license:
        bunched_files = []
        bunched_copyright_data = {}
        for (md5hashkey, copyright_data, licenseid, licensetext, file) in data_by_license:
            bunched_files.append(file)
            for name, (year_min, year_max) in copyright_data.items():
                if name in bunched_copyright_data.keys():
                    (year_min0, year_max0) = bunched_copyright_data[name]
                    bunched_copyright_data[name] = (min(year_min0, year_min), max(year_max0, year_max))
                else:
                    bunched_copyright_data[name] = (year_min, year_max)
        sortkey = '{0:03} {1:02} {2} {3}'.format(max(0, 1000 - len(bunched_files)), min(99, len(licenseid)), licenseid, md5hashkey)
        bunched_files = sorted(bunched_files)
        copyright_list = []
        for name, (year_min, year_max) in copyright_data.items():
            copyright_list.append((year_min, year_max, name))
        copyright_list = sorted(copyright_list)
        bdata.append((sortkey, bunched_files, copyright_list, licenseid, licensetext))
        debmake.debug.debug('Dk: sortkey="{}", files={}'.format(sortkey, bunched_files), type='k')
    return bdata

def format_all_licenses(bdata):
    spaces = '           ' # 11 spaces
    # sort for printer ready order
    group_by_license = []
    bdata = sorted(bdata, key=operator.itemgetter(0)) # sort by sortkey (more files comes early)
    for k, g in itertools.groupby(bdata, operator.itemgetter(0)):
        group_by_license.append(list(g))      # Store group iterator as a list
    cdata = []
    for data_by_sortkey in group_by_license:
        for (sortkey, bunched_files, copyright_list, licenseid, licensetext) in data_by_sortkey:
            copyright_lines = ''
            for (year_min, year_max, name) in copyright_list:
                if year_max == 0: # not found
                    copyright_lines += '{}{}\n'.format(spaces, name)
                elif year_min == year_max:
                    copyright_lines += '{}{} {}\n'.format(spaces, year_min, name)
                else:
                    copyright_lines += '{}{}-{} {}\n'.format(spaces, year_min, year_max, name)
            cdata.append((licenseid, licensetext, bunched_files, copyright_lines))
    return cdata

def check_copyright(files, mode=0, encoding='utf-8'):
    print('I: check_all_licenses', file=sys.stderr)
    adata = check_all_licenses(files, encoding=encoding, mode=mode)
    print('I: bunch_all_licenses', file=sys.stderr)
    bdata = bunch_all_licenses(adata)
    print('I: format_all_licenses', file=sys.stderr)
    cdata = format_all_licenses(bdata)
    return cdata


###################################################################
# Format licence
###################################################################
def format_license(lines):
    # RFC-822 compliant empty lines with "."
    xlines = []
    for line in lines:
        line = line.rstrip()
        if line == '':
            xlines.append(' .\n')
        else:
            xlines.append(' ' + line + '\n')
    return ''.join(xlines)

#######################################################################
# license text file conversion
#######################################################################
def license_text(file, encoding='utf-8'):
    lines = []
    try:
        with open(file, 'r', encoding=encoding) as fd:
            for line in fd.readlines():
                lines.append(line.rstrip())
    except UnicodeDecodeError as e:
        print('W: Non-UTF-8 char found, using latin-1: {}'.format(file), file=sys.stderr)
        fd.close()
        lines = []
        with open(file, 'r', encoding='latin-1') as fd:
            for line in fd.readlines():
                lines.append(line.rstrip())
    return format_license(lines)

#######################################################################
# main program
#######################################################################
def copyright(package_name, license_file_masks, data, xml_html_files, binary_files, huge_files, mode=0):
    # mode: 0: not -c, 1: -c simple, 2: -cc normal, 3: -ccc extensive
    #      -1: -cccc debug simple, -2 -ccccc debug normal -3 -cccccc debug extensive
    # make text to print
    text = '''\
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: {}
Source: 
###
### Uncomment the following 2 lines to enable uscan to exclude non-DFSG components 
### Files-Excluded: command/non-dfsg.exe
###   docs/source/javascripts/jquery-1.7.1.min.js
###
### This is a autogenerated template for debian/copyright.
###
### Edit this accordinng to the "Machine-readable debian/copyright file" as
### http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ .
###
### Generate updated license templates with the "debmake -cc" to STDOUT
### and merge them into debian/copyright as needed.
###
### Please avoid to pick license terms that are more restrictive than the
### packaged work, as it may make Debian's contributions unacceptable upstream.

'''.format(package_name)
    for (licenseid, licensetext, files, copyright_lines) in data:
        # Files:
        text +=             'Files:     {}\n'.format('\n           '.join(files))
        # Copyright:
        text +=             'Copyright: ' + copyright_lines[11:]
        # License:
        text +=             'License:   {}{}\n\n'.format(licenseid, licensetext)
    if xml_html_files != []:
        text += '#----------------------------------------------------------------------------\n'
        text += '# xml and html files (skipped):\n#         {}\n\n'.format('\n#         '.join(xml_html_files))
    if binary_files != []:
        text += '#----------------------------------------------------------------------------\n'
        text += '# binary files (skipped):\n#         {}\n\n'.format('\n#         '.join(binary_files))
    if huge_files != []:
        text += '#----------------------------------------------------------------------------\n'
        text += '# huge files   (skipped):\n#         {}\n\n'.format('\n#         '.join(huge_files))
    if mode == 0: # not for -c
        text += '''\
#----------------------------------------------------------------------------
# Files marked as NO_LICENSE_TEXT_FOUND may be covered by the following
# license/copyright files.

'''
        # get list of files to attach
        license_files = set()
        for fx in license_file_masks:
            license_files.update(set(glob.glob(fx)))
        for f in license_files:
            text += '#----------------------------------------------------------------------------\n'
            text += '# License file: {}\n'.format(f)
            text += license_text(f)
            text += '\n'

    return text

#######################################################################
# Test script
#######################################################################
if __name__ == '__main__':
    print(copyright('foo', {'LICENSE*', 'COPYRIGHT'}, [], ['binary1.file', 'binary2.file'], ['huge.file1', 'huge.file2']))
    check_lines(['#!/bin/sh', 'COPYRIGHT FOO_BAR 1890', '', 'License', 'END'])
    print(analyze_copyright(["1987-90 FOO bar","boo foo wooo 2001-12", "1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009  Free Software Foundation, Inc." ]))
    X = 'Free Software Foundation, Inc. HHHHHHH'
    print(cleanup_name(X))

debmake-4.1.7/debmake/__init__.py0000775000175000017500000003314112416766340017126 0ustar  osamuosamu00000000000000#!/usr/bin/python3
# vim:se tw=0 sts=4 ts=4 et ai:
"""
Copyright © 2014 Osamu Aoki

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.
"""
import os
import subprocess
import sys
import time
import debmake.analyze
import debmake.copyright
import debmake.debian
import debmake.debs
import debmake.debug
import debmake.dist
import debmake.kludge
import debmake.origtar
import debmake.para
import debmake.sanity
import debmake.scanfiles
import debmake.tar
import debmake.untar
#######################################################################
# Basic package information
#######################################################################

__programname__     = 'debmake'
__version__         = '4.1.7'
__copyright__       = 'Copyright © 2014 Osamu Aoki '
__license__         = '''\
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.
'''

__debian_policy__   = '3.9.5'   # debian policy version
__debian_compat__   = '9'       # debhelper compatibility level in 
                                # debian/comapt
                                # Adjust this to 8 or less if 
                                # backporting to pre-wheezy

#######################################################################
# main program
#######################################################################
def main():
#######################################################################
# set parameters from commandline etc.
#######################################################################
    debmake.debug.debug('D: {} started'.format(sys.argv[0]))
    debmake.debug.debug('D: PYTHONPATH = {} '.format(':'.join(sys.path)))
    print('I: set parameters', file=sys.stderr)
    para = {}
    para['cwd'] = os.getcwd()
    para['program_name'] = __programname__
    para['program_version'] = __version__
    para['program_copyright'] = __copyright__
    para['program_license'] = __license__
    para['date'] = time.strftime("%a, %d %b %Y %H:%M:%S %z")
    para['shortdate'] = time.strftime("%d %b %Y")
    para['year'] = time.strftime("%Y")
    para['standard_version'] = __debian_policy__    # Debian policy_
    para['compat'] = __debian_compat__              # debhelper
    para['build_depends']   = {'debhelper (>=' + para['compat'] +')'}
    para['desc'] = ''
    para['desc_long'] = ''
    para['export'] = set()
    para['override'] = set()
    # get prefix for install --user/ ,, --prefix/ ,, --home
    fullparent = os.path.dirname(sys.argv[0])
    if fullparent == '.':
        para['base_path'] = '..'
    else:
        para['base_path'] = os.path.dirname(fullparent)
    para = debmake.para.para(para)
    debmake.debug.debug_para('Dp: @post-para para[*]', para)
#######################################################################
# -v: print version and copyright notice and exit
#######################################################################
    if para['print_version']:
        print('{0} (version: {1}) {2}\n\n{3}'.format(
                para['program_name'], 
                para['program_version'],
                para['program_copyright'],
                para['program_license']), file=sys.stderr)
        return
#######################################################################
# -c: scan source for copyright+ license text, print and exit
#######################################################################
    if para['copyright'] !=0:
        print('I: scan source for copyright+license text and file extensions', file=sys.stderr)
        (nonlink_files, xml_html_files, binary_files, huge_files, counter, count_list) = debmake.scanfiles.scanfiles()
        data = debmake.copyright.check_copyright(nonlink_files, mode=para['copyright'])
        print(debmake.copyright.copyright('package', set(), data, xml_html_files, binary_files, huge_files, mode=para['copyright']))
        return
#######################################################################
# -k: compare debian/copyright with the source and exit
#######################################################################
    if para['kludge'] !=0:
        print('I: compare debian/copyright with the source', file=sys.stderr)
        debmake.kludge.kludge(para['kludge'])
        return
#######################################################################
# sanity check parameters without digging deep into source tree
#######################################################################
    print('I: sanity check of parameters', file=sys.stderr)
    para = debmake.sanity.sanity(para)
    debmake.debug.debug_para('Dp: @post-sanity para[*]', para)
    print('I: pkg="{}", ver="{}", rev="{}"'.format(para['package'], para['version'], para['revision']), file=sys.stderr)
#######################################################################
# -d: make dist (with upstream buildsystem dist/sdist target)
#######################################################################
    if para['dist']:
        print('I: make the upstream tarball with "make dist" equivalents', file=sys.stderr)
        para = debmake.dist.dist(para)
        debmake.debug.debug_para('Dp: @post-dist para[*]', para)
        print('I: pkg="{}", ver="{}", rev="{}"'.format(para['package'], para['version'], para['revision']), file=sys.stderr)
#######################################################################
# -t: make tar (with "tar --exclude=debian" command)
#######################################################################
    elif para['tar']:
        print('I: make the upstream tarball with "tar --exclude=debian"', file=sys.stderr)
        debmake.tar.tar(para['tarball'], para['targz'], para['srcdir'], para['parent'], para['yes'])
        debmake.debug.debug_para('Dp: @post-tar para[*]', para)
#######################################################################
# -a, -d: extract archive from tarball (tar -xvzf)
#######################################################################
    if para['archive'] or para['dist']:
        print('I: untar the upstream tarball', file=sys.stderr)
        debmake.untar.untar(para['tarball'], para['targz'], para['srcdir'], para['dist'], para['tar'], para['parent'], para['yes'])
        debmake.debug.debug_para('Dp: @post-untar para[*]', para)
#######################################################################
# always: generate orig tarball if missing and non-native package
#######################################################################
    para['parent'] = os.path.basename(os.getcwd()) # update !!!
    print('I: *** start packaging in "{}". ***'.format(para['parent']), file=sys.stderr)
    if para['parent'] != para['srcdir']:
        print('W: parent dirtectory should be "{}".  (If you use pbuilder, this may be OK.)'.format(para['srcdir']), file=sys.stderr)
    if not para['native']:
        print('I: provide {}_{}.orig.tar.gz for non-native Debian package'.format(para['package'], para['version']), file=sys.stderr)
        # ln -sf parent/dist/Foo-1.0.tar.gz foo_1.0.orig.tar.gz
        debmake.origtar.origtar(para['package'], para['version'], para['targz'], para['tarball'], para['parent'])
        para['tarball'] = para['package'] + '_' + para['version'] + '.orig.' + para['targz']
        debmake.debug.debug_para('Dp: @post-origtar para[*]', para)
#######################################################################
# -q: quit here before generating template debian/* package files
#######################################################################
    if para['quitearly']:
        print('I: quit early after making the upstream tarball.', file=sys.stderr)
        exit(0)
#######################################################################
# Prep to create debian/* package files
#######################################################################
    print('I: parse binary package settings: {}'.format(para['binaryspec']), file=sys.stderr)
    para['debs'] = debmake.debs.debs(para['binaryspec'], para['package'], para['monoarch'], para['dh_with'])
    debmake.debug.debug_debs("Dd: para['debs'] =>", para['debs'])
    print('I: analyze the source tree', file=sys.stderr)
    para = debmake.analyze.analyze(para)
    debmake.debug.debug_para('Dp: @post-analyze para[*]', para)
    #debmake.gui()          # GUI setting
    #debmake.debug.debug_para('Dp: @post-gui para[*]', para)
#######################################################################
# Make debian/* package files
#######################################################################
    print('I: make debian/* template files', file=sys.stderr)
    debmake.debian.debian(para)
#######################################################################
# Make Debian package(s)
#######################################################################
    if para['judge']:
        command = 'fakeroot dpkg-depcheck -m -C -o ../{0}.depcheck.log -f -catch-alternatives debian/rules install >../{0}.build.log 2>&1'.format(para['package'])
        print('I: $ {}'.format(command), file=sys.stderr)
        if subprocess.call(command, shell=True) != 0:
            print('E: failed to run dpkg-depcheck.', file=sys.stderr)
            exit(1)
        command = 'LANG=C ; sed -e "1d" < ../{0}.depcheck.log | sort >../{0}.build-dep.log'.format(para['package'])
        print('I: $ {}'.format(command), file=sys.stderr)
        if subprocess.call(command, shell=True) != 0:
            print('E: failed to run sort on build-dep.', file=sys.stderr)
            exit(1)
        if len(para['debs']) == 1:
            bpackage = para['debs'][0]['package']
            command = 'LANG=C; find debian/' + bpackage + ' -type f 2>&1 | sed -e "s/^debian\/' + bpackage + '\///" | sort >../{0}.install.log'.format(para['package'])
            print('I: $ {}'.format(command), file=sys.stderr)
            if subprocess.call(command, shell=True) != 0:
                print('E: failed to run find debian/{}.'.format(bpackage), file=sys.stderr)
                exit(1)
        elif len(para['debs']) > 1:
            command = 'LANG=C; find debian/tmp -type f 2>&1 | sed -e "s/^debian\/tmp\///" | sort >../{0}.install.log'.format(para['package'])
            print('I: $ {}'.format(command), file=sys.stderr)
            if subprocess.call(command, shell=True) != 0:
                print('E: failed to run find debian/tmp.', file=sys.stderr)
                exit(1)
        else:
            print('E: No binary package was generated.', file=sys.stderr)
            exit(1)
        print('I: upon return to the shell, current directory becomes {}'.format(para['cwd']), file=sys.stderr)
        print('I: please execute "cd {0}" before building the binary package'.format(os.getcwd()), file=sys.stderr)
        print('I: with dpkg-buildpackage (or debuild, pdebuild, sbuild, ...).', file=sys.stderr)
    elif para['invoke']:
        print('I: {}'.format(para['invoke']), file=sys.stderr)
        if subprocess.call(para['invoke'], shell=True) != 0:
            print('E: failed to build Debian package(s).', file=sys.stderr)
            exit(1)
        if para['archive']:
            print('I: please inspect the build results.'.format(os.getcwd()), file=sys.stderr)
        else:
            print('I: upon return to the shell, current directory becomes {}'.format(para['cwd']), file=sys.stderr)
            print('I: please execute "cd .." and inspect the build results.'.format(os.getcwd()), file=sys.stderr)
    elif os.getcwd() != para['cwd']:
        print('I: upon return to the shell, current directory becomes {}'.format(para['cwd']), file=sys.stderr)
        print('I: please execute "cd {0}" before building the binary package'.format(os.getcwd()), file=sys.stderr)
        print('I: with dpkg-buildpackage (or debuild, pdebuild, sbuild, ...).', file=sys.stderr)
    return

#######################################################################
# Test code
#######################################################################
if __name__ == '__main__':
    main()

debmake-4.1.7/debmake/untar.py0000775000175000017500000001231512416763277016526 0ustar  osamuosamu00000000000000#!/usr/bin/python3
# vim:se tw=0 sts=4 ts=4 et ai:
"""
Copyright © 2014 Osamu Aoki

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.
"""
import os
import subprocess
import sys
import debmake.yn
###########################################################################
# untar: called from debmake.main()
###########################################################################
# tarball   = package-version.tar.gz (or  package_version.orig.tar.gz)
# targz     = tar.gz
# srcdir    = package-version
# tar       = True if -t, False if -a or -d
# dist      = True if -d, False if -a or -t
# parent    = package (original VCS directory for -d)
# yes       = True if -y, False as default
###########################################################################
def untar(tarball, targz, srcdir, dist, tar, parent, yes):
    print('I: pwd = "{}"'.format(os.getcwd()), file=sys.stderr)
    if not os.path.isfile(tarball):
        print('E: missing the "{}" file.'.format(tarball), file=sys.stderr)
        exit(1)
    if tar: # -t
        if os.path.isdir(srcdir):
            print('I: use existing "{}".'.format(srcdir), file=sys.stderr)
        else:
            print('E: fail to find "{}".'.format(srcdir), file=sys.stderr)
            exit(1)
    else: # -a -d
        if os.path.isdir(srcdir):
            debmake.yn.yn('remove "{}" directory in untar'.format(srcdir), 'rm -rf ' + srcdir, yes)
        # setup command line
        if targz == 'tar.bz2':
            command = 'tar --bzip2 -xvf '
            commandx = 'tar --bzip2 -tf '
        elif targz == 'tar.xz':
            command = 'tar --xz -xvf '
            commandx = 'tar --xz -tf '
        elif targz == 'tar.gz':
            command = 'tar -xvzf '
            commandx = 'tar -tzf '
        else:
            print('E: the extension "{}" not supported.'.format(targz), file=sys.stderr)
            exit(1)
        command += tarball
        print('I: $ {}'.format(command), file=sys.stderr)
        if subprocess.call(command, shell=True) != 0:
            print('E: failed to untar.', file=sys.stderr)
            exit(1)
        print('I: untared {}.'.format(tarball), file=sys.stderr)
        # rename source directory
        commandx += tarball + '|grep -v /.'
        print('I: {}'.format(commandx), file=sys.stderr)
        try:
            tarsrcdirs = subprocess.check_output(commandx, shell=True, universal_newlines=True).strip().split('\n')
        except CalledProcessError:
            print('E: failed to list the stem directory of tar.', file=sys.stderr)
            exit(1)
        # tailing / may or may not exist.
        if len(tarsrcdirs) > 1:
            print('W: {} first level directories found.'.format(len(tarsrcdirs)), file=sys.stderr)
        if tarsrcdirs[0] =="":
            print('E: No first level directory found.', file=sys.stderr)
            exit(1)
        elif tarsrcdirs[0][-1:] == '/':
            tarsrcdir = tarsrcdirs[0][:-1]
        else:
            tarsrcdir = tarsrcdirs[0]
        if tarsrcdir != srcdir:
            print('I: move source tree from {} to {}.'.format(tarsrcdir, srcdir), file=sys.stderr)
            command = 'mv -f ' + tarsrcdir + ' ' + srcdir
            print('I: $ {}'.format(command), file=sys.stderr)
            if subprocess.call(command, shell=True) != 0:
                print('E: failed to move directory.', file=sys.stderr)
                exit(1)
    # copy debian/* for -d
    if dist and os.path.isdir(parent + '/debian'):
        command = 'cp -drl ' + parent + '/debian ' + srcdir + '/debian'
        # execute command: copy debian tree (with hardlink)
        print('I: $ {}'.format(command), file=sys.stderr)
        if subprocess.call(command, shell=True) != 0:
            print('E: cp -drl failed.', file=sys.stderr)
            exit(1)
    # cd srcdir
    os.chdir(srcdir)
    print('I: pwd = "{}"'.format(os.getcwd()), file=sys.stderr)
    return

if __name__ == '__main__':
    # untar(tarball, targz, srcdir, dist, tar, parent)
    # -a
    os.chdir('tarball')
    untar("example.tar.gz", "tar.gz", "example-1.0", False, False, "")
    os.chdir('..')
    # -d
    os.chdir('dist')
    untar("example.tar.gz", "tar.gz", "example-1.0", True, False, "example")
    os.chdir('..')
    # -t
    os.chdir('tar')
    untar("", "tar.gz", "example-1.0", False, True, "")
    os.chdir('..')

debmake-4.1.7/debmake/debug.py0000775000175000017500000000602712416763277016466 0ustar  osamuosamu00000000000000#!/usr/bin/python3
# vim:se tw=0 sts=4 ts=4 et ai:
"""
Copyright © 2014 Osamu Aoki

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.
"""
import os
import sys
#######################################################################
# Debug output
#######################################################################
def get_debug():
    try:
        e = os.environ["DEBUG"]
    except KeyError:
        e = ''
    return e

def debug(msg, type=''):
    e = get_debug()
    if (e != '' and type == '') or \
            (type in e):
        print(msg, file=sys.stderr)
    return

def debug_para(msg, para):
    e = get_debug()
    if 'p' in e:
        line = '{}:\n'.format(msg)
        for x in para.keys():
            line += '  para[{}] = "{}"\n'.format(x, para[x])
        print(line, file=sys.stderr)
    elif e:
        line = '{}:\n'.format(msg)
        line += '  para[{}] = "{}"\n'.format('package', para['package'])
        line += '  para[{}] = "{}"\n'.format('version', para['version'])
        line += '  para[{}] = "{}"\n'.format('revision', para['revision'])
        line += '  para[{}] = "{}"\n'.format('targz', para['targz'])
        print(line, file=sys.stderr)
    return

def debug_debs(msg, debs):
    e = get_debug()
    if 'd' in e:
        line = '{}: \n'.format(msg)
        for deb in debs:
            line += '  Binary Package: {}\n'.format(deb['package'])
            line += '    Architecture: {}\n'.format(deb['arch'])
            line += '    Multi-Arch:   {}\n'.format(deb['multiarch'])
            line += '    Depends:      {}\n'.format(deb['depends'])
            line += '    Pre-Depends:  {}\n'.format(deb['pre-depends'])
            line += '    Type:         {}\n'.format(deb['type'])
        print(line, file=sys.stderr)
    return

#######################################################################
# Test code
#######################################################################
if __name__ == '__main__':
    debug('DEBUG ON!')
    para = {}
    para['package'] = 'package'
    para['version'] = '1.0'
    para['targz'] = 'tar.gz'
    debug_para('debug_para', para)

debmake-4.1.7/debmake/lc.py0000775000175000017500000014547312416763277016007 0ustar  osamuosamu00000000000000#!/usr/bin/python3
# vim:se tw=0 sts=4 ts=4 et ai:
"""
Copyright © 2014 Osamu Aoki

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.
"""
import re
###############################################################################
# The regex of devscripts: licensecheck (version  2.14.1) was referenced.
# 85 characters needed for
#     "the Apache Group for use in the Apache HTTP server project
#      (http://www.apache.org/)"
###############################################################################
LMAX = 1200 # max junk text (head and tail)
# order rules by specific to generic
list_main = [] # main rule list = [(name, regex, [variable, ...]), ...]
list_sub = []  # substring rule list for debug
###############################################################################
re_drop = re.compile(r'("|`|‘|’|“|”|'|' + r"')", re.IGNORECASE)
re_connect = re.compile(r'- ', re.IGNORECASE)
def pattern(text, tail=' '):
    text = re_drop.sub('',text) # drop quotation marks
    text = ' '.join(text.split()) # normalize white space(s) 
    text = re_connect.sub('', text) + tail # connect words
    return text # pattern normally ends with ' '
def eval_sub(sub):
    rtext = eval(sub)
    if rtext[-3:] == ' )?':
       rtext = rtext[:-1]
    return rtext # drop "?" for vanishable "(.... )?" patterns
# non greedy
rhead0=r'^(?P.{0,' + '{}'.format(LMAX) + r'}?)'
rtail0=r'(?P.{0,'  + '{}'.format(LMAX) + r'}?)$'
def regex(reg, rhead=rhead0, rtail=rtail0):
    return re.compile(rhead + reg + rtail, re.IGNORECASE)
###############################################################################
# BSD Exact
###############################################################################
list_sub += ['r_BSD0']
r_BSD0 = pattern(r'''
    Redistribution and use in source and binary forms, with or without
    modification, are permitted provided that the following conditions are met:
    ''')
list_sub += ['r_BSD1']
r_BSD1 = pattern(r'''
    (?:..? )?Redistributions of source code must retain the above copyright
    notice, this list of conditions and the following disclaimer\.
    ''')
list_sub += ['r_BSD2']
r_BSD2 = pattern(r'''
    (?:..? )?Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the following disclaimer in the
    documentation and/ or other materials provided with the distribution\.
    ''')
list_sub += ['r_BSD3']
r_BSD3 = pattern(r'''
    (?P(?:..? )?All advertising materials mentioning features or use of
    this software must display the following acknowledgement: This product
    includes software developed by .{2,85}\. )?
    ''', tail='')
list_sub += ['r_BSD4']
r_BSD4 = pattern(r'''
    (?P(?:..? )?Neither the name of .{2,85} nor the names of its
    contributors may be used to endorse or promote products derived from this
    software without specific prior written permission\. )?
    ''', tail='')
list_sub += ['r_BSDW']
r_BSDW = pattern(r'''
    (?PTHIS SOFTWARE IS PROVIDED BY (?P.{2,85})
    ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
    INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
    AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
    .{2,85} BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
    OR CONSEQUENTIAL DAMAGES \(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
    SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
    INTERRUPTION\) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
    CONTRACT, STRICT LIABILITY, OR TORT \(INCLUDING NEGLIGENCE OR OTHERWISE\)
    ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
    POSSIBILITY OF SUCH DAMAGE\. )?
    ''', tail='')
### BSD {2,3,4}-clause
list_main += [('BSD', 'EXACT', regex(r_BSD0 + r_BSD1 + r_BSD2 + r_BSD3 + r_BSD4 +
    r_BSDW[:-1]), ['bsd3', 'name', 'noendorse', 'nowarranty',
    'head', 'tail'])]
###############################################################################
# BSD Generic
###############################################################################
# list 'bsd3' before 'name'
list_sub += ['r_BSD0G']
r_BSD0G = pattern(r'''
    Redistribution and use in source and binary forms, with or without
    modification, are permitted(?P \(subject to the limitations in the
    disclaimer below\))? provided that the following conditions are met[:.]
    ''')
list_sub += ['r_BSD1G']
r_BSD1G = pattern(r'''
    (?:..? )?Redistributions of source code must retain the above copyright
    notice, this list of conditions,? and the following disclaimer\.
    ''') # ,? for XFREE86 1.1
list_sub += ['r_BSD2G']
r_BSD2G = pattern(r'''
    (?:..? )?Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the following disclaimer in the
    documentation and(?:/ ?or)? other materials provided with the
    distribution(?:\.|, and in the same place and form as other copyright,
    license and disclaimer information\.)
    ''') # XFree86 1.1 has the last phrase
list_sub += ['r_BSD3G']
r_BSD3G = pattern(r'''
    (?P(?:..? )?All advertising materials mentioning features or use of
    this software must display the following acknowledge?ment. This product
    includes software developed by .{2,85}\. )?
    ''', tail='')
    # dropping "e" as variant
list_sub += ['r_BSD4G']
r_BSD4G = pattern(r'''
    (?P(?:..? |and that )?(?:Except as contained in this notice,
    )?.{2,85} be used (?:to endorse or promote products derived from|in
    advertising or (?:publicity pertaining to distribution of|otherwise to
    promote the sale, use or other dealings in)) (?:this|the)
    software without (?:specific,? )?(?:prior written|written prior)
    (?:permission|authorization)(?: from .{2,85}| of .{2,85})?\. )?
    ''', tail='') # Some XFree86 variant has leading clarification with shall
list_sub += ['r_BSDWG']
r_BSDWG = pattern(r'''
    (?P(?PNO EXPRESS(?:ED)? OR IMPLIED LICENSES TO ANY
    PARTYS PATENT RIGHTS ARE GRANTED BY THIS LICENSE. )?THIS SOFTWARE IS
    PROVIDED(?: BY (?P.{2,85}))?  AS.IS AND ANY EXPRESS(?:ED)? OR IMPLIED
    (?:WARANTY\.|WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
    WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
    DISCLAIMED. IN NO EVENT SHALL .{2,85} BE LIABLE FOR ANY DIRECT, INDIRECT,
    INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES \(INCLUDING, BUT
    NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    DATA, OR PROFITS; OR BUSINESS INTERRUPTION\) HOWEVER CAUSED AND ON ANY
    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
    \(INCLUDING NEGLIGENCE OR OTHERWISE\) ARISING IN ANY WAY OUT OF THE USE OF
    THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE\.) )?
    ''', tail='') # "EXPRESSED" is what XFREE86 1.1 uses. BSD uses "EXPRESS"
### BSD {2,3,4}-clause
list_main += [('BSD', 'GENERIC', regex(r_BSD0G + r_BSD1G + r_BSD2G + r_BSD3G + r_BSD4G +
    r_BSDWG[:-1]), ['bsd3', 'name', 'subject', 'noendorse', 'nowarranty', 'patent',
    'head', 'tail'])]
###############################################################################
# Apache family (BSD0, BSD1, BSD2 are the same one)
###############################################################################
list_sub += ['r_Apache3'] # BSD3 alternative
r_Apache3 = pattern(r'''
    (?:..? )?The end-user documentation included with the redistribution, if
    any, must include the following acknowledgment: This product includes
    software developed by .{2,85}\. Alternately, this acknowledgment
    may appear in the software itself, if and wherever such third-party
    acknowledgments normally appear.
    ''')
list_sub += ['r_Apache4'] # BSD4 alternative
r_Apache4 = pattern(r'''
    (?:..? )?The names? .{2,85} must not be used to endorse or promote products
    derived from this software without prior written permission.  For written
    permission, please contact .{2,85}.
    ''')
list_sub += ['r_Apache5'] # trade mark restriction
r_Apache5 = pattern(r'''
    (?:..? )?Products derived from this software may not be called .{3,12},?
    nor may .{3,12} appear in their name. without prior written permission of
    .{2,85}\.
    ''')
list_sub += ['r_Apache6'] # BSD3 alternative
r_Apache6 = pattern(r'''
    (?:..? )?Redistributions of any form whatsoever must retain the following
    acknowledgment: This product includes software developed by .{2,85} for use
    in .{2,85}\.
    ''')
### Apache 1.0
list_main += [('Apache-1.0', 'EXACT', regex(r_BSD0G + r_BSD1G + r_BSD2G + r_BSD3G +
    r_Apache4 + r_Apache5 + r_Apache6 + r_BSDWG[:-1]), ['bsd3', 'name', 
    'subject', 'nowarranty', 'patent', 'head', 'tail'])]
### Apache 1.1
list_main += [('Apache-1.1', 'EXACT', regex(r_BSD0G + r_BSD1G + r_BSD2G + r_Apache3 +
    r_Apache4 + r_Apache5 + r_BSDWG[:-1]), ['name', 'subject', 'nowarranty',
    'patent', 'head', 'tail'])]
###############################################################################
# MIT=Expat: Exact
###############################################################################
list_sub += ['r_pemission_expat']
r_pemission_expat = pattern(r'''
    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:
    ''')
list_sub += ['r_notice_expat']
r_notice_expat = pattern(r'''
    The above copyright notice and this permission notice shall be included in
    all copies or substantial portions of the Software.
    ''')
list_sub += ['r_disclaimer_expat']
r_disclaimer_expat = pattern(r'''
    (?PTHE 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. )
    ''', tail='')
### Expat
list_main += [('MIT', 'Expat', regex(r_pemission_expat + r_notice_expat + r_disclaimer_expat),
    ['head', 'tail', 'nowarranty'])]
###############################################################################
# MIT: Generic (trained with xorg source data)
###############################################################################
# Expat variants = r_pemission_expat with variants
list_sub += ['r_pemission_expatG']
r_pemission_expatG = pattern(r'''
    Permission is hereby granted, free of charge, to any person obtaining a
    copy of this software and associated documentation files \(the
    (?:Software|Materials)\), to deal in the Software without restriction,
    including without limitation(?: on)? the rights to use, copy, modify,
    (?:merge, )?(?:publish, )?distribute, (?:sub ?license, )?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[.:]|,
    provided that))?
    ''')
# Expat variants = r_notice_expat with variants
list_sub += ['r_notice_expatG']
r_notice_expatG = pattern(r'''
    The above copyright notice(?:|s|\(s\)) and this permission notice
    (?P\(including the next paragraph\) )?(?:shall be
    included|appear) in all copies(?: or substantial portions)?(?: of the
    Software)?(?: and that both the above copyright notice(?:|s|\(s\)) and this
    permission notice appear in supporting documentation)?.
    ''')
# Expat variants = r_disclaimer_expat with variants
list_sub += ['r_disclaimer_expatG']
r_disclaimer_expatG = pattern(r'''
    (?PTHE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY
    KIND, EXPRESS(?:ED)? OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
    WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
    NON-?INFRINGEMENT(?: OF THIRD PARTY RIGHTS)?. IN NO EVENT SHALL .{2,85} BE
    LIABLE FOR ANY CLAIM,(?: OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES,
    OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS|
    DAMAGES,?(?: INCLUDING, BUT NOT LIMITED TO CONSEQUENTIAL OR INCIDENTAL
    DAMAGES,)? OR OTHER LIABILITY), WHETHER IN AN ACTION OF CONTRACT, (?:TORT
    OR OTHERWISE|NEGLIGENCE OR OTHER TORTIOUS ACTION), ARISING( FROM,)? OUT OF
    OR IN CONNECTION WITH(?: THE SOFTWARE OR)? THE USE OR (?:OTHER DEALINGS IN
    THE|PERFORMANCE OF THIS) SOFTWARE. )?
    ''', tail='')
# noendorse (=BSD4) is not used in Expat but used in many old MIT licenses
# MIT Xorg variants with warranty
list_main += [('MIT', 'GENERIC', regex(r_pemission_expatG + r_notice_expatG +
    r_disclaimer_expatG[:-1] + r_BSD4G), ['requiredisclaimer', 'nowarranty',
    'noendorse', 'head', 'tail']), ]
###############################################################################
# ISC: Exact
###############################################################################
list_sub += ['r_pemission_isc']
r_pemission_isc = pattern(r'''
    Permission to use, copy, modify, and/or distribute this software for any
    purpose with or without fee is hereby granted,
    ''')
list_sub += ['r_notice_isc']
r_notice_isc = pattern(r'''
    provided that the above copyright notice and this permission notice appear
    in all copies.
    ''')
list_sub += ['r_disclaimer_isc']
r_disclaimer_isc = pattern(r'''
    (?PTHE SOFTWARE IS PROVIDED AS IS AND ISC DISCLAIMS ALL
    WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
    MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL (?P.{2,85}) BE LIABLE
    FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
    WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
    ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
    IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. )
    ''', tail='')
### ISC
list_main += [('ISC', 'EXACT', regex(r_pemission_isc + r_notice_isc + r_disclaimer_isc),
    ['head', 'tail', 'nowarranty', 'name'])]
###############################################################################
# ISC: Generic
###############################################################################
list_sub += ['r_pemission_iscG']
r_pemission_iscG = pattern(r'''
    Permission to use, copy, modify, (:?and(?:/ ?or)? distribute |distribute,
    and(?:/ ?or)? (?:sell|sublicense) )this software (:?and its documentation )?for any
    purpose (:?is hereby granted without fee,|(?:and )?(?:with or )?without fee
    is hereby granted,)
    ''')
list_sub += ['r_notice_iscG']
r_notice_iscG = pattern(r'''
    provided that the above copyright notices?(?: and this permission notice)?
    appear in all copies(:? and that both (?:that|those) copyright notices? and this
    permission notice appear in supporting documentation)?[.,]?
    ''')
list_sub += ['r_disclaimer_iscG']
r_disclaimer_iscG = pattern(r'''
    (?:No trademark license .{2,200} is hereby granted\. .{50,1000} is made\.
    )?(?:.{2,85} MAKES? NO REPRESENTATIONS .{2,80} FOR ANY PURPOSE\. 
    )?(?P(?:.{2,85} make(?:|S|\(S\)) (?:no|any) representations?
    about the suitability of this software for any purpose. )?(?:(?:It|THE
    SOFTWARE) is provided as is and )?(?:.{2,85} DISCLAIM(?:|S|\(S\)) ALL
    WARRANTIES WITH REGARD TO THIS SOFTWARE,? INCLUDING ALL IMPLIED WARRANTIES
    OF MERCHANTABILITY AND FITNESS[,.] IN NO EVENT SHALL .{2,85} BE LIABLE FOR
    ANY SPECIAL,(?: DIRECT,)? INDIRECT,? OR CONSEQUENTIAL DAMAGES OR ANY
    DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
    AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
    OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE\.|(?:It|THE
    SOFTWARE) is provided as is without express or implied warranty\.) )?
    ''', tail='') # First 2 are for Adobe Display PostScript
r_disclaimer_iscGx = pattern(r'''
    (?P(?:.{2,85} make(?:|S|\(S\)) (?:no|any) representations?
    about the suitability of this software for any purpose. 
    )?(?:It|THE SOFTWARE) is provided as is(?: without express or
    implied warranty\.| 
    and .{2,85} DISCLAIM(?:|S|\(S\)) ALL WARRANTIES WITH REGARD TO THIS
    SOFTWARE,? INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
    FITNESS[,.] IN NO EVENT SHALL .{2,85} BE LIABLE FOR ANY SPECIAL,(?:
    DIRECT,)? INDIRECT,? OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
    RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
    CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
    CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.) )?
    ''', tail='')
# ISC variants with no-endorse in the middle
list_main += [('ISC', 'VARIANT_1', regex(r_pemission_iscG + r_notice_iscG +
    r_BSD4G + r_disclaimer_iscG[:-1]), ['nowarranty', 'noendorse', 'head', 'tail']), ]
# ISC variants with no-endorse at the end
list_main += [('ISC', 'VARIANT_2', regex(r_pemission_iscG + r_notice_iscG + r_notice_expatG +
    r_disclaimer_expatG[:-1] + r_BSD4G ), ['nowarranty', 'noendorse', 'head', 'tail']), ]
###############################################################################
# Zlib: Exact
###############################################################################
list_sub += ['r_disclaimer_zlib']
r_disclaimer_zlib = pattern(r'''
    (?PThis software is provided as.is, without any express or
    implied warranty. In no event will the authors be held liable for any
    damages arising from the use of this software. )
    ''', tail='')
list_sub += ['r_permission_zlib']
r_permission_zlib = pattern(r'''
    Permission is granted to anyone to use this software for any purpose,
    including commercial applications, and to alter it and redistribute it
    freely, subject to the following restrictions[:]
    ''')
list_sub += ['r_notice_zlib']
r_notice_zlib = pattern(r'''
    (?:..? )?The origin of this software must not be misrepresented; you must
    not claim that you wrote the original software. If you use this software in
    a product, an acknowledgment in the product documentation would be
    appreciated but is not required.
    (?:..? )?Altered source versions must be plainly marked as such, and must
    not be misrepresented as being the original software.
    (?:..? )?This notice may not be removed or altered from any source
    distribution.
    ''')
### Zlib
list_main += [('Zlib', 'EXACT', regex(r_disclaimer_zlib + r_permission_zlib + r_notice_zlib),
    ['phead', 'tail', 'nowarranty'])]
###############################################################################
# DEC
###############################################################################
list_sub += ['r_permission_dec']
r_permission_dec = pattern(r'''
    This software is furnished under license and may be used and copied only in
    accordance with the following terms and conditions. Subject to these
    conditions, you may download, copy, install, use, modify and distribute
    this software in source and(?:/ ?or)? binary form. No title or ownership is
    transferred hereby.
    ''')
list_sub += ['r_notice_dec']
r_notice_dec = pattern(r'''
    (?:..? )?Any source code used, modified or distributed must reproduce and
    retain this copyright notice and list of conditions as they appear in the
    source file.
    ''')
list_sub += ['r_noendorse_dec']
r_noendorse_dec = pattern(r'''
    (?P(?:..? )?No right is granted to use any trade name,
    trademark, or logo of .{2,85}. Neither .{2,85} name nor any trademark or
    logo of .{2,85} may be used to endorse or promote products derived from
    this software without the prior written permission of .{2,85}. )?
    ''', tail='')
list_sub += ['r_disclaimer_dec']
r_disclaimer_dec = pattern(r'''
    (?P(?:..? )?This software is provided AS.IS and any express or
    implied warranties, including but not limited to, any implied warranties of
    merchantability, fitness for a particular purpose, or non-infringement are
    disclaimed.  In no event shall .{2,85} be liable for any damages
    whatsoever, and in particular, .{2,85} shall not be liable for special,
    indirect, consequential, or incidental damages or damages for lost profits,
    loss of revenue or loss of use, whether such damages arise in contract,
    negligence, tort, under statute, in equity, at law or otherwise, even if
    advised of the possibility of such damage. )?
    ''', tail='')
# MIT DEC variants with warranty
list_main += [('MIT', 'DEC', regex(r_permission_dec + r_notice_dec + r_noendorse_dec +
    r_disclaimer_dec[:-1]), ['nowarranty',
    'noendorse', 'head', 'tail']), ]
###############################################################################
# ISC/X11 hybrid with waranty
###############################################################################
list_sub += ['r_BSD3A'] # BSD3 alternative
r_BSD3A = pattern(r'''
    (?:..? )?The end-user documentation included with the redistribution, if
    any, must include the following acknowledgment: This product includes
    software developed by .{2,85}(?:, in the same place and form as other
    third-party acknowledgments)?\. Alternately, this acknowledgment may appear
    in the software itself, in the same form and location as other such
    third-party acknowledgments.
    ''')
list_main += [('MIT', 'XORG+BSD', regex(r_pemission_expatG + r_BSD1G +r_BSD2G +r_BSD3A
    + r_BSD4G + r_BSDWG[:-1] ), ['nowarranty', 'noendorse', 'head', 'tail']), ]
###############################################################################
# SGI
###############################################################################
list_sub += ['r_notice_sgi']
r_notice_sgi = pattern(r'''
    The above copyright notice including the dates of first publication and
    either this permission notice or a reference to
    http://oss.sgi.com/projects/FreeB/ shall be included in all copies or
    substantial portions of the Software.
    ''')
# SGI
list_main += [('SGI-B-2.0', 'EXACT', regex(r_pemission_expatG + r_notice_sgi +
    r_disclaimer_expatG[:-1] + r_BSD4G), ['nowarranty',
    'noendorse', 'head', 'tail']), ]
###############################################################################
# Mozilla
###############################################################################
r_MPL1 = pattern(r'''
    The contents of this file are subject to the Mozilla Public License Version
    (?P\d+(?:\.\d+)?) \(the License\); you may not use this file
    except in compliance with the License. You may obtain a copy of the License
    at http://www.mozilla.org/MPL/ Software distributed under the License is
    distributed on an AS IS basis, WITHOUT WARRANTY OF ANY KIND, either express
    or implied. See the License for the specific language governing rights and
    limitations under the License.
    ''')
r_MPL2 = pattern(r'''
    This Source Code Form is subject to the terms of the Mozilla Public
    License, v. (?P\d+(?:\.\d+)?). If a copy of the MPL was not
    distributed with this file, You can obtain one at
    http://mozilla.org/MPL/(?:\d+(?:\.\d+)?)/.(?P This Source
    Code Form is Incompatible With Secondary Licenses, as defined by the
    Mozilla Public License, v. (?:\d+(?:\.\d+)?).)?
    ''')
list_main += [('MPL', 'VARIANT1', regex(r_MPL1), ['version'])]
list_main += [('MPL', 'VARIANT2', regex(r_MPL2), ['version', 'incompatible'])]
###############################################################################
# PERMISSIVE license from GNU releted sources
###############################################################################
# GNU All-Permissive License
r_PM0 = pattern(r'''
    Copying and distribution of this file, with or without modification, are
    permitted in any medium without royalty provided the copyright notice and
    this notice are preserved.(?P This file is offered as.is,
    without (?:any warranty|warranty of any kind)?.)?
    ''')
# PERMISSIVE (aclocal.m4, libtool)
r_PM1 = pattern(r'''
    free software. (?:as a special exception )?the (Free Software
    Foundation|author|author\(s\)) gives unlimited permission to copy and(?:/ ?or)?
    distribute it, with or without modifications, as long as this notice is
    preserved.(?P This (program|file) is distributed in the hope
    that it will be useful, but WITHOUT ANY WARRANTY, to the extent permitted
    by law; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
    A PARTICULAR PURPOSE.)?
    ''')
r_PM2 = pattern(r'''
    This file may be copied and used freely without restrictions.  It may be
    used in projects which are not available under a GNU Public License, but
    which still want to provide support for the GNU gettext functionality.
    ''')
r_PM3 = pattern(r'''
    This configure script is free software; the Free Software Foundation gives
    unlimited permission to copy, distribute and modify it.
    ''')
list_main += [('PERMISSIVE', 'VARIANT0', regex(r_PM0), ['nowarranty'])]
list_main += [('PERMISSIVE', 'VARIANT1', regex(r_PM1), ['nowarranty'])]
list_main += [('PERMISSIVE', 'VARIANT2', regex(r_PM2), [])]
list_main += [('PERMISSIVE', 'VARIANT3', regex(r_PM3), [])]
###############################################################################
# Reference to license name (Generic style)
###############################################################################
# Permission clause
# under the terms of the 
list_sub += ['r_under']
r_under = pattern(r'''
    (?:you (?:can|may) redistribute it and(?:/ ?or)? modify .{2,85} under
    |Permission(?: is granted)? to copy, distribute,? and(?:/ ?or)? modify this
        document under
    |Permission(?: is granted)? to use, copy, modify,? (?:merge, )?(?:publish,
        )?distribute,? (?:sublicense,? )and(?:/ ?or)? sell .{2,85} under
    |Permission(?: is granted)? to use, copy, modify,? (?:merge,?
        )?(?:publish,? )?and(?:/ ?or)? distribute .{2,85} under
    |.{2,85} (?:is|are) licensed under
    |distribute under
    |subject to
    |Released under
    |free software .{2,85} under )
    ''', tail='') + r'(?:the (?:terms of the )?)?'
###############################################################################
# GNU version
list_sub += ['r_version1']
r_version1 = pattern(r'''
    (?:(?:as )?published by the Free Software Foundation[,;:.]? 
    )?(?:either )?versions? 
    (?P\d+(?:\.\d+)?)(?: of the License)?[,.]?(?: \(?only\)?\.? 
    | or (?:\(at your option\)? )?(?:any )?(?Plater)(?: versions?)?\.?|)
    (?:published by the Free Software Foundation[,;:.]? )?''', tail='')
    # wrong additional "s" is used in some software
    # GNU Free Documentation License, Version 1.1 or any later version published 
# XXXXX FIXME XXXXX r_version2 not tested
list_sub += ['r_version2']
r_version2 = pattern(r'''
    (?:either )?versions? 
    (?P\d+(?:\.\d+)?)(?: of the License)?(?:\.| 
    \(?only\)\.?|, 
    or (?:\(at your option\) )?(?:any )?(?Plater)(?: versions?)?\.)?
    ''') + r'(?: of the\s)?'
    # wrong additional "s" is used in some software
###############################################################################
list_sub += ['r_LGPL']
r_LGPL = r'(?:GNU (?:Library|Lesser) General Public License|(?:GNU )?LGPL).? '
list_main += [('LGPL', 'VARIANT1', regex(r_under + r_LGPL + r_version1), ['head',
    'version', 'later', 'tail'])]
list_main += [ ('LGPL', 'VARIANT2', regex(r_under + r_version2 + r_LGPL), ['head',
    'version', 'later', 'tail'])]

list_sub += ['r_AGPL']
r_AGPL = r'(?:GNU Affero General Public License|(?:GNU )?AGPL).? '
list_main += [('AGPL', 'VARIANT1', regex(r_under + r_AGPL + r_version1), ['head',
    'version', 'later', 'tail'])]
list_main += [ ('AGPL', 'VARIANT2', regex(r_under + r_version2 + r_AGPL), ['head',
    'version', 'later', 'tail']) ]

list_sub += ['r_GFDL']
r_GFDL = r'(?:GNU Free Documentation License|(?:GNU )?GFDL|GNU FDL).? '
list_main += [ ('GFDL', 'VARIANT1', regex(r_under + r_GFDL + r_version1), ['head',
    'version', 'later', 'tail']), ]
list_main += [ ('GFDL', 'VARIANT2', regex(r_under + r_version2 + r_GFDL), ['head',
    'version', 'later', 'tail']), ]

list_sub += ['r_GPL']
r_GPL = r'(?:GNU General Public License|(?:GNU )?GPL).? '
list_main += [ ('GPL', 'VARIANT1', regex(r_under + r_GPL + r_version1), ['head',
    'version', 'later', 'tail']), ]
list_main += [ ('GPL', 'VARIANT2', regex(r_under + r_version2 + r_GPL), ['head',
    'version', 'later', 'tail']), ]

list_sub += ['r_MPL']
r_MPL = r'Mozilla Public License.? '
list_main += [ ('MPL', 'VARIANT1', regex(r_under + r_MPL + r_version1), ['head',
    'version', 'later', 'tail']), ]
list_main += [ ('MPL', 'VARIANT2', regex(r_under + r_version2 + r_MPL), ['head',
    'version', 'later', 'tail']), ]

list_sub += ['r_Artistic']
r_Artistic = r'Artistic License.? '
list_main += [ ('Artistic', 'VARIANT1', regex(r_under + r_Artistic + r_version1),
    ['head', 'version', 'later', 'tail']), ]
list_main += [ ('Artistic', 'VARIANT2', regex(r_under + r_version2 + r_Artistic),
    ['head', 'version', 'later', 'tail']), ]
###############################################################################
# Reference to the package license
###############################################################################
r_SM0 = pattern(r'''
    This file is distributed under the same license as .{5,40}\.
    ''')
list_main += [('_SAME_', 'VARIANT0', regex(r_SM0), [])]
###############################################################################
# Reference to license name (specific style)
###############################################################################
list_main += [
    ('Apache', 'EXTRA', regex(pattern(r'''
        (?:.{2,85} licenses? this file to you|licensed) under the Apache
        License, Version (?P[^ ]+) \(the LICENSE\).
        ''')), ['version','head', 'tail']),
    ('QPL', 'EXTRA', regex(pattern(r'''
        (?PThis file is part of the .*Qt GUI Toolkit.  This file )?may
        be distributed under the terms of the Q Public License as defined.
        ''')), ['toolkit', 'head', 'tail']),
    ('Perl', 'EXTRA', regex(pattern(r'''
        This program is free software; you can redistribute it and/or modify it
        under the same terms as Perl itself.
        ''')), []),
    ('Beerware', 'EXTRA', regex(r'\(THE BEER-WARE LICENSE\).' 
        ), []),
    ('PHP', 'EXTRA', regex(pattern(r'''
        This source file is subject to version (?P[^ ]+) of the PHP
        license.
        ''')), ['version']),
    ('CeCILL', 'EXTRA', regex(pattern(r'''
        under the terms of the CeCILL(?:-(?P[^ ]+))?.
        ''')), ['version']),
    ('SGI-B', 'EXTRA', regex(pattern(r'''
        (?:permitted in|under) the SGI Free Software License B, Version (?P[^ ]+) \(the License\).
        ''')), ['version']),
    ('Public domain', 'EXTRA', regex(pattern(r'''
        is in the public domain.
        ''')), []),
    ('CDDL', 'EXTRA', regex(pattern(r''''
        terms of the Common Development and Distribution License (?:, Version
        (?P[^ ]+)? \(the License\)).
        ''')), ['version']),
    ('Ms-PL', 'EXTRA', regex(pattern(r'''
        Microsoft Permissive License \(Ms-PL\).
        ''')), []),
    ('BSL', 'EXTRA', regex(pattern(r'''
        Distributed under the Boost Software License, Version (?P[^ ]+)\.
        ''')), ['version']),
    ('PSF', 'EXTRA', regex(pattern(r'''
        PYTHON SOFTWARE FOUNDATION LICENSE (VERSION (?P[^ ]+))?.
        ''')), ['version']),
    ('libpng', 'EXTRA', regex(pattern(r'''
        This code is released under the libpng license.
        ''')), []),
    ('APSL', 'EXTRA', regex(pattern(r'''
        subject to the Apple Public
        Source License Version (?P[^ ]+) \(the License\).
        ''')), ['version']),
    ('LPPL', 'EXTRA', regex(pattern(r'''
        (?:under the conditions of the LaTeX Project Public License,
        |under the terms of the LaTeX Project Public License Distributed from
        CTAN archives in directory macros/latex/base/lppl.txt; )either 
        version (?P[^ ]+) of (?:this|the) license,? or \(at your
        option\) any later version.
        ''')), ['version']),
    ('W3C', 'EXTRA', regex(pattern(r'''
        distributed under the W3C..? Software License in
        ''')), []), # W3C(R)
    ('WTFPL', 'EXTRA', regex(pattern(r'''
        Do What The Fuck You Want To Public License (?:, Version
        (?P[^, ]+))?.
        ''')), ['version']),
    ('WTFPL', 'EXTRA', regex(pattern(r'''
        (?:License WTFPL|Under (?:the|a) WTFPL).
        ''')), []),
    ('__UNKNOWN__', '', regex(r'.*'), []), # always true
]
###############################################################################
# exception clause
###############################################################################
r_autoconf1 = pattern(r'''
    As a special exception to the GNU General Public License, if you distribute
    this file as part of a program that contains a configuration script
    generated by Autoconf, you may include it under the same distribution terms
    that you use for the rest of that program.''', tail='')
r_autoconf2 = pattern(r'''
    As a special exception to the GNU General Public License, if you
    distribute this file as part of a program that contains a
    configuration script generated by Autoconf, you may include it under
    the same distribution terms that you use for the rest of that
    program.  This Exception is an additional permission under section 7
    of the GNU General Public License, version 3 \(GPLv3\).''', tail='')
r_autoconf3 = pattern(r'''
    As a special exception to the GNU General Public License,
    this file may be distributed as part of a program that
    contains a configuration script generated by Autoconf, under
    the same distribution terms as the rest of that program.''', tail='')
r_libtool = pattern(r'''
    As a special exception to the GNU General Public License, if you distribute
    this file as part of a program or library that is built using GNU Libtool,
    you may include this file under the same distribution terms that you use
    for the rest of that program.''', tail='')
r_bison = pattern(r'''
    As a special exception, you may create a larger work that contains part or
    all of the Bison parser skeleton and distribute that work under terms of
    your choice, so long as that work isn't itself a parser generator
    using the skeleton or a modified version thereof as a parser skeleton.
    Alternatively, if you modify or redistribute the parser skeleton itself,
    you may \(at your option\) remove this special exception, which will cause
    the skeleton and the resulting Bison output files to be licensed under the
    GNU General Public License without this special exception.''', tail='')
r_font = pattern(r'''
    As a special exception, if you create a document which uses this font, and
    embed this font or unaltered portions of this font into the document, this
    font does not by itself cause the resulting document to be covered by the
    GNU General Public License. This exception does not however invalidate any
    other reasons why the document might be covered by the GNU General Public
    License. If you modify this font, you may extend this exception to your
    version of the font, but you are not obligated to do so. If you do not wish
    to do so, delete this exception statement from your version.''', tail='')
list_exceptions = [
    ('autoconf', regex(r_autoconf1)),
    ('autoconf', regex(r_autoconf2)),
    ('autoconf', regex(r_autoconf3)),
    ('libtool', regex(r_libtool)),
    ('bison', regex(r_bison)),
    ('font', regex(r_font)),
]
regex_exception = regex(r'exception')
list_attribs = [
    ('The FSF address in the above text is the old one.', 
    regex(r'(?:675 Mass Ave|59 Temple Place|51 Franklin Steet|02139|02111-1307)')),
]
###############################################################################
# GNU License text
# 300 BYTES:   Most license headers included in the source
# 10000 BYTES: Full license text for GPL like license
# "Definitions": not present in normal license headers
re_FULL = re.compile(r'definition', re.IGNORECASE)
size_FULL = 500
re_LICENSE_HEADER = regex(pattern(r'''
    Standard License Header COPYRIGHT'''), 
    rhead=r'^(?P.*?)', rtail='(?P.*?)$')
re_LICENSE_AFFERO = regex(pattern(r'''
    software over a computer network.*Affero General Public License
    '''),
    rhead=r'^(?P.*?)', rtail='(?P.*?)$')
re_LICENSE = regex(pattern(r'''
    (?:(?PAFFERO GENERAL PUBLIC LICENSE.*)
    |(?PGNU Free Documentation License.*)
    |(?PGNU (?:Library|Lesser) General Public License.*)
    |(?PGNU General Public License.*) )version 
    (?P\d+(?:\.\d+)?),? o.*later'''), 
    rhead=r'^(?P.*?)', rtail='(?P.*?)$')
###############################################################################
# license name: file name, licence full name
licensefiles = {
    'Apache-2.0'    : ('Apache-2.0','Apache License Version 2.0\n '),
    'Artistic'      : ('Artistic',  '"Artistic License"\n '),
    'BSD-3-Clause'  : ('BSD',       'BSD 3-clause "New" or "Revised"\n License'),
    'GFDL-1.2'      : ('GFDL-1.2',  'GNU Free Documentation License\n Version 1.2'),
    'GFDL-1.2+'     : ('GFDL-1.2',  'GNU Free Documentation License\n Version 1.2'),
    'GFDL-1.3'      : ('GFDL-1.3',  'GNU Free Documentation License\n Version 1.3'),
    'GFDL-1.3+'     : ('GFDL-1.3',  'GNU Free Documentation License\n Version 1.3'),
    'GPL-1.0'       : ('GPL-1',     'GNU General Public License\n Version 1'),
    'GPL-1.0+'      : ('GPL-1',     'GNU General Public License\n Version 1'),
    'GPL-2.0'       : ('GPL-2',     'GNU General Public License\n Version 2'),
    'GPL-2.0+'      : ('GPL-2',     'GNU General Public License\n Version 2'),
    'GPL-3.0'       : ('GPL-3',     'GNU General Public License\n Version 3'),
    'GPL-3.0+'      : ('GPL-3',     'GNU General Public License\n Version 3'),
    'LGPL-2.0'      : ('LGPL-2',    'GNU Library General Public License\n Version 2'),
    'LGPL-2.0+'     : ('LGPL-2',    'GNU Library General Public License\n Version 2'),
    'LGPL-2.1'      : ('LGPL-2.1',  'GNU Lesser General Public License\n Version 2.1'),
    'LGPL-2.1+'     : ('LGPL-2.1',  'GNU Lesser General Public License\n Version 2.1'),
    'LGPL-3.0'      : ('LGPL-3',    'GNU Lesser General Public License\n Version 3'),
    'LGPL-3.0+'     : ('LGPL-3',    'GNU Lesser General Public License\n Version 3')}
#########################################################################################
def normalize(license_lines):
    # normalize license to a single normalized line with single space
    license_data = []
    for line in license_lines:
        line = line.strip()
        license_data.extend(line.split())
    try:
        license_data.remove('') # remove empty words
    except ValueError:
        pass
    return pattern(' '.join(license_data))
#########################################################################################
def lc(norm_text, license_lines, mode):
    # norm_text: normalized license lines to be analized
    # license_lines: original license lines for output
    # mode: license check mode
    # mode = 0: mode for copyright file generation; same as mode == 2 for lc.py
    if mode == 0:
        mode = 2
    # abs(mode) = 1: mode for the license scan (1 line; -c, -cccc)
    # abs(mode) = 2: mode for the license scan (mode = 1 + license text; -cc, -ccccc)
    # abs(mode) = 3: mode for the license scan (mode = 2 + comments; -ccc, -cccccc)
    # abs(mode) = 4: mode for the license scan (mode = 3 + match text; debug only)
    # mode < 0: add pattern index id (for -cccc, -ccccc, -cccccc)
    # return: text to be placed after "License: "
    #####################################################################################
    # 1-line part
    license = ''
    id = ''
    version = ''
    suffix = ''
    misc1 = ''
    # not in the 1-line part
    misc2 = set() # mode == 2 (add to copyright file)
    misc3 = set() # mode == 3
    match_text = '' # mode == 4 debug
    if len(norm_text) == 0:
        license = '__NO_LICENSE_TEXT__'
        text = ''
    elif len(norm_text) > size_FULL and re_FULL.search(norm_text):
        # full license text (very rough guess)
        lh = re_LICENSE_HEADER.search(norm_text)
        la = re_LICENSE_AFFERO.search(norm_text)
        if la:
            license = 'AGPL'
            version =  '-1.0'
            suffix = '+'
            id = 'FULL_LICENSE'
        elif lh:
            norm_text = lh.group('tail').strip()
            #print('~~~>>> : {}'.format(norm_text))
            l = re_LICENSE.search(norm_text)
            if l:
                if l.group('agpl'):
                    license = 'AGPL'
                    version =  l.group('version')
                    id = 'FULL_LICENSE'
                elif l.group('lgpl'):
                    license = 'LGPL'
                    version =  l.group('version')
                    id = 'FULL_LICENSE'
                elif l.group('gfdl'):
                    license = 'GFDL'
                    version =  l.group('version')
                    id = 'FULL_LICENSE'
                elif l.group('gpl'):
                    license = 'GPL'
                    version =  l.group('version')
                    id = 'FULL_LICENSE'
                else:
                    license = '__TOO_LONG_TYPE1__'
                if (len(version) == 1) and (version in '1234567890'):
                    version = version + '.0'
                if version:
                    version = '-' + version
                    suffix = '+'
            else:
                license = '__TOO_LONG_TYPE2__'
        else:
            license = '__TOO_LONG_TYPE3__'
    else:
        if norm_text:
            for (license, id, regex, vars) in list_main:
                #print('>> {}:{}'.format(license, id))
                if license == 'BSD':
                    version = '-2-Clause'
                else:
                    version = ''
                r0 =regex.search(norm_text)
                if r0:
                    match_text = r0.group()
                    for v in vars:
                        try:
                            if v == 'version':
                                if r0.group(v):
                                    version = r0.group('version')
                                    if (len(version) == 1) and (version in '1234567890'):
                                        version = version + '.0'
                                    if version:
                                        version = '-' + version
                            elif v == 'later':
                                if r0.group(v):
                                    suffix = '+'
                            elif v == 'bsd3':
                                if r0.group(v):
                                    if license == 'BSD':
                                        version = '-4-Clause'
                            elif v == 'noendorse':
                                if license == 'BSD':
                                    if r0.group(v) and (version != '-4-Clause'):
                                        version = '-3-Clause'
                                elif license[:3] == 'MIT' or license[:3] == 'ISC': 
                                    # MIT variants with optional noendorse
                                    if r0.group(v):
                                        misc3.update({'no-endorsement clause'})
                                else: # SGI-B, DEC incorporating BSD's no-endorsement clause
                                    if not r0.group(v):
                                        misc3.update({'no-endorsement clause'})
                            elif v == 'incompatible':
                                if r0.group(v):
                                    misc3.update({'copyleft incompatibility concern'})
                            elif v == 'nowarranty':
                                if not r0.group(v):
                                    misc3.update({'nowarranty disclaimer'})
                            elif v == 'requiredisclaimer':
                                if r0.group(v):
                                    misc3.update({'requiring nowarranty disclaimer'})
                            elif v == 'name':
                                if r0.group(v):
                                    name = r0.group('name')
                                    if name[4:11] == 'FREEBSD':
                                        suffix += '-FreeBSD'
                                    elif name[4:10] == 'NETBSD':
                                        suffix += '-NETBSD'
                                    elif name[4:11] == 'REGENTS':
                                        if version == '-4-Clause':
                                            suffix += '-UC'
                            elif v == 'patent' or v == 'subject':
                                if r0.group(v):
                                    suffix = '-Clear'
                            #elif v == 'name1':
                            #    if r0.group('name1'):
                            #        name3 = r0.group('name1')
                            #        suffix += '<1:' + name1 + '>'
                        except IndexError:
                            print('ERROR: {} missing: {} {}'.format(v, license, id))
                    # find only first match
                    break
            for (type1, attrib1) in list_attribs:
                r2 = attrib1.search(norm_text)
                if r2:
                    misc2.update({type1})
            count1 = 0
            for (type1, except1) in list_exceptions:
                r2 = except1.search(norm_text)
                if r2:
                    misc1 = type1
                    count1 += 1
            if count1 == 1:
                misc1 = ' with ' + misc1 + ' exception'
            elif count1 == 0:
                r2 = regex_exception.search(norm_text)
                if r2:
                    misc1 = ' with unknown exception XXX FIXME XXX'
            else:
                misc1 = ' with multiple exceptions XXX FIXME XXX'
        else:
            license = '' # NO LICENSE TEXT
    if mode <= -1 and id !='':
        id = ':' + id
    else:
        id = ''
    licenseid = license + version + suffix + id + misc1
    text = ''
    if abs(mode) >= 3: # output comments
        if misc3:
            text += '\n### !!! C: {}'.format('\n### !!! C: '.join(list(misc3)))
    if abs(mode) >= 2: # Skip if simple
        # RFC-822 complian and empty lines replaced with " ."
        for line in license_lines:
            line = line.rstrip()
            if line == '':
                text += '\n .'
            else:
                text += '\n {}'.format(line)
        if misc2:
            text += '\n .\n {}'.format('\n '.join(list(misc2)))
        if license + version + suffix in licensefiles.keys():
            (filename, licensename) = licensefiles[license + version + suffix]
            text += "\n .\n On Debian systems, the complete text of the " + licensename + \
                " can be found in `/usr/share/common-licenses/{}'.".format(filename)
    if abs(mode) >= 4: # output debug outputs
        if match_text:
            text += '\n### !!! M: {}'.format(match_text)
        if norm_text:
            text += '\n### !!! T: {}'.format(norm_text)
    return (licenseid, text)

#########################################################################################
def lc_sub(norm_text, mode):
    # check license for debug regex pattern
    # license_lines: license lines to be checked (list)
    # mode: license check mode
    # abs(mode) = 5 (single)
    # abs(mode) = 6 (combination)
    #####################################################################################
    text = ''
    for subx in list_sub:
        r = re.compile(eval_sub(subx), re.IGNORECASE)
        if r.search(norm_text):
            # match with regx
            text += '>>>>>>>> {} -> "{}"\n'.format(subx, r.search(norm_text).group())
            if abs(mode) >= 6:
                for suby in list_sub:
                    if subx != suby:
                        try:
                            r = re.compile(eval_sub(subx) + eval_sub(suby), re.IGNORECASE)
                            if r.search(norm_text):
                                # match with combination of subx + suby
                                text += '==== {} + {} => "{}"\n'.format(subx, suby, r.search(norm_text).group())
                        except:
                            pass
    return text
#########################################################################################
if __name__ == '__main__':
    import sys
    import os
    mode = 1
    argc = len(sys.argv)
    if argc == 1:
        print('Syntax: ' + argv[0] + ' [-][123456] file1 file2 ...')
    elif argc == 2:
        files = sys.argv[1:]
    elif argc >= 3:
        try:
            mode = int(sys.argv[1])
        except ValueError:
            files = sys.argv[1:]
        else:
            files = sys.argv[2:]
    else:
        print('lc.py file ...')
    for file in files:
        if os.path.isfile(file):
            with open(file, 'r') as f:
                license_lines = f.readlines()
            while(license_lines[0].strip() == ''):
                del license_lines[0]
            while(license_lines[-1].strip() == ''):
                del license_lines[-1]
            norm_text = normalize(license_lines)
            if abs(mode) <= 1: # like debmake -c etc.
                (licenseid, text) = lc(norm_text, license_lines, mode)
                print('{}\t=> {}'.format(file, licenseid))
            elif abs(mode) <= 4: # like debmake -c etc.
                print('File:    {}'.format(file))
                (licenseid, text) = lc(norm_text, license_lines, mode)
                print('License: {}{}\n'.format(licenseid, text))
            else: # abs(mode> => 5 for sunstring match to debug list_sub regex
                print('File:    {}'.format(file))
                print(lc_sub(norm_text, mode))

debmake-4.1.7/doc/0000775000175000017500000000000012416770056014164 5ustar  osamuosamu00000000000000debmake-4.1.7/doc/maint-guide.html0000664000175000017500000113465312416767353017300 0ustar  osamuosamu00000000000000




Debian Maintainers' Guide with debmake












This guide may be used under the terms the GNU General Public License version 2 or higher.


This guide was made using the following previous documents as its reference:


    

  • 

    
“Making a Debian Package (AKA the Debmake Manual)”, copyright © 1997 Jaldhar Vyas.

    

    • 

  • 

    
“The New-Maintainer’s Debian Packaging Howto”, copyright © 1997 Will Lowe.

    

    • 

  • 

    
“Debian New Maintainers' Guide”, copyright © 1998-2002 Josip Rodin, 2005-2014 Osamu Aoki, 2010 Craig Small, and 2010 Raphaël Hertzog.

    

    • 



Newer versions of this guide should always be available in the debmake package.


A short tutorial of the debmake command for the experienced Debian maintainer is available as Debmake tutorial.








Preface




If you are a somewhat experienced Debian user 
[You do need to know a little about Unix programming but you certainly don’t need to be a wizard. You can learn about the basic handling of a Debian system from the Debian Reference. It contains some pointers to learn about Unix programming, too.]
, you may have encountered following situations:


    

  • 

    
You wish to install a certain software package not yet found in the Debian archive.

    

    • 

  • 

    
You wish to update a Debian package with the newer upstream release.

    

    • 

  • 

    
You wish to fix bugs of a Debian package with some patches.

    

    • 



If you wanted to create a Debian package to fulfill these wishes and to share your work with the community, you are the target audience of this guide as a prospective Debian maintainer. 
[If you are not interested in sharing the Debian package, you can certainly work around your local situation by compiling and installing the fixed upstream source package into /usr/local/.]
  Welcome to the Debian community.


Debian has many social and technical rules and conventions to follow since it is a large volunteer organization with history.  Debian also has developed huge array of packaging tools and archive maintenance tools to build consistent set of binary packages addressing many technical objectives:


    

  • 

    
clean build under clearly specified package dependencies and patches

    

    • 

  • 

    
packages build across many architectures

    

    • 

  • 

    
optimal splits into multiple binary packages

    

    • 

  • 

    
smooth library transitions

    

    • 

  • 

    
security enhancement using specific compiler flags

    

    • 

  • 

    
multiarch support

    

    • 

  • 

    
…

    

    • 



These make it somewhat overwhelming for many new prospective Debian maintainers to get involved with Debian.  This guide tries to provide entry points for them to get started.  It describes as follows:


    

  • 

    
What you should know before getting involved with Debian as a prospective maintainer.

    

    • 

  • 

    
What it looks like to make a simple Debian package.

    

    • 

  • 

    
What kind of rules exist for making the Debian package.

    

    • 

  • 

    
Tips for making the Debian package.

    

    • 

  • 

    
Examples of making Debian packages for several typical scenarios.

    

    • 



The author felt limitations of updating the original “New Maintainers' Guide” with the dh-make package and decided to create an alternative tool and its matching document to address modern needs for the maintainers.  The result is the debmake package and this “Maintainers' Guide”.


Many chores and tips have been integrated into the debmake command making the description of the Debian packaging simple.  This allowed this document to offer more examples which were not available in the “New Maintainers' Guide”.







Caution


It takes many hours to properly create and maintain Debian packages. The Debian maintainer must be both technically competent and diligent to take up this challenge.





Some important topics are explained in detail.  Some of them may look irrelevant to you. Please be patient. Some corner cases are skipped.  Some topics are only covered by the external pointers.  These are intentional choices to keep this guide simple and maintainable.








Prerequisites




Here are the prerequisites which you need to understand before you to get involved with Debian.




People around Debian


There are several types of people interacting around Debian with different roles:


    

  • 

    
upstream author: the person who made the original program.

    

    • 

  • 

    
upstream maintainer: the person who currently maintains the program.

    

    • 

  • 

    
maintainer: the person making the Debian package of the program.

    

    • 

  • 

    
sponsor: a person who helps maintainers to upload packages to the official Debian package archive (after checking their contents).

    

    • 

  • 

    
mentor: a person who helps novice maintainers with packaging etc.

    

    • 

  • 

    
Debian Developer (DD): a member of the Debian project with full upload rights to the official Debian package archive.

    

    • 

  • 

    
Debian Maintainer (DM): a person with limited upload rights to the official Debian package archive.

    

    • 



Please note that you cannot become an official Debian Developer (DD) overnight, because it takes more than technical skill. Please do not be discouraged by this. If it is useful to others, you can still upload your package either as a maintainer through a sponsor or as a Debian Maintainer.


Please note that you do not need to create any new package to become an official Debian Developer. Contributing to the existing packages can provide a path to becoming an official Debian Developer too. There are many packages waiting for good maintainers (see [approaches]).






How to contribute


Please refer to the following to learn how to contribute to Debian:








Social dynamics of Debian


Please understand Debian’s social dynamics to prepare yourself for interactions with Debian:


    

  • 

    
We all are volunteers.

    

      

    • 

      
You cannot impose on others what to do.

      

      • 

    • 

      
You should be motivated to do things by yourself.

      

      • 

    

    • 

  • 

    
Friendly cooperation is the driving force.

    

      

    • 

      
Your contribution should not over-strain others.

      

      • 

    • 

      
Your contribution is valuable only when others appreciate it.

      

      • 

    

    • 

  • 

    
Debian is not your school where you get automatic attention of teachers.

    

      

    • 

      
You should be able to learn many things by yourself.

      

      • 

    • 

      
Attention from other volunteers is a very scarce resource.

      

      • 

    

    • 

  • 

    
Debian is constantly improving.

    

      

    • 

      
You are expected to make high quality packages.

      

      • 

    • 

      
You should adapt yourself to change.

      

      • 

    

    • 



Since we focus only on the technical aspects of the packaging in the rest of this guide, please refer to the following to understand the social dynamics of Debian:








Technical reminders


Here are some technical reminders to accommodate other maintainers to work on your package easily and effectively to maximize the output of Debian as a whole.


    

  • 

    
Make your package easy to debug.

    

      

    • 

      
Keep your package simple.

      

      • 

    • 

      
Don’t over-engineer your package.

      

      • 

    

    • 

  • 

    
Keep your package well-documented.

    

      

    • 

      
Use readable code style.

      

      • 

    • 

      
Make comments in code.

      

      • 

    • 

      
Format code consistently.

      

      • 

    • 

      
Maintain the git repository 
      [The overwhelming number of Debian maintainers use git over other VCS systems such as hg, bzr, etc.]
       of the package.

      

      • 

    

    • 








Note


Debugging of software tends to consume more time than writing the initial working software.









Debian documentation


Please make yourself ready to read the pertinent part of the official Debian documentation together with this guide as needed to generate perfect Debian packages:




If this guide contradicts with the official Debian documentation, they are correct. Please file a bug report on the debmake package using the reportbug command.


Here are alternative tutorial documents which you may read along with this guide:








Help resources


Before you decide to ask your question in some public place, please do your part of efforts, i.e., read the fine documentation:




Your desired information can be found effectively by using the well formed search string such as "keyword site:lists.debian.org" to limit the search domain of the web search engine.


Making a small test package is a good way to learn details of the packaging. Inspecting existing well maintained packages is the best way to learn how other people make packages.


If you still have questions about the packaging, you can ask them interactively:




The more experienced Debian developers will gladly help you, if you ask properly after making your required efforts.






Archive situation


Please realize the situation of the Debian archive.


    

  • 

    
Debian already has packages for most kinds of programs.

    

    • 

  • 

    
The number of packages already in the Debian archive is several tens of times greater than that of active maintainers.

    

    • 

  • 

    
Unfortunately, some packages lack appropriate level of attention by the maintainer.

    

    • 



Thus, contributions to packages already in the archive are far more appreciated (and more likely to receive sponsorship for the uploading) by other maintainers.







Tip


The wnpp-alert command from the devscripts package can check for installed packages up for adoption or orphaned.









Contribution approaches


Here is a pseudo-Python code for your contribution approaches to Debian with a program:


    

  • 

    
if exist_in_debian(program):

    

      

    • 

      
if is_team_maintained(program):

      

        

      • 

        
join_team(program)

        

        • 

      

      • 

    • 

      
if is_orphaned(program) : # maintainer: Debian QA Group

      

        

      • 

        
adopt_it(program)

        

        • 

      

      • 

    • 

      
elif is_RFA(program) : # Request for Adoption

      

        

      • 

        
adopt_it(program)

        

        • 

      

      • 

    • 

      
else:

      

        

      • 

        
if need_help(program):

        

          

        • 

          
contact_maintainer(program)

          

          • 

        • 

          
triaging_bugs(program)

          

          • 

        • 

          
preparing_QA_or_NMU_uploads(program)

          

          • 

        

        • 

      • 

        
else:

        

          

        • 

          
leave_it(program)

          

          • 

        

        • 

      

      • 

    

    • 

  • 

    
else: # new packages

    

      

    • 

      
if not is_good_program(program):

      

        

      • 

        
give_up_packaging(program)

        

        • 

      

      • 

    • 

      
elif not is_it_distributable(program):

      

        

      • 

        
give_up_packaging(program)

        

        • 

      

      • 

    • 

      
else: # worth packaging

      

        

      • 

        
if is_ITPed_by_others(program):

        

          

        • 

          
if need_help(program):

          

            

          • 

            
contact_ITPer_for collaboration(program)

            

            • 

          

          • 

        • 

          
else:

          

            

          • 

            
leave_it(program)

            

            • 

          

          • 

        

        • 

      • 

        
else: # really new

        

          

        • 

          
if is_there_team(program):

          

            

          • 

            
join_team(program)

            

            • 

          

          • 

        • 

          
if is_it_DSFG(program) and is_its_dependency_DFSG(program):

          

            

          • 

            
file_ITP(program, area="main") # This is Debian.

            

            • 

          

          • 

        • 

          
elif is_it_DSFG(program):

          

            

          • 

            
file_ITP(program, area="contrib") # This is not Debian.

            

            • 

          

          • 

        • 

          
else: # non-DFSG

          

            

          • 

            
file_ITP(program, area="non-free") # This is not Debian.

            

            • 

          

          • 

        • 

          
package_it_and_close_ITP(program)

          

          • 

        

        • 

      

      • 

    

    • 



Here:




You either need to file an ITP or adopt a package to start working on it.  See the “Debian Developer’s Reference”:






novice maintainer


The novice maintainer should avoid packaging programs with the high security exposure:


    

  • 

    
setuid or setgid program

    

    • 

  • 

    
daemon program

    

    • 

  • 

    
program installed in the /sbin/ or /usr/sbin/ directories

    

    • 



When you gain more experience in packaging, you’ll be able to package such programs.












Tool Setups




The build-essential package must be installed in the build environment.


The devscripts package should be installed on the maintainer environment.


Although this is not necessary the absolute requirement, it is a good idea to install and setup all of the popular set of packages mentioned in this chapter on the maintainer environment.  This enables us to share the common baseline working environment.


Please install the tools mentioned in the Overview of Debian Maintainer Tools of the “Debian Developer’s Reference”, as needed, too.







Caution


Tool setups presented here are only meant as an example and may not be up-to-date with the latest packages on the system.  Debian development is a moving target.  Please make sure to read the pertinent documentation and update the configuration as needed.







Email address


Various Debian maintenance tools recognize your email address and name to use by the shell environment variables $DEBEMAIL and $DEBFULLNAME.


Let’s setup these packages by adding the following lines to ~/.bashrc 
[This assumes you are using Bash as your login shell. If you use some other login shell such as Z shell, use their corresponding configuration files instead of ~/.bashrc.]
.




Add to the ~/.bashrc file




DEBEMAIL="your.email.address@example.org"
DEBFULLNAME="Firstname Lastname"
export DEBEMAIL DEBFULLNAME








mc


The mc command offers very easy ways to manage files.  It can open the binary deb file to check its content by pressing the Enter key over the binary deb file.  It uses the dpkg-deb command as its back-end.  Let’s setup it to support easy chdir as follows.




Add to the ~/.bashrc file




# mc related
export HISTCONTROL=ignoreboth
. /usr/lib/mc/mc.sh








git


Nowadays, the git command is the essential tool to manage the source tree with history.


You may wish to set several global configuration in ~/.gitconfig such as your name and email address used by Git by the following.






$ git config --global user.name "Name Surname"
$ git config --global user.email yourname@example.com




If you are too accustomed to the CVS or Subversion commands, you may wish to set several command aliases by the following.






$ git config --global alias.ci "commit -a"
$ git config --global alias.co checkout




You can check your global configuration by the following.






$ git config --global --list









Tip


It is essential to use the gitk command to work effectively with the history of the Git repository.









quilt


The quilt command offers a basic method for recording modifications. For the Debian packaging, it should be customized to record modifications in the debian/patches/ directory instead of its default patches/ directory.


In order to avoid changing the behavior of the quilt command itself, let’s create an alias dquilt for the Debian packaging by adding the following lines to the ~/.bashrc file. The second line provides the same shell completion feature of the quilt command to the dquilt command.




Add to the ~/.bashrc file




alias dquilt="quilt --quiltrc=${HOME}/.quiltrc-dpkg"
complete -F _quilt_completion $_quilt_complete_opt dquilt




Then let’s create ~/.quiltrc-dpkg as follows.






d=.
while [ ! -d $d/debian -a `readlink -e $d` != / ];
    do d=$d/..; done
if [ -d $d/debian ] && [ -z $QUILT_PATCHES ]; then
    # if in Debian packaging tree with unset $QUILT_PATCHES
    QUILT_PATCHES="debian/patches"
    QUILT_PATCH_OPTS="--reject-format=unified"
    QUILT_DIFF_ARGS="-p ab --no-timestamps --no-index --color=auto"
    QUILT_REFRESH_ARGS="-p ab --no-timestamps --no-index"
    QUILT_COLORS="diff_hdr=1;32:diff_add=1;34:" + \
            "diff_rem=1;31:diff_hunk=1;33:diff_ctx=35:diff_cctx=33"
    if ! [ -d $d/debian/patches ]; then mkdir $d/debian/patches; fi
fi




See quilt(1) and How To Survive With Many Patches or Introduction to Quilt on how to use the quilt command.


See [modpkg] for example usages.






devscripts


The debsign command, included in the devscripts package, is used to sign the Debian package with your private GPG key.


The debuild command, included in the devscripts package, builds the binary package and check them with the lintian command.  It is useful to have verbose outputs from the lintian command.


You can setup these by the ~/.devscripts as follows.






DEBUILD_DPKG_BUILDPACKAGE_OPTS="-i -us -uc"
DEBUILD_LINTIAN_OPTS="-i -I --show-overrides"
DEBSIGN_KEYID="Your_GPG_keyID"




Currently, RSA key with 4096 bits is good idea.  See Creating a new GPG key.






pbuilder


The pbuilder package provides the clean room (chroot) build environment. 
[The sbuild package provides an alternative chroot platform.]


Let’s customize it with several helper packages.


    

  • 

    
The cowbuilder package to boost the chroot creation speed.

    

    • 

  • 

    
The eatmydata package to boost the dpkg speed.

    

    • 

  • 

    
The ccache package to boost the gcc speed.

    

    • 

  • 

    
The parallel make to boost the build speed.

    

    • 

  • 

    
The lintian package to find bugs in the package.

    

    • 

  • 

    
The bash, mc, and vim packages in case build fails.

    

    • 



Let’s create ~/.pbuilderrc as follows.






AUTO_DEBSIGN="${AUTO_DEBSIGN:-no}"
PDEBUILD_PBUILDER=cowbuilder
HOOKDIR="/var/cache/pbuilder/hooks"
#MIRRORSITE=" http://ftp.us.debian.org/debian/"
MIRRORSITE="http://cdn.debian.net/debian/"
#APTCACHE=/var/cache/pbuilder/aptcache
APTCACHE=/var/cache/apt/archives
#BUILDRESULT=/var/cache/pbuilder/result/
BUILDRESULT=../
EXTRAPACKAGES="ccache lintian eatmydata"
# enable eatmydata for pbuilder
if [ -z "$LD_PRELOAD" ]; then
  LD_PRELOAD=/usr/lib/libeatmydata/libeatmydata.so
else
  LD_PRELOAD="$LD_PRELOAD":/usr/lib/libeatmydata/libeatmydata.so
fi
export LD_PRELOAD
# enable ccache for pbuilder
export PATH="/usr/lib/ccache:${PATH}"
export CCACHE_DIR="/var/cache/pbuilder/ccache"
BINDMOUNTS="${CCACHE_DIR}"
# parallel make
DEBBUILDOPTS=-j8









Note


The parallel make may fail for some existing packages.





Let’s create a hook scripts as follows.


/var/cache/pbuilder/hooks/A10ccache






#!/bin/sh
set -e
# increase the ccache caching size
ccache -M 4G
# output the current statistics
ccache -s




/var/cache/pbuilder/hooks/B90lintian






#!/bin/sh
set -e
apt-get -y --force-yes install lintian
echo "+++ lintian output +++"
su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes; :" -l pbuilder
echo "+++ end of lintian output +++"




/var/cache/pbuilder/hooks/C10shell






#!/bin/sh
set -e
apt-get -y --force-yes install vim bash mc
# invoke shell if build fails
cd /tmp/buildd/*/debian/..
/bin/bash < /dev/tty > /dev/tty 2> /dev/tty









Note


All these scripts need to be set world executable: -rwxr-xr-x 1 root root.










Note


The ccache cache directory /var/cache/pbuilder/ccache needs to be set world writable: -rwxrwxrwx 1 root root for the pbuilder command.  You should be aware of associated security concerns.









git-buildpackage


You may wish to set several global configuration in ~/.gbp.conf






# Configuration file for "gbp <command>"

[DEFAULT]
# the default build command:
builder = git-pbuilder -i -I -us -uc
# use pristine-tar:
pristine-tar = True
# Use color when on a terminal, alternatives: on/true, off/false or auto
color = auto









Tip


The gbp command is the alias of the git-buildpackage command.









HTTP proxy


You should set up local HTTP caching proxy to save the bandwidth for the Debian package repository access.  There are several choices:


    

  • 

    
Simple HTTP caching proxy using the squid package.

    

    • 

  • 

    
Specialized HTTP caching proxy using the apt-cacher-ng package.

    

    • 







Private Debian repository


You can set up a private Debian package repository with the reprepro package.










Simple Debian package




There is an old Latin saying: “Longum iter est per praecepta, breve et efficax per exempla” (“It’s a long way by the rules, but short and efficient with examples”).


Let’s start with an example of creating a simple Debian package.




hello-c


Let’s consider a simple C source hello-c with the upstream version 1.0 following the $(DESTDIR) feature of the GNU Coding Standards and FHS for the file installation path as an example.


The C source hello.c is a very simple one.






 $ cat hello-c-1.0/hello.c
#include <stdio.h>
int
main()
{
        printf("Hello, Debian packager!\n");
        return 0;
}




Makefile supports $(DESTDIR) and FHS.






 $ cat hello-c-1.0/Makefile
all: hello

hello: hello.c
        gcc -Wall -o hello hello.c

install: hello
        install -D hello $(DESTDIR)/usr/bin/hello

clean:
        -rm -f hello

distclean: clean

.PHONY: all install clean distclean








hello-c-1.0.tar.gz


Let’s make an upstream tarball hello-c-1.0.tar.gz.






 $ tar -czf hello-c-1.0.tar.gz hello-c-1.0
 $ tree
.
├── hello-c-1.0
│   ├── hello.c
│   └── Makefile
└── hello-c-1.0.tar.gz

1 directory, 3 files








debmake


The debmake command is the helper script for the Debian packaging. Let’s note its 4 most important features. 
[See Debmake tutorial for the extensive list of features.]


    

  • 

    
It always sets most of the obvious option states and values to reasonable defaults.

    

    • 

  • 

    
It doesn’t overwrite existing configuration files in the debian/ directory.

    

    • 

  • 

    
It supports the multiarch package.

    

    • 

  • 

    
It creates good template files such as the debian/copyright file complaint to DEP-5.

    

    • 



These 4 features make Debian packaging simple and modern.  Let’s use this debmake command.






Big picture


Let’s get the big picture for the making of the Debian package from the upstream tarball hello-c-1.0.tar.gz.


A single non-native Debian binary package can be made with the debmake command as follows.






 $ cd hello-c-1.0
 $ debmake
   ... (skipped)
 $ debuild









Tip


The debuild command in these examples may be substituted by the equivalent commands such as the pdebuild command.





Since manual adjustments of auto-generated configuration files are skipped, the generated binary package lacks meaningful package description and some of the policy requirements are missed.  This package functions well under the dpkg command, and is good enough for your local deployment.






debmake: step-by-step


The output from the debmake command was intentionally skipped in the above.  The actual command output is very verbose and explains what it does as follows.






 $ cd hello-c-1.0
 $ debmake
D: /usr/bin/debmake started
D: PYTHONPATH = /usr/bin:/usr/lib/python3.4:/usr/lib/python3.4/plat-x86_64-...
I: set parameters
I: sanity check of parameters
I: pkg="hello-c", ver="1.0", rev="1"
I: *** start packaging in "hello-c-1.0". ***
I: provide hello-c_1.0.orig.tar.gz for non-native Debian package
I: pwd = "/path/to"
I: $ ln -sf hello-c-1.0.tar.gz hello-c_1.0.orig.tar.gz
I: pwd = "/path/to/hello-c-1.0"
I: parse binary package settings:
I: binary package=hello-c Type=bin / Arch=any M-A=foreign
I: analyze the source tree
I: build_type = make
I: scan source for copyright+license text and file extensions
I: 100 %, ext = c
I: check_all_licenses
I: ..
I: check_all_licenses completed for 2 files.
I: bunch_all_licenses
I: format_all_licenses
I: make debian/* template files
I: single binary package
I: debmake -x "1" ...
I: creating => debian/control
I: creating => debian/copyright
I: creating => debian/changelog
I: creating => debian/rules
I: creating => debian/README.Debian
I: creating => debian/compat
I: creating => debian/watch
I: creating => debian/source/format
I: creating => debian/source/local-options
I: creating => debian/patches/series
I: run "debmake -x2" to get more template files
I: $ wrap-and-sort




The debmake command generates all these template files based on the command line option.  Since no options are specified, the debmake command choses reasonable default values for you:


    

  • 

    
The source package name: hello-c

    

    • 

  • 

    
The upstream version: 1.0

    

    • 

  • 

    
The binary package name: hello-c

    

    • 

  • 

    
The Debian revision: 1

    

    • 

  • 

    
The package type: bin (the ELF binary executable package)

    

    • 

  • 

    
The -x option: -x1 (default for the single binary package)

    

    • 



Let’s inspect generated template files.


The debian/rules file is the build script provided by the package maintainer.




debian/rules:




 $ cat debian/rules
#!/usr/bin/make -f
### See debhelper(7) (uncomment to enable)
### This is a autogenerated template for debian/rules.
### You must remove unused comment lines for the released package.
###
### Output every command that modifies files on the build system.
#DH_VERBOSE = 1
###
### Define DEB_HOST_* and  DEB_BUILD_* variables using
### dpkg-architecture(1) if they are used in this file. E.g.:
###DEB_HOST_MULTIARCH = $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)
###DEB_HOST_ARCH_OS = $(shell dpkg-architecture -qDEB_HOST_ARCH_OS)
###
### Copy some variable definitions from pkg-info.mk and vendor.mk
### under /usr/share/dpkg/ to here if they are useful.
###
### See FEATURE AREAS in dpkg-buildflags(1)
#export DEB_BUILD_MAINT_OPTIONS = hardening=+all
###
### See ENVIRONMENT in dpkg-buildflags(1)
### Package maintainers to append CFLAGS
#export DEB_CFLAGS_MAINT_APPEND  = -Wall -pedantic
### Package maintainers to append LDFLAGS
#export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed

### main packaging script based on dh7 syntax
%:
        dh $@

### debmake generated override targets
### This is example for Cmake (See http://bugs.debian.org/641051 )
###override_dh_auto_configure:
###     dh_auto_configure -- \
###     -DCMAKE_LIBRARY_PATH=$(DEB_HOST_MULTIARCH)




This is essentially the standard debian/rules file with the dh command. (There are some commented out contents for you to customize it.)







Tip


Configuration files used by the dh_* commands from the debhelper package usually treat # as the start of the comment line.





The debian/control file provides the main meta data for the Debian package.




debian/control:




 $ cat debian/control
Source: hello-c
Section: unknown
Priority: extra
Maintainer: "Firstname Lastname" <email.address@example.org>
Build-Depends: debhelper (>=9)
Standards-Version: 3.9.5
Homepage: <insert the upstream URL, if relevant>

Package: hello-c
Architecture: any
Multi-Arch: foreign
Depends: ${misc:Depends}, ${shlibs:Depends}
Description: auto-generated package by debmake
 This Debian binary package was auto-generated by the
 debmake(1) command provided by the debmake package.
 .
 ===== This comes from the unmodified template file =====
 .
 Please edit this template file (debian/control) and other package files
 (debian/*) to make them meet all the requirements of the Debian Policy
 before uploading this package to the Debian archive.
 .
 See
  * http://www.debian.org/doc/manuals/maint-guide/dreq.en.html#control
  * http://www.debian.org/doc/manuals/developers-reference/best-pkging-prac...
 .
 The synopsis description at the top should be about 60 characters and
 written as a phrase.  No extra capital letters or a final period.  No
 articles — "a", "an", or "the".
 .
 The package description for general-purpose applications should be
 written for a less technical user.  This means that we should avoid
 jargon.  GNOME or KDE is fine but GTK+ is probably not.
 .
 Use the canonical forms of words:
  * Use X Window System, X11, or X; not X Windows, X-Windows, or X Window.
  * Use GTK+, not GTK or gtk.
  * Use GNOME, not Gnome.
  * Use PostScript, not Postscript or postscript.




Since this is the ELF binary executable package, the debmake command sets "Architecture: any" and "Multi-Arch: foreign".  Also, it sets required substvar parameters as "Depends: ${shlibs:Depends}, ${misc:Depends}".  These are explained in [deb].







Note


Please note this debian/control file uses the RFC-822 style as documented in 5.2 Source package control files — debian/control of the “Debian Policy Manual”. The use of the empty line and the leading space are significant.





There are several other template files under the debian/ directory.  These are explained in [deb].




The source tree after the basic debmake execution.




 $ cd ..
 $ tree
.
├── hello-c-1.0
│   ├── debian
│   │   ├── changelog
│   │   ├── compat
│   │   ├── control
│   │   ├── copyright
│   │   ├── patches
│   │   │   └── series
│   │   ├── README.Debian
│   │   ├── rules
│   │   ├── source
│   │   │   ├── format
│   │   │   └── local-options
│   │   └── watch
│   ├── hello.c
│   └── Makefile
├── hello-c_1.0.orig.tar.gz -> hello-c-1.0.tar.gz
└── hello-c-1.0.tar.gz

4 directories, 14 files




For the proper packaging, you are required to make further modification here.


For learning purpose, let’s leave such details and move on for now.






debuild: step-by-step


You can create a non-native Debian package using the debuild command (or its equivalents) in this source tree.  The command output is very verbose and explains what it does as follows.






 $ cd hello-c-1.0
 $ debuild
 dpkg-buildpackage -rfakeroot -D -us -uc -i
 ...
 fakeroot debian/rules clean
dh clean
 ...
 debian/rules build
dh build
 ...
 fakeroot debian/rules binary
dh binary
 ...
Finished running lintian.









Tip


If you wish a more fine grained build report, please uncomment "#DH_VERBOSE = 1" in the debian/rules file before running the debuild command.





Let’s inspect the result.




The generated files of hello-c version 1.0 by the debuild command:




 $ cd ..
 $ tree -L 1
.
├── hello-c-1.0
├── hello-c_1.0-1_amd64.build
├── hello-c_1.0-1_amd64.changes
├── hello-c_1.0-1_amd64.deb
├── hello-c_1.0-1.debian.tar.xz
├── hello-c_1.0-1.dsc
├── hello-c_1.0.orig.tar.gz -> hello-c-1.0.tar.gz
└── hello-c-1.0.tar.gz

1 directory, 7 files




You see all the generated files.


    

  • 

    
The hello-c_1.0.orig.tar.gz is a symlink to the upstream tarball.

    

    • 

  • 

    
The hello-c_1.0-1.debian.tar.xz contains the maintainer generated contents.

    

    • 

  • 

    
The hello-c_1.0-1.dsc is the meta data file for the Debian source package.

    

    • 

  • 

    
The hello-c_1.0-1_amd64.deb is the Debian binary package.

    

    • 

  • 

    
The hello-c_1.0-1_amd64.changes is the meta data file for the Debian binary package.

    

    • 



The hello-c_1.0-1.debian.tar.xz contains the Debian changes to the upstream source as follows.




The compressed archive contents of hello-c_1.0-1.debian.tar.xz:




 $ tar -tJf hello-c_1.0-1.debian.tar.xz
debian/
debian/patches/
debian/patches/series
debian/control
debian/changelog
debian/rules
debian/source/
debian/source/format
debian/README.Debian
debian/compat
debian/watch
debian/copyright
 $ tar -tzf hello-c-1.0.tar.gz
hello-c-1.0/
hello-c-1.0/Makefile
hello-c-1.0/hello.c




The hello-c_1.0-1_amd64.deb contains the files to be installed as follows.




The binary package contents of hello-c_1.0-1_amd64.deb:




 $ dpkg -c hello-c_1.0-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/bin/
-rwxr-xr-x root/root ...  ./usr/bin/hello
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/hello-c/
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/changelog.Debian.gz
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/README.Debian
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/copyright









Caution


Much more details need to be addressed before uploading the package to the Debian archive.













Debian Package




It’s time to learn the basic rules of the Debian packaging.


The Debian source package is a set of input files used to build the Debian binary package and is not a single file.


The Debian binary package is a special archive file which holds a set of installable binary data with their associated information.


A single Debian source package may generate multiple Debian binary packages defined in the debian/control file.


The non-native Debian package in the "3.0 (quilt)" format is the most normal Debian binary package format.


Some people promote to package even programs which have been written especially for Debian in the non-native package format with the above workflow while generating the required tarball without debian/* files by oneself in advance. They claim that the use of non-native package format eases communication with the downstream distributions.




Packaging workflow


The Debian packaging workflow to create the Debian binary package involves generating several specifically named files (see [name-version]) as defined in the “Debian Policy Manual”.


The oversimplified method for the Debian packaging workflow can be summarized in 5 steps as follows.


    

  1. 

    
The upstream tarball is downloaded as the package-version.tar.gz file.

    

    2. 

  2. 

    
The upstream tarball is untared to create many files under the package-version/ directory.

    

    3. 

  3. 

    
The upstream tarball is copied (or symlinked) to the particular filename packagename_version.orig.tar.gz.

    

      

    • 

      
the character separating package and version is changed from - (hyphen) to _ (underscore)

      

      • 

    • 

      
.orig is added in the file extension.

      

      • 

    

    4. 

  4. 

    
The Debian package specification files are added to the upstream source under the package-version/debian/ directory.

    

      

    • 

      
Required specification files under the debian/*:

      

      

      
debian/rules

      

      

      
The executable script for building the Debian package (see [rules])

      

      

      
debian/control

      

      

      
The package configuration file containing the source package name, the source build dependency, the binary package name, the binary dependency, etc. (see [control])

      

      

      
debian/changelog

      

      

      
The Debian package history file defining the upstream package version and the Debian revision in its first line (see [changelog])

      

      

      
debian/copyright

      

      

      
The copyright and license summary (see [copyright])

      

      

      

      • 

    • 

      
Optional specification files under the debian/* (see [debianconf]):

      

      • 

    • 

      
The debmake command invoked in the package-version/ directory provides the initial set of these template configuration files.

      

        

      • 

        
Required specification files are generated even with the -x0 option.

        

        • 

      • 

        
The debmake command does not overwrite any existing configuration files.

        

        • 

      

      • 

    • 

      
These files must be manually edited to their perfection according to the “Debian Policy Manual” and “Debian Developer’s Reference”.

      

      • 

    

    5. 

  5. 

    
The dpkg-buildpackage command (usually from its wrapper debuild or pdebuild) is invoked in the package-version/ directory to make the Debian source and binary packages by invoking the debian/rules script.

    

      

    • 

      
The current directory is set as: $(CURDIR)=/path/to/package-version/

      

      • 

    • 

      
Create the Debian source package in "3.0 (quilt)" format using dpkg-source(1)

      

        

      • 

        
package_version.orig.tar.gz (copy or symlink of package-version.tar.gz)

        

        • 

      • 

        
package_version-revision.debian.tar.xz (tarball of package-version/debian/*)

        

        • 

      • 

        
package_version-revision.dsc

        

        • 

      

      • 

    • 

      
Build the source using "debian/rules build" into $(DESTDIR)

      

        

      • 

        
DESTDIR=debian/binarypackage/ (single binary package)

        

        • 

      • 

        
DESTDIR=debian/tmp/ (multi binary package)

        

        • 

      

      • 

    • 

      
Create the Debian binary package using dpkg-deb(1), and dpkg-genchanges(1).

      

        

      • 

        
binarypackage_version-revision_arch.deb

        

        • 

      • 

        
… (There may be multiple Debian binary package files.)

        

        • 

      • 

        
package_version-revision_arch.changes

        

        • 

      

      • 

    

    6. 

  6. 

    
Check the quality of the Debian package with the lintian command. (recommemded)

    

    

    7. 

  7. 

    
Sign the package_version-revision.dsc and package_version-revision_arch.changes with the debsign command using your private GPG key.

    

    8. 

  8. 

    
Upload the set of the Debian source and binary package files with the dput command to the Debian archive.

    

    9. 



Here, please replace each part of the filename as:


    

  • 

    
the package part with the Debian source package name

    

    • 

  • 

    
the binarypackage part with the Debian binary package name

    

    • 

  • 

    
the version part with the upstream version

    

    • 

  • 

    
the revision part with the Debian revision

    

    • 

  • 

    
the arch part with the package architecture

    

    • 








Tip


There is very extensive documentation in Chapter 6. Best Packaging Practices of the “Debian Developer’s Reference”.  Please read it.









Package name and version


If the upstream source comes as hello-0.9.12.tar.gz, you can take hello as the upstream source package name and 0.9.12 as the upstream version.


debmake is meant to provide template files for the package maintainer to work on.  Comment lines started by ### are the tutorial text.  You must remove or edit such comment lines before uploading to the Debian archive.


There  are some limitations for what characters may be used as a part of the Debian package.  The most notable limitation is the prohibition of uppercase letters in the package name.  Here is the summary in the regular expression.


    

  • 

    
Upstream package name (-p): [-+.a-z0-9]{2,}

    

    • 

  • 

    
Binary package name (-b): [-+.a-z0-9]{2,}

    

    • 

  • 

    
Upstream version (-u): [0-9][-+.:~a-z0-9A-Z]*

    

    • 

  • 

    
Debian revision (-r): [0-9][+.~a-z0-9A-Z]*

    

    • 



See the exact definition in Chapter 5 - Control files and their fields of the “Debian Policy Manual”.


You must adjust the package name and upstream version accordingly for the Debian packaging.


In order to manage the package name and version information effectively under popular tools such as the aptitude command, it is a good idea to keep the length of package name to be equal or less than 30 characters; and the total length of version and revision to be equal or less than 14 characters. 
[For more than 90% of packages, the package name is equal or less than 24 characters; the upstream version is equal or less than 10 characters and the Debian revision is equal or less than 3 characters.]


In order to avoid name collisions, the user visible binary package name should not be chosen from any generic words.


If upstream does not use a normal versioning scheme such as 2.30.32 but uses some kind of date such as 11Apr29, a random codename string, or a VCS hash value as part of the version, make sure to remove them from the upstream version. Such information can be recorded in the debian/changelog file. If you need to invent a version string, use the YYYYMMDD format such as 20110429 as upstream version. This ensures that dpkg interprets later versions correctly as upgrades. If you need to ensure smooth transition to the normal version scheme such as 0.1 in future, use the 0~YYMMDD format such as 0~110429 as upstream version, instead.


Version strings can be compared using the dpkg command as follows.






$ dpkg --compare-versions ver1 op ver2




The version comparison rule can be summarized as:


    

  • 

    
Strings are compared from the head to the tail.

    

    • 

  • 

    
Letters are larger than digits.

    

    • 

  • 

    
Numbers are compared as integers.

    

    • 

  • 

    
Letters are compared in ASCII code order.

    

    • 



There are special rules for period (.), plus (+), and tilde (~) characters, as follows.






0.0 < 0.5 < 0.10 < 0.99 < 1 < 1.0~rc1 < 1.0 < 1.0+b1 < 1.0+nmu1 < 1.1 < 2.0




One tricky case occurs when upstream releases hello-0.9.12-ReleaseCandidate-99.tar.gz as the pre-release of hello-0.9.12.tar.gz. You can ensure the upgrade to work properly by renaming the upstream source to hello-0.9.12~rc99.tar.gz having the proper version order.






debian/rules


The debian/rules script is the executable script to build the Debian package.


    

  • 

    
The debian/rules script re-targets the upstream build system (see [build]) to install files in the $(DESTDIR) and creates the archive file of the generated files as the deb file.

    

      

    • 

      
The deb file is used for the binary distribution and installed to the system using the dpkg command.

      

      • 

    

    • 

  • 

    
The dh command is normally used as the front-end to the build system inside the debian/rules script.

    

    • 

  • 

    
$(DESTDIR) path depends on the build type.

    

      

    • 

      
$(DESTDIR)=debian/binarypackage  (single binary package)

      

      • 

    • 

      
$(DESTDIR)=debian/tmp  (multiple binary package)

      

      • 

    

    • 





dh


The dh command from the debhelper package with the help from its associated packages functions as the wrapper to the typical upstream build systems and offers us with the uniform access to them by supporting all the Debian policy stipulated targets of the debian/rules file.


    

  • 

    
dh clean : clean files in the source tree.

    

    • 

  • 

    
dh build : build the source tree

    

    • 

  • 

    
dh build-arch : build the source tree for architecture dependent packages

    

    • 

  • 

    
dh build-indep : build the source tree for architecture independent packages

    

    • 

  • 

    
dh install : install the binary files to $(DESTDIR)

    

    • 

  • 

    
dh install-arch : install the binary files to $(DESTDIR) for architecture dependent packages

    

    • 

  • 

    
dh install-indep : install the binary files to $(DESTDIR) for architecture independent packages

    

    • 

  • 

    
dh binary : generate the deb file

    

    • 

  • 

    
dh binary-arch : generate the deb file for architecture dependent packages

    

    • 

  • 

    
dh binary-indep : generate the deb file for architecture independent packages

    

    • 








Note


The dh command exports compiler flags (CFLAGS, CXXFLAGS, FFLAGS, CPPFLAGS and LDFLAGS) with values as returned by dpkg-buildflags.









Simple debian/rules


Thanks to this abstraction of the dh command 
[This simplicity is available since the version 7 of the debhelper package.  This guide assumes the use of the debhelper version 9 or newer.]
, the Debian policy compliant debian/rules file supporting all the required targets can be written as simple as 
[The debmake command generates a bit more complicated debian/rules file.  But this is the core part.]
:




Simple debian/rules:




#!/usr/bin/make -f
#DH_VERBOSE = 1

%:
        dh $@




Essentially, this dh command functions as the sequencer to call all required dh_* commands at the right moment.







Note


The debmake command sets the debian/control file with "Build-Depends: debhelper (>=9)".










Tip


Setting "DH_VERBOSE = 1" outputs every command that modifies files on
the build system.  Also it enables verbose build logs for some build systems.









Customized debian/rules


Flexible customization of the debian/rules is realized by adding appropriate override_dh_* targets and their rules.


Whenever some special operation is required for a certain dh_foo command invoked by the dh command, any automatic execution of it can be overridden by adding the makefile target override_dh_foo in the debian/rules file.


The debmake command creates the initial template file taking advantage of the above simple debian/rules while adding some extra customizations for the package hardening, etc.


You need to know how underlying build systems work under the hood (see [build]) to address their irregularities using the package customization.


See [simple] for the actual simple debian/rules generated by the debmake command which comes with the commented out parts addressing the hardening via compile options (see [harden]) and the multiarch customization (see [multiarch]).






Variables for debian/rules


Some variable definitions useful for customizing debian/rules can be found in files under /usr/share/dpkg/.  Notably:





pkg-info.mk






  DEB_SOURCE, DEB_VERSION, DEB_VERSION_EPOCH_UPSTREAM, DEB_VERSION_UPSTREAM_REVISION, DEB_VERSION_UPSTREAM, and DEB_DISTRIBUTION variables.
 

  These are useful for the backport support etc..






vender.mk






  DEB_VENDOR and DEB_PARENT_VENDOR variables; and dpkg_vendor_derives_from macro.
 

  These are useful for the vendor support (Debian, Ubuntu, …).






architecture.mk






  Set DEB_HOST_* and  DEB_BUILD_* variables.
 

  Only variables used explicitly in debian/rules need to be defined using dpkg-architecture.  So there is no need to include architecture.mk in debian/rules.






buildflags.mk






  Set CFLAGS, CPPFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, GCJFLAGS, FFLAGS, FCFLAGS, and LDFLAGS buildflag variables.
 

  These are normally exported by dh for the script in the override_** target.  So there is no need to include buildflags.mk in debian/rules.







If you wish to use some of these useful variables in debian/rules, copy relevant codes to debian/rules or write simpler alternatives in it.  Please keep debian/rules simple.


For example, you can add an extra option to CONFIGURE_FLAGS for linux-any target architectures by adding the followings to debian/rules:






DEB_HOST_ARCH_OS = $(shell dpkg-architecture -qDEB_HOST_ARCH_OS)
 ...
ifeq ($(DEB_HOST_ARCH_OS),linux)
CONFIGURE_FLAGS += --enable-wayland
endif




See [multiarch], dpkg-architecture(1) and dpkg-buildflags(1).








debian/control


The debian/control file consists of blocks of meta data separated by the blank line.  Each block of meta data defines the following in this order:


    

  • 

    
meta data for the Debian source package

    

    • 

  • 

    
meta data for the Debian binary packages

    

    • 



The debmake command with the -b option (see [boption]) creates the initial template debian/control file with followings:


    

  • 

    
a set of Package stanzas defining the split of the Debian binary packages

    

    • 

  • 

    
a basic set of substvar used in each pertinent stanza

    

    • 





Split of the Debian binary package


For well behaving build systems, the split of the Debian binary package into small ones can be realized as follows.


    

  • 

    
Create binary package entries for all binary packages in the debian/control file.

    

    • 

  • 

    
List all file paths (relative to debian/tmp) in the corresponding debian/binarypackage.install files.

    

    • 



Please check examples in this guide:


    

  • 

    
[multipkg] (simple multi binary package example)

    

    • 

  • 

    
[librarypkg] (library related multi binary package example)

    

    • 







Substvar


The debian/control file also defines the package dependency in which the variable substitutions mechanism (substvar) may be used.  See deb-substvars(5).


The debmake command supports following substvars.


    

  • 

    
${misc:Depends} for all binary packages

    

    • 

  • 

    
${misc:Pre-Depends} for all multiarch packages

    

    • 

  • 

    
${shlibs:Depends} for all binary executable and library packages

    

    • 

  • 

    
${python:Depends} for all Python packages

    

    • 

  • 

    
${python3:Depends} for all Python3 packages

    

    • 

  • 

    
${perl:Depends} for all Perl packages

    

    • 

  • 

    
${ruby:Depends} for all Ruby packages

    

    • 







binNMU safe


For the safe binNMU, the dependency among binary packages from a same source package needs attention if there are both "Architecture: any" and "Architecture: all" packages involved in it.


    

  • 

    
"Architecture: any" package depends on "Architecture: any" foo package

    

      

    • 

      
Depends: foo (== ${binary:Version})

      

      • 

    

    • 

  • 

    
"Architecture: any" package depends on "Architecture: all" bar package

    

      

    • 

      
Depends: bar (== ${source:Version}

      

      • 

    

    • 

  • 

    
"Architecture: all" package depends on "Architecture: any" baz package

    

      

    • 

      
Depends: baz (>= ${source:Version}), baz (<< ${source:Upstream-Version}.0~)

      

      • 

    

    • 







The library package name


Let’s consider that the upstream source tarball of the libfoo library is updated from libfoo-7.0.tar.gz to libfoo-8.0.tar.gz with the new SONAME major version.


In order to distinguish the SONAME major version, their binary library pakages are named as libfoo7 and libfoo8 respectively.


You need to transition all dependent packages using binNMU by working with the release team.


In order to transition smoothly, the -dev package must follow one of the following naming rules:


    

  • 

    
Use the unversioned -dev package name: libfoo-dev

    

      

    • 

      
This is the normal rule.

      

      • 

    • 

      
Only one version of the library package is allowed in the archive.

      

      • 

    • 

      
This is good idea if the number of dependent packages are limited.

      

      • 

    

    • 

  • 

    
Use the versioned -dev package names: libfoo7-dev and libfoo8-dev

    

      

    • 

      
This is the special rule when you need to support both libfoo7 and libfoo8 simultaneously.

      

        

      • 

        
Make all dependent packages depend on libfoo-dev.

        

        • 

      • 

        
Make both libfoo7-dev and libfoo8-dev provide libfoo-dev.

        

        • 

      • 

        
The source package needs to be renamed as libfoo7-7.0.tar.gz and libfoo8-8.0.tar.gz respectively to make them both available in the archive.

        

        • 

      • 

        
The package specific install file path including libfoo7 and libfoo8 respectively for header files etc. needs to be chosen to make them co-installable.

        

        • 

      

      • 

    • 

      
This is useful if the number of dependent packages are huge and their migration poses major resource drain such as manual code updates, etc.  Otherwise, please do not do this.

      

      • 

    

    • 



See Chapter 8 - Shared libraries of the “Debian Policy Manual”.








debmake -b


The -b option of the debmake command provides intuitive and flexible methods to customize packaging parameters in the debian/control file.  It sets the following stanza values.


    

  • 

    
Package:

    

    • 

  • 

    
Architecture:

    

    • 

  • 

    
Multi-Arch:

    

    • 

  • 

    
Depends:

    

    • 

  • 

    
Pre-Depends:

    

    • 



Let’s quote the pertinent part from the debmake manpage here.









-b "binarypackage[:type],…", --binaryspec "binarypackage[:type],…"






set binary package specs by the comma separated list of binarypackage:type pairs, e.g., in full form "foo:bin,foo-doc:doc,libfoo1:lib,libfoo1-dbg:dbg,libfoo-dev:dev" or in short form ",-doc,libfoo1,libfoo1-dbg, libfoo-dev".



Here, binarypackage is the binary package name; and optional type is chosen from the following type values:






    

  • 

    
bin: C/C++ compiled ELF binary code package (any, foreign) (default, alias: "", i.e., null-string)

    

    • 

  • 

    
data: Data (fonts, graphics, …) package (all, foreign) (alias: da)

    

    • 

  • 

    
dbg: Debug symbol package (any, same) (alias: db)

    

    • 

  • 

    
dev: Library development package (any, same) (alias: de)

    

    • 

  • 

    
doc: Documentation package (all, foreign) (alias: do)

    

    • 

  • 

    
lib: Library package (any, same) (alias: l)

    

    • 

  • 

    
perl: Perl script package (all, foreign) (alias: pl)

    

    • 

  • 

    
python: Python script package (all, foreign) (alias: py)

    

    • 

  • 

    
python3: Python3 script package (all, foreign) (alias: py3)

    

    • 

  • 

    
ruby: Ruby script package (all, foreign) (alias: rb)

    

    • 

  • 

    
script: Shell script package (all, foreign) (alias: sh)

    

    • 





The pair values in the parentheses, such as (any, foreign), are the Architecture and Multi-Arch stanza values set in the debian/control file.


In many cases, the debmake command makes good guesses for type from binarypackage.  If type is not obvious, type is set to bin.  For example, libfoo sets type to lib, and font-bar sets type to data, …


If the source tree contents do not match settings for type, debmake warns you.








Here are some typical multiarch package split scenarios for the following upstream source examples:


    

  • 

    
a library source libfoo-1.0.tar.gz

    

    • 

  • 

    
a tool source bar-1.0.tar.gz written in a compiled language

    

    • 

  • 

    
a tool source baz-1.0.tar.gz written in an interpreted language

    

    • 














binarypackage   
type   
Architecture:
Multi-Arch:     
Package content







libfoo1


lib*


any


same


the shared library, co-installable






libfoo1-dbg


dbg*


any


same


the shared library debug symbols, co-installable






libfoo-dev


dev*


any


same


the shared library header files etc., co-installable






libfoo-tools


bin*


any


foreign


the run-time support programs, not co-installable






libfoo-doc


doc*


all


foreign


the shared library documentation files






bar


bin*


any


foreign


the compiled program files, not co-installable






bar-doc


doc*


all


foreign


the documentation files for the program






baz


script


all


foreign


the interpreted program files









For the cases marked with * in the above table, the type values are guessed right from the package names.


The default type is the bin type which means the compiled ELF binary executables.  This is why the example in [simple] does not specify -b option.


For programs written in other compiled languages, you may need to add its run-time library package dependency to the resulting binary package by adjusting the Depends: stanza of the debian/control file.


The development package for the shared library should depend on it and should contain a version numberless symlink to it. E.g.: /usr/lib/x86_64-linux-gnu/libfoo.so → libfoo.so.1







Note


If any dbg type packages are to be generated, they should be made for all bin and lib type packages.









debian/changelog


The debian/changelog file records the Debian package history and defines the upstream package version and the Debian revision in its first line.


The debmake command creates the initial template file with the upstream package version and the Debian revision.  The distribution is set to UNRELEASED to prevent accidental upload to the Debian archive.


The debchange command (alias dch) is used to edit this.







Tip


The date string used in the debian/changelog file can be manually generated by "LANG=C date -R".





This is installed in the /usr/share/doc/binarypackage directory as changelog.Debian.gz by the dh_installchangelogs.


The upstream changelog is installed in the /usr/share/doc/binarypackage directory as changelog.gz.


The upstream changelog is automatically found by the dh_installchangelogs using the case insensitive match of its file name to changelog, changes, changelog.txt, changes.txt, history, history.txt, or changelog.md and searched in the ./ doc/, or docs/ directories.


After finishing your packaging and verifying its quality, please execute the "dch -r" and save the finalized debian/changelog file with the distribution set to sid. 
[If you are using the vim editor, save with the ":wq" command.]







Debian takes the copyright and license matters very seriously. The “Debian Policy Manual” enforces to have summary of them in the debian/copyright file in the package.


You should format it as the machine-readable debian/copyright file (DEP-5).


The debmake command creates the initial DEP-5 compatible template file by scanning the entire source tree.  It uses an internal license checker to classify each license text. 
[The licensecheck command from the devscripts package was referenced to make this internal checker.]







Note


If you find issues with this license checker, please file a bug report to the debmake package with the problematic part of text containing the copyright and license.









DFSG


Debian takes software freedom seriously and follows the DFSG.


The non-DFSG components in the upstream source tarball can be easily removed when the uscan command is used to update the Debian package.


    

  • 

    
List the files to be removed in the Files-Excluded stanza of the  debian/copyright file.

    

    • 

  • 

    
List the URL to download the upstream tarball in the debian/watch file.

    

    • 

  • 

    
Run the uscan command to download the new upstream tarball.

    

      

    • 

      
Alternatively, use the "gbp import-orig --uscan --pristine-tar" command.

      

      • 

    

    • 

  • 

    
The resulting tarball has the version number with an additional suffix +dfsg.

    

    • 







Other debian/*


Optional configuration files may be added under the debian/ directory.  Most of them are to control dh_* commands offered by the debhelper package but there are some for lintian and gbp commands.  Here is the alphabetical list of notable optional configuration files.





binarypackage.bug-control  -x3






installed as usr/share/bug/binarypackage/control in binarypackage. See [bug].






binarypackage.bug-presubj  -x3






installed as usr/share/bug/binarypackage/presubj in binarypackage. See [bug].






binarypackage.bug-script  -x3






installed as usr/share/bug/binarypackage or usr/share/bug/binarypackage/script in binarypackage. See [bug].






clean -x2






List files which should be removed but are not cleaned by the dh_auto_clean command.



See dh_auto_clean(1) and dh_clean(1).





compat -x1






Set the debhelper compatibility level (currently, "9").



See “COMPATIBILITY LEVELS” in debhelper(8).





binarypackage.conffile






No need for this file under compat >= 3  since all files in the etc/ directory are conffiles.



See dh_installdeb(1).


If the program you’re packaging requires every user to modify the configuration files in the /etc directory, there are two popular ways to arrange for them to not be conffiles, keeping the dpkg command happy and quiet.


    

  • 

    
Create a symlink under the /etc directory pointing to a file under the /var directory generated by the maintainer scripts.

    

    • 

  • 

    
Create a file generated by the maintainer scripts under the /etc directory.

    

    • 






binarypackage.config






This is the debconf config script used for asking any questions necessary to configure the package.  See [debconf].






binarypackage.cron.hourly -x3






Installed into the etc/cron/hourly/binarypackage file in binarypackage.



See dh_installcron(1) and cron(8).





binarypackage.cron.daily -x3






Installed into the etc/cron/daily/binarypackage file in binarypackage.



See dh_installcron(1) and cron(8).





binarypackage.cron.weekly -x3






Installed into the etc/cron/weekly/binarypackage file in binarypackage.



See dh_installcron(1) and cron(8).





binarypackage.cron.monthly -x3






Installed into the etc/cron/monthly/binarypackage file in binarypackage.



See dh_installcro*(1) and cron(8).





binarypackage.cron.d -x3






Installed into the etc/cron.d/binarypackage file in binarypackage.



See dh_installcron(1), cron(8), and crontab(5).





binarypackage.default -x3






If this exists, it is installed into etc/default/binarypackage in binarypackage.



See dh_installinit(1).





binarypackage.dirs -x3






List directories to be created in binarypackage.



See dh_installdirs(1).


Usually, this is not needed since all dh_install* commands create required directories automatically.  Use this only when you run into trouble.





binarypackage.doc-base -x2






Installed as the doc-base control file in binarypackage.



See dh_installdocs(1) and Debian doc-base Manual provided by the doc-base package.





binarypackage.docs -x2






List documentation files to be installed in binarypackage.



See dh_installdocs(1).





binarypackage.emacsen-compat -x3






Installed into usr/lib/emacsen-common/packages/compat/binarypackage in binarypackage.



See dh_installemacsen(1).





binarypackage.emacsen-install -x3






Installed into usr/lib/emacsen-common/packages/install/binarypackage in binarypackage.



See dh_installemacsen(1).





binarypackage.emacsen-remove -x3






Installed into usr/lib/emacsen-common/packages/remove/binarypackage in binarypackage.



See dh_installemacsen(1).





binarypackage.emacsen-startup -x3






Installed into usr/lib/emacsen-common/packages/startup/binarypackage in binarypackage.



See dh_installemacsen(1).





binarypackage.examples -x2






List example files or directories to be installed into usr/share/doc/binarypackage/examples/ in binarypackage.



See dh_installexamples(1).





gbp.conf






If this exists, it functions as the configuration file for the gbp command.



See gbp.conf(5), gbp(1), and git-buildpackage(1).





binarypackage.info -x2






List info files to be installed in binarypackage.



See dh_installinfo(1).





binarypackage.init -x3






Installed into etc/init.d/binarypackage in binarypackage.



See dh_installinit(1).





binarypackage.install -x2






List files which should be installed but are not installed by the dh_auto_install command.



See dh_install(1) and dh_auto_install(1).





license-examples/* -x4






These are copyright file examples generated by the debmake command.  Use these as the reference for making copyright file.



Please make sure to erase these files.





binarypackage.links -x2






List pairs of source and destination files to be symlinked. Each pair should be put on its own line, with the source and destination separated by the whitespace.



See dh_link(1).





binarypackage.lintian-overrides -x3






Installed into usr/share/lintian/overrides/binarypackage in the package build directory. This file is used to suppress erroneous lintian diagnostics.



See dh_lintian(1) and lintian(1).





manpage.* -x3






These are manpage template files generated by the debmake command.  Please rename these to appropriate file names and update their contents.



Debian Policy requires that each program, utility, and function should have an associated manual page included in the same package. Manual pages are written in nroff(1).


If you are new to making manpage, use manpage.asciidoc or manpage.1 as the starting point.





binarypackage.manpages -x2






List man pages to be installed.



See dh_installman(1).





binarypackage.menu -x2






Debian menu file installed into usr/share/menu/binarypackage in binarypackage.



See menufile(5) for its format.  See dh_installmenu(1).





NEWS






Installed into usr/share/doc/binarypackage/NEWS.Debian.



See dh_installchangelogs(1).





patches/*






Collection of -p1 patch files which are applied to the upstream source before building the source.



See dpkg-source(8), [quilt] and [modpkg].


No patch files are generated by the debmake command.





patches/series -x1






The application sequence of the patches/* patch files.






binarypackage.preinst -x2




binarypackage.postinst -x2




binarypackage.prerm -x2




binarypackage.postrm -x2






These maintainer scripts are installed into the DEBIAN directory.



Inside the scripts, the token #DEBHELPER# is replaced with shell script snippets generated by other debhelper commands.


See dh_installdeb(1) and Chapter 6 - Package maintainer scripts and installation procedure of the “Debian Policy Manual”.


See also debconf-devel(7) and 3.9.1 Prompting in maintainer scripts of the “Debian Policy Manual”.





README.Debian -x1






Installed into the first binary package listed in the debian/control file as usr/share/doc/binarypackage/README.Debian.



See dh_installdocs(1).


This file provides the information specific to the Debian package.





binarypackage.service -x3






If this exists, it is installed into lib/systemd/system/binarypackage.service in binarypackage.



See dh_systemd_enable(1), dh_systemd_start(1), and dh_installinit(1).





source/format -x1






The Debian package format.



    

  • 

    
Use "3.0 (quilt)" to make this non-native package (recommended)

    

    • 

  • 

    
Use "3.0 (native)" to make this native package

    

    See “SOURCE PACKAGE FORMATS” in dpkg-source(8).
    

    • 






source/lintian-overrides or source.lintian-overrides -x3






These files are not installed, but will be scanned by the lintian command to provide overrides for the source package.



See dh_lintian(1) and lintian(1).





source/local-options -x1






This is not included in the generated source package but committed to the VCS for its smooth operation.



See “FILE FORMATS” in dpkg-source(8).





source/options






See the dpkg-source(1) manpage under "FILE FORMATS" to learn about the package formats and the patch mechanisms.



See “FILE FORMATS” in dpkg-source(8).





binarypackage.symbols -x2






The symbols files, if present, are passed to the dpkg-gensymbols command to be processed and installed.



See dh_makeshlibs(1) and [symbols]..





binarypackage.templates






This is the debconf templates file used for asking any questions necessary to configure the package.  See [debconf].






tests/control






This is the RFC822-style test metadata file defined in DEP-8.  See adt-run(1) and [ci].






TODO






Installed into the first binary package listed in the debian/control file as usr/share/doc/binarypackage/TODO.Debian.



See dh_installdocs(1).





binarypackage.tmpfile -x3






If this exists, it is installed into usr/lib/tmpfiles.d/binarypackage.conf in binarypackage.



See dh_systemd_enable(1), dh_systemd_start(1), and dh_installinit(1).





binarypackage.upstart -x3






If this exists, it is installed into etc/init/package.conf in the package build directory.



See dh_installinit(1) and [emptypkg].





watch -x1






The control file for the uscan command to download the latest upstream version



This control file may be configured to verify the authenticity of the tarball using its GPG signature (see [signing-key]).


See [dfsg] and uscan(1).






Here are a few reminders to the above list.


    

  • 

    
For the single binary package, binarypackage. part of the filename in the list may be removed.

    

    • 

  • 

    
For the multi binary package, configuration file missing binarypackage. part of the filename is applied to the first binary package listed in the debian/control.

    

    • 

  • 

    
When there are many binary packages, their configurations can be specified independently by prefixing their name to their configuration filenames such as package-1.install, package-2.install, etc.

    

    • 

  • 

    
Configuration template filenames with -x1, -x2, -x3, or -x4 in the above mean that they are generated by the debmake command with that -x option (see [xoption]).

    

    • 

  • 

    
Some template configuration files may not be created by the debmake command. In such cases, you need to create them with an editor.

    

    • 

  • 

    
Unusual configuration template files generated by the debmake command with the extra .ex suffix needs to be activated by removing that suffix.

    

    • 

  • 

    
Unused configuration template files generated by the debmake command should be removed.

    

    • 

  • 

    
Copy configuration template files as needed to the filenames matching their pertinent binary package names.

    

    • 







signing-key.pgp


Some packages are signed by the GPG key.


For example, GNU hello can be downloaded via HTTP from http://ftp.gnu.org/gnu/hello/ .  There are sets of files:


    

  • 

    
hello-version.tar.gz (upstream source)

    

    • 

  • 

    
hello-version.tar.gz.sig (detached signature)

    

    • 



Let’s pick the latest version set.






$ wget http://ftp.gnu.org/gnu/hello/hello-2.9.tar.gz
 ...
$ wget http://ftp.gnu.org/gnu/hello/hello-2.9.tar.gz.sig
 ...
$ gpg --verify hello-2.9.tar.gz.sig
gpg: Signature made Thu 10 Oct 2013 08:49:23 AM JST using DSA key ID 80EE4A00
gpg: Can't check signature: public key not found




If you know the public GPG key of the upstream from the mailing list, use it as the debian/upstream/signing-key.pgp file.  Otherwise, use the hkp keyserver and check it via your web of trust.






$ gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-key 80EE4A00
gpg: requesting key 80EE4A00 from hkp server keyserver.ubuntu.com
gpg: key 80EE4A00: public key "Reuben Thomas <rrt@sc3d.org>" imported
gpg: no ultimately trusted keys found
gpg: Total number processed: 1
gpg:               imported: 1
$ gpg --verify hello-2.9.tar.gz.sig
gpg: Signature made Thu 10 Oct 2013 08:49:23 AM JST using DSA key ID 80EE4A00
gpg: Good signature from "Reuben Thomas <rrt@sc3d.org>"
  ...
Primary key fingerprint: 9297 8852 A62F A5E2 85B2  A174 6808 9F73 80EE 4A00









Tip


Here "hkp://keyserver.ubuntu.com:80" is used to avoid the firewall policy blocking HPK port 11371.





After confirming the key ID 80EE4A00 is trust worthy one, download its public key into the debian/upstream/signing-key.pgp file.






$ gpg --armor --export 80EE4A00 >debian/upstream/signing-key.pgp




Then set the corresponding debian/watch file as follows.






version=3
pgpsigurlmangle=s/$/.sig/  http://ftp.gnu.org/gnu/hello/ hello-(\d[\d.]*)\.tar\.(?:gz|bz2|xz)




Now the uscan command will check the authenticity of the package using the GPG signature.






Package customization


Some upstream sources do not behave well and you may need to add customization to the build system of those upstream sources.


The package should be customized by the least invasive way to address the root cause of the Debian packaging problem.  Your packaging shall be more robust for the future upgrades in this way.  (You should also solve the root cause of the problem and send its patch to the upstream.)


Here, there are a few technical approaches to customize the build system:


    

  • 

    
patches/* approach

    

    • 

  • 

    
debian/rules approach

    

    • 

  • 

    
debian/bianrypackage.* approach

    

    • 





patches/* approach


Modifications to the upstream source before building it can be done by placing the collection of the -p1 patches in the patches/ directory and applying them in sequence defined in the  patches/series file.


There are several methods to prepare the required -p1 patches for this.


    

  • 

    
The diff command (manual)

    

    • 

  • 

    
The "git format-patches" command (manual for the git repository)

    

    • 

  • 

    
The dquilt command (manual, elegant) (alias of the quilt command, see [quilt])

    

    • 

  • 

    
The gbp-pq command (specialized, simple)

    

    • 

  • 

    
The git-dpm command (specialized, elegant)

    

    • 

  • 

    
Patches used in other distros and floating on the mailing list

    

    • 

  • 

    
…

    

    • 



Wherever these patches come from, it is good idea to tag them with DEP-3 compatible header.


These patches should apply cleanly.  You must normalize them by the dquilt command (see [quilt]).






 $ while dquilt push; do dquilt refresh ; done
 $ dquilt pop -a









Caution


Don’t forget to normalize patches when you upgrade to the new upstream source or import the externally generated patches.





See  [modpkg] for example.






debian/rules approach


The customization to the Debian package build system can be done through the debian/rules file.


See [customrules].






debian/binarypackage.* approach


Add customized configuration files for the dh_* command from the debhelper package in the debian/ directory.


See [debianconf].








Upstream build systems


Upstream build systems are designed to go through several steps to install generated binary files to the system from the source distribution.




Autotools


Autotools (autoconf + automake) has 4 steps.


    

  1. 

    
setup the build system ("vim configure.ac Makefile.am" and "autoreconf -ivf")

    

    2. 

  2. 

    
configure the build system ("./configure")

    

    3. 

  3. 

    
build the source tree ("make")

    

    4. 

  4. 

    
install the binary files ("make install")

    

    5. 



The upstream usually performs the step 1 and builds the upstream tarball for distribution using the "make dist" command.   (The generated tarball contains not only the pristine upstream VCS contents but also other generated files.)


The package maintainer needs to take care step 2 to 4 at least.  This is realized by the "dh $@ --with autotools-dev" command used in the debian/rules file.


The package maintainer wishes to take care step 1 to 4.  This is realized by the "dh $@ --with autoreconf" command used in the debian/rules file.  This rebuilds all auto-generated files to the latest version and provides better porting supports.






Python distutils


Python distutils has 3 steps.


    

  1. 

    
setup and configure the build system ("vim setup.py")

    

    2. 

  2. 

    
build the source tree ("python setup.py build")

    

    3. 

  3. 

    
install the binary files ("python setup.py install")

    

    4. 



The upstream usually performs the step 1 and builds the upstream tarball for distribution using the "python setup.py sdist" command.


The package maintainer needs to take care step 2.  This is realized simply by the "dh $@" command used in the debian/rules file, after jessie.


The situation of other build systems, such as CMake, are very similar to this Python one.








Debugging information


The Debian package is build with the debugging information but packaged into the binary package after stripping the debugging information as required by Chapter 10 - Files of the “Debian Policy Manual”.


The debugging information can be packaged separately as the debug packege using the "dh_strip --dbg-package=package" command in the override_dh_strip: target of the debian/rules file.


The installation path of the debugging information is as follows to enable auto-loading of it by the gdb command.


    

  • 

    
/usr/lib/debug/.build-id/12/3456… (compat>=9, for buildID=123456…)

    

    • 

  • 

    
/usr/lib/debug/path/to/binary (compat<<9, for /path/to/binary)

    

    • 



See








Library package


Packaging the library software requires you to perform much more work than usual.  Here are some reminders for packaging the library software:


    

  • 

    
Debian ships shared library such as /usr/lib/<triplet>/libfoo-0.1.so.1.0.0 (see [multiarch]).

    

    • 

  • 

    
Debian encourages to use versioned symbols in the shared library (see [symbols]).

    

    • 

  • 

    
Debian doesn’t ship *.la  libtool library archive files.

    

    • 

  • 

    
Debian discourages to use and ship *.a static library files.

    

    • 



Before packaging the shared library software, see:




For the historic background study, see:


    

  • 

    
Escaping the Dependency Hell 
    [This document was written before the introduction of the symbols file.]
    

    

      

    • 

      
This encourages to have versioned symbols in the shared library.

      

      • 

    

    • 

  • 

    
Debian Library Packaging guide 
    [The strong preference to use the SONAME versioned -dev package names over the single -dev package name in its Chapter 6. Development (-DEV) packages does not seem to be shared by the ftp-master (Steve Langasek). This document was written before the introduction of the multiarch system and the symbols file.]
    

    

    

    • 







Multiarch


The multiarch support for cross-architecture installation of binary packages (particularly i386 <-> amd64, but also other combinations) in the dpkg and apt packages introduced to Debian wheezy (7.0, May 2013) demands us to pay extra attention for the packaging.


You should read the following references in detail.




The multiarch is enabled by using the <triplet> value such as i386-linux-gnu and x86_64-linux-gnu in the the install path of shared libraries as /usr/lib/<triplet>/, etc..


    

  • 

    
The <triplet> value required internally by debhelper scripts is implicitly set in themselves.  The mainainer doesn’t need to worry.

    

    • 

  • 

    
The <triplet> value used in override_dh_* target scripts must be explicitly set in the debian/rules by the maintainer.  The <triplet> value is stored in $(DEB_HOST_MULTIARCH) variable in the following debian/rules snippet example:

    

    

    

    DEB_HOST_MULTIARCH = $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)
...
override_dh_install:
        mkdir -p package1/lib/$(DEB_HOST_MULTIARCH)
        cp -dR tmp/lib/. package1/lib/$(DEB_HOST_MULTIARCH)
    

    

    • 



See [variablesrules] and dpkg-architecture.




The multiarch library path


Debian policy requires to follow Filesystem Hierarchy Standard.  Its /usr/lib : Libraries for programming and packages states "/usr/lib includes object files, libraries, and internal binaries that are not intended to be executed directly by users or shell scripts."


Debian policy makes an exception to Filesystem Hierarchy Standard to use /usr/lib/<triplet>/ instead of /usr/lib<qual>/ (e.g., /lib32/ and /lib64/) to support the multiarch library.





Table 1. The multiarch library path options






Classic path   
i386 multiarch path            
amd64 multiarch path







/lib/


/lib/i386-linux-gnu/


/lib/x86_64-linux-gnu/






/usr/lib/


/usr/lib/i386-linux-gnu/


/usr/lib/x86_64-linux-gnu/









For Autotools based packages under the debhelper package (compat>=9), this path setting is automatically taken care by the dh_auto_configure command.


For other packages with non-supported build systems, you need to manually adjust the install path as follows.


    

  • 

    
If ./configure is used in the part of override_dh_auto_configure target in debian/rules, make sure to replace it with "dh_auto_configure --" while re-targeting the install path from /usr/lib/ to /usr/lib/$(DEB_HOST_MULTIARCH)/.

    

    • 

  • 

    
Replace all occurrences of /usr/lib/ with /usr/lib/*/ in debian/foo.install files.

    

    • 



All files installed simultaneously as the multiarch package to the same file path should have exactly the same file content. You must be careful on differences generated by the data byte order and by the compression algorithm.


Please note that --libexecdir specifies the default path to install executable programs run by other programs rather than by users. Its Autotools default is /usr/libexec/ but its Debian default is /usr/lib/.  If such executable is "Multi-arch: foreign" package, path such as /usr/lib/ or /usr/lib/packagename may be more desirable than /usr/lib/<triplet>/ which dh_auto_configure uses.


Please also note that the GNU Coding Standards: 7.2.5 Variables for Installation Directories has description for libexecdir as "The definition of libexecdir is the same for all packages, so you should install your data in a subdirectory thereof. Most packages install their data under $(libexecdir)/package-name/ …". (It is always good idea to follow GNU unless it conflicts with the Debian policy)


The shared library files in the default path /usr/lib/ and /usr/lib/<triplet>/ are loaded automatically.


For the shared library files in the other path, GCC option -l must be set by the pkg-config command to make them loaded properly.






The multiarch header file path


GCC includes both /usr/include/ and /usr/include/<triplet>/ by default on the multiarch Debian system.


If the header file is not in those paths, GCC option -I must be set by the pkg-config command to make "#include <foo.h>" work properly.





Table 2. The multiarch header file path options






Classic path   
i386 multiarch path            
amd64 multiarch path







/usr/include/


/usr/include/i386-linux-gnu/


/usr/include/x86_64-linux-gnu/






/usr/include/packagename/


/usr/include/i386-linux-gnu/packagename/


/usr/include/x86_64-linux-gnu/packagename/








/usr/lib/i386-linux-gnu/packagename/


/usr/lib/x86_64-linux-gnu/packagename/









The use if the /usr/lib/<triplet>/packagename/ path for the header files allows the upstream to use the same install script for the multiatch system with /usr/lib/<triplet> and the biarch system with /usr/lib<qual>/. 
[This path is compliant to the FHS.  Filesystem Hierarchy Standard: /usr/lib : Libraries for programming and packages states "Applications may use a single subdirectory under /usr/lib. If an application uses a subdirectory, all architecture-dependent data exclusively used by the application must be placed within that subdirectory."]


The use of the file path containing packagename enables to have more than 2 development libraries simultaneously installed on a system.






The multiarch *.pc file path


The pkg-config program is used to retrieve information about installed libraries in the system.  It stores its configuration parameters in the *.pc file and is used for setting the -I and -l options for GCC.





Table 3. The *.pc file path options






Classic path   
i386 multiarch path            
amd64 multiarch path







/usr/lib/pkgconfig/


/usr/lib/i386-linux-gnu/pkgconfig/


/usr/lib/x86_64-linux-gnu/pkgconfig/















Library symbols


The symbols support in the dpkg introduced to Debian lenny (5.0, May 2009) helps us to manage the backward ABI compatibility of the library package with the same package name.  The DEBIAN/symbols file in the binary package provides the minimal version associated to each symbol.


The oversimplified method for the library packaging is as follows.


    

  • 

    
Extract the old DEBIAN/symbols file of the immediate previous binary package with the "dpkg-deb -e" command.

    

      

    • 

      
Alternatively, the mc command may be used to extract the DEBIAN/symbols file.

      

      • 

    

    • 

  • 

    
Copy it to the debian/binarypackage.symbols file.

    

      

    • 

      
If this is the first package, use an empty content file instead.

      

      • 

    

    • 

  • 

    
Build the binary package.

    

      

    • 

      
If the dpkg-gensymbols command warns some new symbols:

      

        

      • 

        
Extract the updated DEBIAN/symbols file with the "dpkg-deb -e" command.

        

        • 

      • 

        
Trim the Debian revision such as -1 in it.

        

        • 

      • 

        
Copy it to the debian/binarypackage.symbols file.

        

        • 

      • 

        
Re-build the binary package.

        

        • 

      

      • 

    • 

      
If the dpkg-gensymbols command does not warn new symbols:

      

        

      • 

        
You are done with the library packaging.

        

        • 

      

      • 

    

    • 



For the details, you should read the following primary references.


    

  • 

    
8.6.3 The symbols system of the “Debian Policy Manual”

    

    • 

  • 

    
dh_makeshlibs(1)

    

    • 

  • 

    
dpkg-gensymbols(1)

    

    • 

  • 

    
dpkg-shlibdeps(1)

    

    • 

  • 

    
deb-symbols(5)

    

    • 



Yous should also check:









Tip


For C++ libraries and other cases where the tracking of the symbols is problematic, follow 8.6.4 The shlibs system of the “Debian Policy Manual”, instead.  Please make sure to erase the empty debian/binarypackage.symbols file generated by the debmake command.  For this case, the DEBIAN/shlibs file is used.









Compiler hardening


The compiler hardening support spreading for Debian jessie (8.0, TBA) demands us to pay extra attention for the packaging.


You should read the following references in detail.




The debmake command adds template comments to the debian/rules file as needed for DEB_BUILD_MAINT_OPTIONS, DEB_CFLAGS_MAINT_APPEND, and DEB_LDFLAGS_MAINT_APPEND (see [singlepkg] and dpkg-buildflags(1)).






Bug report


The reportbug command used for the bug report of binarypackage can be customized by the files in usr/share/bug/binarypackage/.


The dh_bugfiles command installs these files from the template files in the debian/ directory.


    

  • 

    
debian/binarypackage.bug-control  →  usr/share/bug/binarypackage/control

    

      

    • 

      
This file contains some directions such as redirecting the bug report to another package.

      

      • 

    

    • 

  • 

    
debian/binarypackage.bug-presubj  →  usr/share/bug/binarypackage/presubj

    

      

    • 

      
This file is displayed to the user by the reportbug command.

      

      • 

    

    • 

  • 

    
debian/binarypackage.bug-script  → usr/share/bug/binarypackage or usr/share/bug/binarypackage/script

    

      

    • 

      
The reportbug command runs this script to generate a template file for the bug report.

      

      • 

    

    • 



See dh_bugfiles(1) and reportbug’s Features for Developers






debconf


The debconf package enables us to configure packages during their installation in 2 main ways:


    

  • 

    
non-interactively from the debian-installer pre-seeding.

    

    • 

  • 

    
interactively from the menu interface (dialog, gnome, kde, …)

    

      

    • 

      
the package installation: invoked by the dpkg command

      

      • 

    • 

      
the installed package: invoked by the dpkg-reconfigure command

      

      • 

    

    • 



All user interactions for the package installation must be handled by this debconf system using the following files.


    

  • 

    
debian/binarypackage.cofig

    

      

    • 

      
This is the debconf config script used for asking any questions necessary to configure the package.

      

      • 

    

    • 

  • 

    
debian/binarypackage.template

    

      

    • 

      
This is the debconf templates file used for asking any questions necessary to configure the package.

      

      • 

    

    • 

  • 

    
package configuration scripts

    

      

    • 

      
debian/binarypackage.preinst

      

      • 

    • 

      
debian/binarypackage.prerm

      

      • 

    • 

      
debian/binarypackage.postinst

      

      • 

    • 

      
debian/binarypackage.postrm

      

      • 

    

    • 



See dh_installdebconf(1), debconf(7), debconf-devel(7) and 3.9.1 Prompting in maintainer scripts of the “Debian Policy Manual”.






Continuous integration


DEP-8 defines the debian/tests/control file as the RFC822-style test metadata file for the continuous integration (CI) of the Debian package.


It is used after building the binary packages from the source package containing this debian/tests/control file.  When the adt-run command provided by the autopkgtest package is run, the generated binary packages are installed and tested in the virtual environment according to this file.


See documents in the /usr/share/doc/autopkgtest/ directory and 3. autopkgtest: Automatic testing for packages of the “Ubuntu Packaging Guide”.


There are several other CI tools on Debian for you to explore.


    

  • 

    
The debci package: CI platform on the top of the autopkgtest package

    

    • 

  • 

    
The jenkins package: generic CI platform

    

    • 











Tips






debdiff


You can compare file contents in two source Debian packages with the debdiff command.






$ debdiff old-package.dsc new-package.dsc




You can also compare file lists in two sets of binary Debian packages with the debdiff command.






$ debdiff old-package.changes new-package.changes




These are useful to identify what has been changed in the source packages and to check for inadvertent changes made when updating binary packages, such as unintentionally misplacing or removing files.






dget


You can download the set of files for the Debian source package with the dget command.






$ dget http://www.example.org/path/to/package_version-rev.dsc








debc


You should install generated packages with the debc command to test it locally.






$ debc package_version-rev_arch.changes








piuparts


You should install generated packages with the piuparts command to test it automatically.






$ sudo piuparts package_version-rev_arch.changes









Note


This is very slow proess with the remote APT package repository access.









debsign


After completing the test of the package, you can sign it with the debsign command.






$ debsign package_version-rev_arch.changes








dput


After signing the package with the debsign command, you can upload the set of files for the Debian source and binary package with the dput command.






$ dput package_version-rev_arch.changes








bts


After uploading the package, you will recieve bug reports.  It is an important duty of a package maintainer to manage these bugs properly as described in 5.8. Handling bugs of the “Debian Developer’s Reference”.


The bts command is a handy tool to manage bugs on Debian Bug Tracking System.






$ bts severity 123123 wishlist , tags -1 pending








git-buildpackage


The git-buildpackage package offers many commands to automate packaging activities using the git repository.


    

  • 

    
git-import-dsc: import the previous Debian source package to the git repository.

    

    • 

  • 

    
git-import-orig: import the new upstream tar to the git repository.

    

    • 

  • 

    
git-dch: generate the Debian changelog from the git commit messages.

    

    • 

  • 

    
git-buildpackage: build the Debian binary package from the git repository. (alias gbp)

    

      

    • 

      
The --pristine-tar option for the git-buildpackage command enables to store the upstream tarball in the same git repository.

      

      • 

    • 

      
The --uscan option for the git-buildpackage command enables to download and commit the new upstream tarball into the git repository.

      

      • 

    

    • 

  • 

    
git-pbuilder: build the Debian binary package from the git repository using the pbuilder package.

    

      

    • 

      
The cowbuilder package is used as its backend.

      

      • 

    

    • 

  • 

    
The gbp-pq, git-dpm or quilt (or alias dquilt) commands are used to manage quilt patches.

    

      

    • 

      
The use of the dquilt command is the simplest to learn and requires you to commit the resulting files manually with the git command to the master branch.

      

      • 

    

    • 



The package history management with the git-buildpackage package is becoming the standard practice for most Debian maintainers.


See:








Package history


For Debian source packages named <source-package> recorded in the snapshot.debian.org archive, an initial git repository with all of the Debian version history can be generated as follows.






$ git-import-dscs --debsnap --pristine-tar '<source-package>'








chroot


The chroot for the clean package build environment can be created and managed using the tools described in [setup].

[The git-pbuilder style organization is deployed here.  See https://wiki.debian.org/git-pbuilder .  Be careful since many HOWTOs use different organization.]


Here is a quick summary of available package build commands.  There are many ways to do the same thing.


    

  • 

    
dpkg-buildpackage = core of package building tool

    

    • 

  • 

    
debuild = dpkg-buildpackage + lintian (build under the sanitized environment variables)

    

    • 

  • 

    
pbuilder = core of the Debian chroot environment tool

    

    • 

  • 

    
pdebuild = pbuilder + dpkg-buildpackage (build in the chroot)

    

    • 

  • 

    
cowbuilder = speed up the pbuilder execution

    

    • 

  • 

    
git-pbuilder = the easy-to-use commandline syntax for pdebuild (used by gbp buildpackge)

    

    • 

  • 

    
gbp = manage the Debian source under the git

    

    • 

  • 

    
gbp buildpackge = pbuilder + dpkg-buildpackage + gbp

    

    • 



A clean sid distribution chroot environment can be used as follows.


    

  • 

    
The chroot filesystem creation command for the sid distribution

    

      

    • 

      
pbuilder create

      

      • 

    • 

      
git-pbuilder create

      

      • 

    

    • 

  • 

    
The master chroot filesystem path for the sid distribution chroot

    

      

    • 

      
/var/cache/pbuilder/base.cow

      

      • 

    

    • 

  • 

    
The package build command for the sid distribution chroot

    

      

    • 

      
pdebuild

      

      • 

    • 

      
git-pbuilder

      

      • 

    • 

      
gbp buildpackage

      

      • 

    

    • 

  • 

    
The command to update the sid chroot

    

      

    • 

      
pbuilder --update

      

      • 

    • 

      
git-pbuilder --update

      

      • 

    

    • 

  • 

    
The command to login to the sid chroot to modify it

    

      

    • 

      
git-pbuilder --login --save-after-login

      

      • 

    

    • 



An arbitrary dist distribution environment can be used as follows.


    

  • 

    
The chroot filesystem creation command for the dist distribution

    

      

    • 

      
pbuilder create --distribution dist

      

      • 

    • 

      
DIST=dist git-pbuilder create

      

      • 

    

    • 

  • 

    
The master chroot filesystem path for the dist distribution chroot

    

      

    • 

      
path: /var/cache/pbuilder/base-dist.cow

      

      • 

    

    • 

  • 

    
The package build command for the dist distribution chroot

    

      

    • 

      
pdebuild -- --basepath=/var/cache/pbuilder/base-dist.cow

      

      • 

    • 

      
DIST=dist git-pbuilder

      

      • 

    • 

      
gbp buildpackage --git-dist=dist

      

      • 

    

    • 

  • 

    
The command to update the dist chroot

    

      

    • 

      
pbuilder update --basepath=/var/cache/pbuilder/base-dist.cow

      

      • 

    • 

      
DIST=dist git-pbuilder --update

      

      • 

    

    • 

  • 

    
The command to login to the sid chroot to modify it

    

      

    • 

      
pbuilder --login --basepath=/var/cache/pbuilder/base-dist.cow --save-after-login

      

      • 

    • 

      
DIST=dist git-pbuilder --login --save-after-login

      

      • 

    

    • 








Tip


A custom environment with some pre-loaded packages needed for the new experimental packages, this git-pbuilder --login --save-after-login command is quite handy.










Tip


If your old chroot is missing packages such as eatmydata, ccache, and lintian, you may want to install these with the git-pbuilder --login --save-after-login command.










Tip


The chroot filesystem can be cloned simply by copying with "cp -a base-dist.cow base-customdist.cow".  The new chroot can be accessed as "gbp buildpackage --git-dist=customdist" and "DIST=customdist git-pbuilder …".










Note


The description in this section is too terse to be useful for most of the prospective maintainers.  This is the intentional choice of the author.   You are highly encouraged to search and read all the pertinent documents associated with the commands used.









New Debian revision


Let’s assume that a bug report #bug_number was filed against your package, and it describes a problem that you can solve by editing buggy file in the upstream source.  Here’s what you need to do to create a new Debian revision of the package with the bugname.patch file recording the fix.






 $ dquilt new bugname.patch
 $ dquilt add buggy
 $ vim buggy
 $ dquilt refresh
 $ dquilt header -e
 $ while dquilt push; do dquilt refresh; done
 $ dquilt pop -a
 $ dch -i




Please make sure to describe concisely the changes that fix reported bugs and close those bugs by adding "Closes: #bug_number" in the debian/changlog file.







Tip


Use a debian/changelog entry with a version string such as 1.0.1-1~rc1 when you experiment. Then, unclutter such changelog entries into a single entry for the official package.









New upstream release


If a package foo is properly packaged in the modern 3.0 (native) or 3.0 (quilt) formats, packaging a new upstream release is essentially moving the old debian/ directory to the new source. This can be done by running "tar -xvzf /path/to/foo_oldversion.debian.tar.gz" in the new extracted source. 
[If a package foo is packaged in the old 1.0 format, this can be done by running "zcat /path/to/foo_oldversion.diff.gz|patch -p1" in the new extracted source, instead.]
 Of course, you need to do some obvious chores.


There are several tools to handle this situation.  After updating to the new upstream release with these tools, please make sure to describe concisely the changes in the new upstream release that fix reported bugs and close those bugs by adding "Closes: #bug_number" in the debian/changlog file.




uupdate + tarball


You can update to the new upstream source with the uupdate command from the devscripts package.  It requires to have the old Debian source package and the new upstream tarball.






 $ wget http://example.org/foo/foo-newversion.tar.gz
 $ cd foo-oldversion
 $ uupdate -v newversion ../foo-newversion.tar.gz
 ...
 $ cd ../foo-newversion
 $ while dquilt push; do dquilt refresh; done
 $ dch








uscan


You can update to the new upstream source with the uscan command from the devscripts package.  It requires to have the old Debian source package and the debian/watch file in it.






 $ cd foo-oldversion
 $ uscan
 ...
 $ while dquilt push; do dquilt refresh; done
 $ dch








gbp


You can update to the new upstream source with the "gbp import-orig --pristine-tar" command from the git-buildpackage package.  It requires to have the old Debian source in the git repository and the new upstream tarball.






 $ ln -sf foo-newversion.tar.gz foo_newversion.orig.tar.gz
 $ cd foo-vcs
 $ git checkout master
 $ gbp import-orig --pristine-tar  ../foo_newversion.orig.tar.gz
 ...
 $ while dquilt push; do dquilt refresh; done
 $ git commit -a -m "Refresh patches"
 $ dch








gbp + uscan


You can update to the new upstream source with the "gbp import-orig --pristine-tar --uscan" command from the git-buildpackage package.  It requires to have the old Debian source in the git repository and the debian/watch file in it.






 $ cd foo-vcs
 $ git checkout master
 $ gbp import-orig --pristine-tar --uscan
 ...
 $ while dquilt push; do dquilt refresh; done
 $ git commit -a -m "Refresh patches"
 $ dch










Shortcut options (-a, -i)


The debmake command offers 2 shortcut options.


    

  • 

    
-a : open the upstream tarball

    

    • 

  • 

    
-i : execute script to build the binary package

    

    • 



The example in the above [simple] can be done simply as follows.






 $ debmake -a package-1.0.tar.gz -i debuild









Tip


URL such as "http://www.example.org/DL/package-1.0.tar.gz" may be used for the -a option.










Tip


URL such as "http://arm.koji.fedoraproject.org/packages/ibus/1.5.7/3.fc21/src/ibus-1.5.7-3.fc21.src.rpm" may be used for the -a option, too.









Upstream snapshot (-d, -t)


The upstream snapshot from the upstream source tree in VCS can be made with the -d option if the upstream supports the "make dist" equivalence.






 $ cd /path/to/upstream-vcs
 $ debmake -d -i debuild




Alternatively, the same can be made with the -t option if the upstream tarball can be made with the tar command.






 $ cd /path/to/upstream-vcs
 $ debmake -p package -t -i debuild




Unless you provide the upstream version with the -u option or with the debian/changelog file, a snapshot upstream version is generated in the 0~%y%m%d%H%M format, e.g., 0~1403012359, from the UTC date and time.


If the upstream VCS is hosted in the package/ directory instead of the upstream-vcs/ directory, the "-p package" can be skipped.


If the upstream source tree in the VCS contains the debian/* files, the debmake command with either the -d option or the -t option combined with the -i option automates making of the non-native Debian packages from the VCS snapshot while using these debian/* files.






 $ cp -r /path/to/package-0~1403012359/debian/. /path/to/upstream-vcs/debian
 $ dch
   ... update debian/changelog
 $ git add -A .; git commit -m "vcs with debian/*"
 $ debmake -t -p package -i debuild




This Debian non-native binary package building scheme using the "debmake -t -i debuild" command may be considered as the quasi-native Debian package scheme since the packaging situation resembles the Debian native binary package building case using the debuild command without the upstream tarball.


Use of the non-native Debian package helps to ease communication with the downstream distros such as Ubuntu for bug fixes etc.






Python module


You can generate a functioning single binary Debian package with a reasonable package description directly from the Python module package offered as a tarball pythonmodule-1.0.tar.gz.  The -b option specifying the package type python and the -s option to copy the package description from the upstream package need to be specified.






 $ debmake -s -b':python' -a pythonmodule-1.0.tar.gz -i debuild




For other interpreted languages with the -b option support, specify the pertinent type for the -b option.


For interpreted languages without the -b option support, specify the script type instead and add the interpreter package as the dependency of the resulting binary package by adjusting the debian/control file.






debmake -cc


The the debmake command with the -cc option can make a summary of the copyright and license for the entire source tree to the standard output.






 $ tar -xvzf package-1.0.tar.gz
 $ cd package-1.0
 $ debmake -cc | less




With -c, this provides shorter report.






debmake -k


When updating a package for the new upstream release, the debmake command can verify the content of the existing debian/copyright file against the copyright and license situation of the entire updated source tree.






 $ cd package-vcs
 $ gbp import-orig --uscan --pristine-tar
 ... update source with the new upstream release
 $ debmake -k | less




The "debmake -k" command parses the debian/copyright file from the top to the bottom and compare the license of all the non-binary files in the current package with the license described in the last matching file pattern entry of the debian/copyright file.


When editing the auto-generated debian/copyright file, please make sure to keep the generic file patterns at the top of the list.







Tip


For all new upstream releases, run the "debmake -k" command to ensure that the debian/copyright file is current.









debmake -j


The generation of the functioning multi binary package always requires extra manual works than that of the functioning single binary package.  The test build of the source package is essential part of it.


For example, let’s package the same package-1.0.tar.gz (see [simple]) into a multi binary package.  At the line invoking the debmake command, let’s invoke it with the -j option instead for the test building and the report generation.






 $ debmake -j









Note


The -j option for debmake invokes dpkg-depcheck(1) to run debian/rules under strace(1) to obtain library dependencies.  Unfortunately, this is very slow.  If you know the library package dependencies from other sources such as the SPEC file in the source, you may just run "debmake …" without -j and "debian/rules install" to check the install paths of the generated files.





    

  • 

    
Check the last lines of package.build-dep.log to judge build dependencies for Build-Depends. (You do not need to list packages used by debhelper, perl, or fakeroot explicitly in Build-Depends.  This technique is useful for the generation of the single binary package, too.)

    

    • 

  • 

    
Check the contents of package.install.log to identify the install paths for files to decide how you split them into multiple packages.

    

    • 







 $ rm -rf package-1.0
 $ tar -xvzf package-1.0.tar.gz
 $ cd package-1.0
 $ debmake -b"package1:type1, ..."




    

  • 

    
Update debian/control and debian/binarypackage.install files using the above information.

    

    • 

  • 

    
Update other debian/* files as needed.

    

    • 







 $ debuild




    

  • 

    
Each binarypackage_version-revision_arch.deb has files specified by the debian/binarypackage.install file.

    

    • 








Tip


The binary package name starting with a "-" (hyphen) is treated as the abbreviated name and the real binary package name is generated by attaching it to the source package name.









debmake -x


The amount of template files generated by the debmake command depends on the -x[01234] option.









Note


None of the existing configuration files are modified by the debmake command.









3.0 source format


Updating the package style is not a required activity for the update of a package. However, doing so lets you use the full capabilities of the modern debhelper system and the 3.0 source format.


    

  • 

    
If you need to recreate deleted template files for any reason, you can run debmake again in the same Debian package source tree. Then edit them appropriately.

    

    • 

  • 

    
If the package has not been updated to use the dh command for the debian/rules file, update it to use it (see [simplerules]). Update the debian/control file accordingly.

    

    • 

  • 

    
If you have a 1.0 source package with the foo.diff.gz file, you can update it to the newer 3.0 (quilt) source format by creating debian/source/format with 3.0 (quilt). The rest of the debian/* files can just be copied. Import the big.diff file generated by the command "filterdiff -z -x /debian/ foo.diff.gz > big.diff" to your quilt system, if needed. 
    [You can split big.diff into many small incremental patches using the splitdiff command.]
    

    

    • 

  • 

    
If it was packaged using another patch system such as dpatch, dbs, or cdbs with -p0, -p1, or -p2, convert it to the quilt command using the deb3 script in the quilt package.

    

    • 

  • 

    
If it was packaged with the dh command with the "--with quilt" option or with the dh_quilt_patch and dh_quilt_unpatch commands, remove these and make it use the newer 3.0 (quilt) source format.

    

    • 

  • 

    
If you have a 1.0 source package without the foo.diff.gz file, you can update it to the newer 3.0 (native) source format by creating debian/source/format with 3.0 (native). The rest of the debian/* files can just be copied.

    

    • 



You should check DEP - Debian Enhancement Proposals and adopt ACCEPTED proposals.


See ProjectsDebSrc3.0 to check the support status of the new Debian source formats by the Debian tool chains.






CDBS


The Common Debian Build System (CDBS) is a wrapper system over the debhelper package.  The CDBS is based on the Makefile inclusion mechanism and configured by the DEB_* configuration variables set in the debian/rules file.


Before the introduction of the dh command to the debhelper package at the version 7, the CDBS was the only approach to create a simple and clean debian/rules file.


For many simple packages, the dh command alone allows us to make a simple and clean debian/rules file, now.  It is desirable to keep the build system simple and clean by not using the superfluous CDBS.







Note


“The CDBS magically does the job for me with less typing” nor “I don’t understand the new dh syntax” cannot be the excuse to keep using the CDBS system.





For some complicated packages such as GNOME related ones, the CDBS is used with reasons and offers some value to the packagers.  If this is the case, please do not bother converting from the CDBS to the dh syntax.







Note


If you are working with a team of maintainers, please follow the established practice of the team.





When converting packages from the CDBS to the dh syntax, please use the following as your reference:








UTF-8 conversion


If upstream documents are encoded in old encoding schemes, converting them to UTF-8 is a good idea.


Use the iconv command in the libc-bin package to convert encodings of plain text files.






iconv -f latin1 -t utf8 foo_in.txt > foo_out.txt




Use w3m(1) to convert from HTML files to UTF-8 plain text files. When you do this, make sure to execute it under UTF-8 locale.






LC_ALL=en_US.UTF-8 w3m -o display_charset=UTF-8 \
        -cols 70 -dump -no-graph -T text/html \
        < foo_in.html > foo_out.txt




Run these scripts in the override_dh_* target of the debian/rules file.






Source tips


Although the upstream tarball has all the information to build the Debian package, it is not always easy to figure out which combination of options to use.


Also, the upstream may be more focused on the feature enhancements and may be less eager for backward compatibilities etc. which are important aspect of the Debian packaging practice.


The leveraging of information from other distributions is an option to address above issues.


If the other distribution in interest is a Debian derivative one, it is trivial to reuse it.


If the other distribution in interest is a RPM based distribution, see Repackage src.rpm.


Downloading and opening of the src.rpm file can be done with the rget command.  (Place the rget script in your PATH.)




rget script




#!/bin/sh
FCSRPM=$(basename $1)
mkdir ${FCSRPM}; cd ${FCSRPM}/
wget $1
rpm2cpio ${FCSRPM} | cpio -dium




Many upstream tarballs contain the SPEC file named as packagename.spec or packagename.spec.in used by the RPM system.  This can be used as the baseline for the Debian package, too.










Packaging examples




There is an old Latin saying: “fabricando fit faber” (“practice makes perfect”).


It is highly recommended to practice and experiment with all the steps of Debian packaging with simple packages.  This chapter provides you with the examples for your practice.


The /usr/share/doc/debmake/examples.tar.xz tarball has the sources used for testing the debmake command and creating the examples in this guide.




Cherry-pick templates


Although executing the debmake command with the larger -x[01234] option in the upstream source adds new template files without overwriting the existing ones, it tends to leave too many unused ones and is quite messy.


If you wish to get some template files without making mess in the upstream source tree, please consider the following scheme with an empty directory, e.g., package/.






 $ tree
.
└── package

1 directory, 0 files




Let’s get the maximum amount of template files by specifying the -x4 option.


Let’s also use the "-t -u 0.0" options to make missing upstream tarball with an upstream version 0.0.






 $ cd package
 $ debmake -t -u 0.0 -x4
 ...
I: debmake -x "4" ...
I: creating => debian/control
I: creating => debian/copyright
I: creating => debian/changelog
 ...
I: creating => debian/license-examples/LGPL-3.0+
I: creating => debian/license-examples/Artistic-1.0
I: creating => debian/license-examples/BSD-3-Clause
I: $ wrap-and-sort
I: upon return to the shell, current directory becomes /path/to/package
I: please execute "cd /path/to/package-0.0" before building the binary pack...
I: with dpkg-buildpackage (or debuild, pdebuild, sbuild, ...).




Let’s inspect generated template files.






 $ cd ..
 $ tree
.
├── package
├── package-0.0
│   └── debian
│       ├── changelog
│       ├── clean
│       ├── compat
│       ├── control
│       ├── copyright
│       ├── install
│       ├── license-examples
│       │   ├── Apache-2.0
│       │   ├── Artistic-1.0
│       │   ├── BSD-3-Clause
│       │   ├── GPL-2.0+
│       │   ├── GPL-3.0+
│       │   ├── LGPL-2.1+
│       │   ├── LGPL-3.0+
│       │   └── MIT
│       ├── links
│       ├── manpage.1.ex
│       ├── manpage.asciidoc.ex
│       ├── manpage.sgml.ex
│       ├── manpage.xml.ex
│       ├── menu
│       ├── package.bug-control.ex
│       ├── package.bug-presubj.ex
│       ├── package.bug-script.ex
│       ├── package.conffiles.ex
│       ├── package.cron.daily.ex
│       ├── package.cron.d.ex
│       ├── package.cron.hourly.ex
│       ├── package.cron.monthly.ex
│       ├── package.cron.weekly.ex
│       ├── package.default.ex
│       ├── package.dirs.ex
│       ├── package.emacsen-install.ex
│       ├── package.emacsen-remove.ex
│       ├── package.emacsen-startup.ex
│       ├── package.init.ex
│       ├── package.lintian-overrides.ex
│       ├── package.service.ex
│       ├── package.tmpfile.ex
│       ├── package.upstrat.ex
│       ├── patches
│       │   └── series
│       ├── postinst
│       ├── postrm
│       ├── preinst
│       ├── prerm
│       ├── README.Debian
│       ├── rules
│       ├── source
│       │   ├── format
│       │   └── local-options
│       ├── source.lintian-overrides.ex
│       └── watch
├── package_0.0.orig.tar.gz -> package-0.0.tar.gz
└── package-0.0.tar.gz

6 directories, 52 files




Now you can copy any of these generated template files in the package-0.0/debian/ directory to your package as needed.






Modifications


Let’s assume we have an older upstream source tarball hello-c-0.9.tar.gz than the hello-c-1.0.tar.gz in [simple].  The Makefile of version 0.9 installs its binary to the fixed location /usr/local/bin/hello and does not support $(DESTDIR).


There are several methods (see [patchapproach]) to prepare the -p1 patch needed for applying modifications to this 0.9 upstream source.  Let’s use the dquilt command.




Patch file by the dquilt command


Here we show the method with the dquilt command.


The packaging procedure is the same as that of version 1.0 up to running the debmake command.






 $ cd hello-c-0.9
 $ debmake
D: /usr/bin/debmake started
D: PYTHONPATH = /usr/bin:/usr/lib/python3.4:/usr/lib/python3.4/plat-x86_64-...
I: set parameters
 ...
 ... (snip)
 ...
I: run "debmake -x2" to get more template files
I: $ wrap-and-sort




The "dquilt new …" command sets the name of the patch.


The "dquilt add …" command sets the files to be modified.






 $ dquilt new 0001-destdir.patch
Patch debian/patches/0001-destdir.patch is now on top
 $ dquilt add Makefile
File Makefile added to patch debian/patches/0001-destdir.patch
 $ cat Makefile
all: hello

hello: hello.c
        gcc -Wall -o hello hello.c

install: hello
        install -D hello /usr/local/bin/hello

clean:
        -rm -f hello

distclean: clean

.PHONY: all install clean distclean




The vim command edits the Makefile to support $(DESTDIR)..


The "dquilt refresh …" command records the modification as the -p1 patch in the debian/patches/ directory.






 $ vim Makefile
 ...
 $ cat Makefile
all: hello

hello: hello.c
        gcc -Wall -o hello hello.c

install: hello
        install -D hello $(DESTDIR)/usr/bin/hello

clean:
        -rm -f hello

distclean: clean

.PHONY: all install clean distclean
 $ dquilt refresh
Refreshed patch debian/patches/0001-destdir.patch
 $ cat debian/patches/0001-destdir.patch
Index: hello-c-0.9/Makefile
===================================================================
--- hello-c-0.9.orig/Makefile
+++ hello-c-0.9/Makefile
@@ -4,7 +4,7 @@ hello: hello.c
        gcc -Wall -o hello hello.c

 install: hello
-       install -D hello /usr/local/bin/hello
+       install -D hello $(DESTDIR)/usr/bin/hello

 clean:
        -rm -f hello




The "dquilt header -e …" command adds the DEP-3: Patch Tagging Guidelines compatible patch header.


The "dquilt pop -a" command removes all applied patches from the source.






 $ dquilt header -e
 ...
 $ cat debian/patches/0001-destdir.patch
From: Foo Bar <foo@example.org>
Description: make Makefile to support GNU coding standard
 $DESTDIR: debian/hello-c
 $prefix:  /usr/local -> /usr

Index: hello-c-0.9/Makefile
===================================================================
--- hello-c-0.9.orig/Makefile
+++ hello-c-0.9/Makefile
@@ -4,7 +4,7 @@ hello: hello.c
        gcc -Wall -o hello hello.c

 install: hello
-       install -D hello /usr/local/bin/hello
+       install -D hello $(DESTDIR)/usr/bin/hello

 clean:
        -rm -f hello
 $ dquilt pop -a
Removing patch debian/patches/0001-destdir.patch
Restoring Makefile

No patches applied
 $ cat debian/patches/series
### The patch files of the -p1 format included in the debian/patches direct...
### are applied to the upstream source in the order listed below.
### This is manually managed by users with dquilt (quilt(1) wrapper) etc.
### Also this may be updated by dpkg-source(1) when making a package.
0001-destdir.patch




For the proper packaging, you are required to make further modification here.


For learning purpose, let’s leave such details and move on. You can create a non-native Debian package using the debuild command (or its equivalents) in this source tree.






 $ cd hello-c-0.9
 $ debuild
 dpkg-buildpackage -rfakeroot -D -us -uc -i
 ...
dpkg-source: info: applying 0001-destdir.patch
 fakeroot debian/rules clean
dh clean
 ...
 debian/rules build
dh build
 ...
 fakeroot debian/rules binary
dh binary
 ...
Finished running lintian.




Let’s inspect files.




The generated files of version 0.9 by the debuild command:




 $ cd ..
 $ tree -L 1
.
├── hello-c-0.9
├── hello-c_0.9-1_amd64.build
├── hello-c_0.9-1_amd64.changes
├── hello-c_0.9-1_amd64.deb
├── hello-c_0.9-1.debian.tar.xz
├── hello-c_0.9-1.dsc
├── hello-c_0.9.orig.tar.gz -> hello-c-0.9.tar.gz
└── hello-c-0.9.tar.gz

1 directory, 7 files






The source package contents of version 0.9:




 $ dpkg -c hello-c_0.9-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/bin/
-rwxr-xr-x root/root ...  ./usr/bin/hello
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/hello-c/
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/changelog.Debian.gz
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/README.Debian
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/copyright






The binary package contents of version 0.9:




 $ tar -tJf hello-c_0.9-1.debian.tar.xz
debian/
debian/patches/
debian/patches/0001-destdir.patch
debian/patches/series
debian/control
debian/changelog
debian/rules
debian/source/
debian/source/format
debian/README.Debian
debian/compat
debian/watch
debian/copyright
 $ tar -tzf hello-c-0.9.tar.gz
hello-c-0.9/
hello-c-0.9/Makefile
hello-c-0.9/hello.c










Snapshot (simple)


Let’s consider an upstream source in the VCS and make a snapshot package from it.


Let’s inspect files.




VCS source tree




 $ tree
.
└── hello-c
    ├── hello.c
    └── Makefile

1 directory, 2 files




The source is the same one as [singlepkg] but the parent directory lacks the version part.  This is typical for the source in the VCS.


You create a non-native Debian package source tree from the above upstream example using the debmake(1) command.




git and debmake




 $ cd hello-c
 $ git init
Initialized empty Git repository in /path/to/hello-c/.git/
 $ git add .
 $ git commit -m "initial commit"
[master (root-commit) 4c36228] initial commit
 2 files changed, 21 insertions(+)
 create mode 100644 Makefile
 create mode 100644 hello.c
 $ git checkout -b devel
Switched to a new branch 'devel'
 $ git branch
* devel
  master
 $ debmake -t
D: /usr/bin/debmake started
D: PYTHONPATH = /usr/bin:/usr/lib/python3.4:/usr/lib/python3.4/plat-x86_64-...
I: set parameters
I: sanity check of parameters
I: pkg="hello-c", ver="0~1410131523", rev="1"
I: make the upstream tarball with "tar --exclude=debian"
I: pwd = "/path/to/hello-c"
I: pwd = "/path/to"
I: $ rsync -aCv --link-dest=/path/to/hello-c hello-c/. hello-c-0~1410131523...
sending incremental file list
 ...
I: debmake -x "1" ...
 ...
I: run "debmake -x2" to get more template files
I: $ wrap-and-sort
I: upon return to the shell, current directory becomes /path/to/hello-c
I: please execute "cd /path/to/hello-c-0~1410131523" before building the bi...
I: with dpkg-buildpackage (or debuild, pdebuild, sbuild, ...).




Let’s inspect files.






 $ cd ..
 $ tree
.
├── hello-c
│   ├── hello.c
│   └── Makefile
├── hello-c-0~1410131523
│   ├── debian
│   │   ├── changelog
│   │   ├── compat
│   │   ├── control
│   │   ├── copyright
│   │   ├── patches
│   │   │   └── series
│   │   ├── README.Debian
│   │   ├── rules
│   │   ├── source
│   │   │   ├── format
│   │   │   └── local-options
│   │   └── watch
│   ├── hello.c
│   └── Makefile
├── hello-c_0~1410131523.orig.tar.gz -> hello-c-0~1410131523.tar.gz
└── hello-c-0~1410131523.tar.gz

5 directories, 16 files




There are many files:


    

  • 

    
the snapshot upstream tarball: hello-0~1410131523.tar.gz (hello-c_0~1410131523.orig.tar.gz)

    

    • 

  • 

    
the snapshot upstream source tree with template files generated by the debmake command: hello-c-0~1410131523/*

    

    • 

  • 

    
the cleaned VCS directory: hello-c-0~1410131523/*

    

    • 



For the proper packaging, you are required to make further modification using these auto-generated template files in the hello-c-0~1410131523/debian directory. For learning purpose, let’s leave such details and move on. You can create a non-native Debian package using the debuild command (or its equivalent) in this source tree.






 $ cd hello-c-0~1410131523
 $ debuild
 dpkg-buildpackage -rfakeroot -D -us -uc -i
 ...
 fakeroot debian/rules clean
dh clean
 ...
 debian/rules build
dh build
 ...
 fakeroot debian/rules binary
dh binary
 ...
Finished running lintian.




Let’s inspect the result.






 $ cd ..
 $ tree -L 1
.
├── hello-c
├── hello-c-0~1410131523
├── hello-c_0~1410131523-1_amd64.build
├── hello-c_0~1410131523-1_amd64.changes
├── hello-c_0~1410131523-1_amd64.deb
├── hello-c_0~1410131523-1.debian.tar.xz
├── hello-c_0~1410131523-1.dsc
├── hello-c_0~1410131523.orig.tar.gz -> hello-c-0~1410131523.tar.gz
└── hello-c-0~1410131523.tar.gz

2 directories, 7 files








 $ dpkg -c hello-c_0~1410131523-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/bin/
-rwxr-xr-x root/root ...  ./usr/bin/hello
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/hello-c/
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/changelog.Debian.gz
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/README.Debian
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/copyright








 $ tar -tJf hello-c_0~1410131523-1.debian.tar.xz
debian/
debian/patches/
debian/patches/series
debian/control
debian/changelog
debian/rules
debian/source/
debian/source/format
debian/README.Debian
debian/compat
debian/watch
debian/copyright
 $ tar -tzf hello-c-0~1410131523.tar.gz
hello-c-0~1410131523/
hello-c-0~1410131523/Makefile
hello-c-0~1410131523/hello.c




Your development branch holding the working upstream source tree and the debian/* files is the devel branch.


The following will import generated Debian packages to master, upstream, and pristine-tar branches. (These are the 3 typical branches used by the gbp command.)






 $ cd hello-c
 $ git-import-dsc ../hello-c_0~1410131523-1.dsc  \
                  --pristine-tar --create-missing-branches
gbp:info: Tag upstream/0_1410131523 not found, importing Upstream tarball
gbp:info: Creating missing branch 'upstream'
pristine-tar: committed hello-c_0~1410131523.orig.tar.gz.delta to branch pr...
gbp:info: Version '0~1410131523-1' imported under 'hello-c'
 $ git branch
* devel
  master
  pristine-tar
  upstream
 $ gitk --all




The gitk command shows the VCS history nicely.






Snapshot (Autotools)


Let’s make this upstream source in the VCS more fun to use the Autotools (=Autoconf + Automake).  The upstream VCS does not contain auto-generated files while the distributed tarball for the snapshot package has many auto-generated files.


Let’s inspect files.




VCS source tree




 $ tree
.
└── vcsdir
    ├── configure.ac
    ├── hello.c
    └── Makefile.am

1 directory, 3 files




Here are minimalistic configuration files for Autotools specifying the upstream version to be 1.5.




configure.ac:




 $ cat vcsdir/configure.ac
#                                               -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
AC_PREREQ([2.69])
AC_INIT([hello-c], [1.5], [foo@example.org])
AC_CONFIG_SRCDIR([hello.c])
AC_CONFIG_HEADERS([config.h])
# Manually added
AM_INIT_AUTOMAKE([foreign])
# Checks for programs.
AC_PROG_CC
AC_CONFIG_FILES([Makefile])
AC_OUTPUT






Makefile.am:




 $ cat vcsdir/Makefile.am
bin_PROGRAMS = hello
hello_SOURCES = hello.c




The C source hello.c is the same one as before.


You create a non-native Debian package source tree from the above upstream example using the debmake(1) command.




git and debmake




 $ cd vcsdir
 $ git init
Initialized empty Git repository in /path/to/vcsdir/.git/
 $ git add .
 $ git commit -m "initial commit"
[master (root-commit) 32c68a6] initial commit
 3 files changed, 21 insertions(+)
 create mode 100644 Makefile.am
 create mode 100644 configure.ac
 create mode 100644 hello.c
 $ git checkout -b devel
Switched to a new branch 'devel'
 $ git branch
* devel
  master
 $ debmake -d
D: /usr/bin/debmake started
D: PYTHONPATH = /usr/bin:/usr/lib/python3.4:/usr/lib/python3.4/plat-x86_64-...
I: set parameters
I: sanity check of parameters
I: pkg="", ver="", rev="1"
I: make the upstream tarball with "make dist" equivalents
I: pwd = "/path/to/vcsdir"
I: $ autoreconf -ivf && ./configure --prefix "/usr" && make distcheck
autoreconf: Entering directory `.'
 ...
I: debmake -x "1" ...
 ...
I: run "debmake -x2" to get more template files
I: $ wrap-and-sort
I: upon return to the shell, current directory becomes /path/to/vcsdir
I: please execute "cd /path/to/hello-c-1.5" before building the binary pack...
I: with dpkg-buildpackage (or debuild, pdebuild, sbuild, ...).




Let’s clean vcsdir/ since it has so many Autotools generated files.






 $ git clean -d -f -x
Removing .deps/
Removing Makefile
Removing Makefile.in
Removing aclocal.m4
Removing autom4te.cache/
Removing compile
Removing config.h
Removing config.h.in
Removing config.log
Removing config.status
Removing configure
Removing depcomp
Removing hello-c-1.5.tar.gz
Removing install-sh
Removing missing
Removing stamp-h1




Let’s inspect files.






 $ cd ..
 $ tree
.
├── hello-c-1.5
│   ├── aclocal.m4
│   ├── compile
│   ├── config.h.in
│   ├── configure
│   ├── configure.ac
│   ├── debian
│   │   ├── changelog
│   │   ├── compat
│   │   ├── control
│   │   ├── copyright
│   │   ├── patches
│   │   │   └── series
│   │   ├── README.Debian
│   │   ├── rules
│   │   ├── source
│   │   │   ├── format
│   │   │   └── local-options
│   │   └── watch
│   ├── depcomp
│   ├── hello.c
│   ├── install-sh
│   ├── Makefile.am
│   ├── Makefile.in
│   └── missing
├── hello-c_1.5.orig.tar.gz -> hello-c-1.5.tar.gz
├── hello-c-1.5.tar.gz
└── vcsdir
    ├── configure.ac
    ├── hello.c
    └── Makefile.am

5 directories, 26 files




There are many files:


    

  • 

    
the snapshot upstream tarball: hello-1.5.tar.gz (hello-c_1.5.orig.tar.gz)

    

    • 

  • 

    
the snapshot upstream source tree with template files generated by the debmake command: hello-c-1.5/*

    

    • 

  • 

    
the cleaned VCS directory: vcsdir/*

    

    • 



For the proper packaging, you are required to make further modification using these auto-generated template files in the hello-c-1.5/debian directory. For learning purpose, let’s leave such details and move on. You can create a non-native Debian package using the debuild command (or its equivalent) in this source tree.






 $ cd hello-c-1.5
 $ debuild
 dpkg-buildpackage -rfakeroot -D -us -uc -i
 ...
 fakeroot debian/rules clean
dh clean --with autoreconf
 ...
 debian/rules build
dh build --with autoreconf
 ...
 fakeroot debian/rules binary
dh binary --with autoreconf
 ...
Finished running lintian.




Let’s inspect the result.






 $ cd ..
 $ tree -L 1
.
├── hello-c-1.5
├── hello-c_1.5-1_amd64.build
├── hello-c_1.5-1_amd64.changes
├── hello-c_1.5-1_amd64.deb
├── hello-c_1.5-1.debian.tar.xz
├── hello-c_1.5-1.dsc
├── hello-c_1.5.orig.tar.gz -> hello-c-1.5.tar.gz
├── hello-c-1.5.tar.gz
└── vcsdir

2 directories, 7 files








 $ dpkg -c hello-c_1.5-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/bin/
-rwxr-xr-x root/root ...  ./usr/bin/hello
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/hello-c/
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/changelog.Debian.gz
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/README.Debian
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/copyright








 $ tar -tJf hello-c_1.5-1.debian.tar.xz
debian/
debian/patches/
debian/patches/series
debian/control
debian/changelog
debian/rules
debian/source/
debian/source/format
debian/README.Debian
debian/compat
debian/watch
debian/copyright
 $ tar -tzf hello-c-1.5.tar.gz
hello-c-1.5/
hello-c-1.5/config.h.in
hello-c-1.5/Makefile.am
hello-c-1.5/Makefile.in
hello-c-1.5/hello.c
hello-c-1.5/configure
hello-c-1.5/depcomp
hello-c-1.5/missing
hello-c-1.5/configure.ac
hello-c-1.5/install-sh
hello-c-1.5/compile
hello-c-1.5/aclocal.m4




Your development branch holding the real upstream source tree is the devel branch.


The following will import generated Debian packages to master, upstream, and pristine-tar branches.






 $ cd vcsdir
 $ git-import-dsc ../hello-c_1.5-1.dsc  \
                  --pristine-tar --create-missing-branches
gbp:info: Tag upstream/1.5 not found, importing Upstream tarball
gbp:info: Creating missing branch 'upstream'
pristine-tar: committed hello-c_1.5.orig.tar.gz.delta to branch pristine-ta...
gbp:info: Version '1.5-1' imported under 'hello-c'
 $ git branch
* devel
  master
  pristine-tar
  upstream
 $ gitk --all




The gitk command shows the VCS history nicely.






Snapshot (Python)


Let’s consider another upstream source in the VCS and make a snapshot package from it.  Let’s assume this is a Python3 source package with the distutils.


Let’s inspect files.






 $ tree
.
└── vcsdir
    ├── hello-py
    │   └── __init__.py
    ├── MANIFEST
    ├── MANIFEST.in
    ├── PKG-INFO
    ├── scripts
    │   └── hello
    └── setup.py

3 directories, 6 files




Here are minimalistic configuration files for distutils with the upstream version 1.0..




setup.py:




 $ cat vcsdir/setup.py
#!/usr/bin/python3
# vi:se ts=4 sts=4 et ai:
from distutils.core import setup

setup(name='hello-py',
    version='1.0',
    description='Hello Python',
    long_description='Hello Python program.',
    author='Osamu Aoki',
    author_email='osamu@debian.org',
    url='http://people.debian.org/~osamu/',
    packages=['hello-py'],
    package_dir={'hello-py': 'hello-py'},
    scripts=['scripts/hello'],
    classifiers = ['Development Status :: 3 - Alpha',
        'Environment :: Console',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Operating System :: POSIX :: Linux',
        'Programming Language :: Python :: 3',
        'Topic :: Utilities',
    ],
    platforms   = 'POSIX',
    license     = 'MIT License'
)




The Python program code is as follows.




scripts/hello and hello-py/init.py




 $ cat vcsdir/scripts/hello
#!/usr/bin/python3
# vim:se tw=0 sts=4 ts=4 et si:
"""
Copyright © 2014 Osamu Aoki
 ...
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
"""

import hello-py

if __name__ == '__main__':
    hello.main()

 $ cat vcsdir/hello-py/__init__.py
#!/usr/bin/python3
# vim:se tw=0 sts=4 ts=4 et ai:

def main():
    print('Hello Python3!')
    return

if __name__ == '__main__':
    main()




You create a non-native Debian package source tree from the above upstream example using the debmake(1) command.  Here package description is copied from the upstream setup.py content by the -s option.






 $ cd vcsdir
 $ git init
Initialized empty Git repository in /path/to/vcsdir/.git/
 $ git add .
 $ git commit -m "initial commit"
[master (root-commit) 38039fe] initial commit
 6 files changed, 93 insertions(+)
 create mode 100644 MANIFEST
 create mode 100644 MANIFEST.in
 create mode 100644 PKG-INFO
 create mode 100755 hello-py/__init__.py
 create mode 100755 scripts/hello
 create mode 100755 setup.py
 $ git branch devel
 $ git branch upstream
 $ git branch
  devel
* master
  upstream
 $ debmake -s -b':python3' -d -i debuild
 ...
I: debmake -x "1" ...
 ...
Finished running lintian.
I: upon return to the shell, current directory becomes /path/to/vcsdir
I: please execute "cd .." and inspect the build results.
 $ git clean -d -f
Removing dist/




Let’s inspect the result.






 $ cd ..
 $ tree -L 1
.
├── hello-py-1.0
├── hello-py_1.0-1_all.deb
├── hello-py_1.0-1_amd64.build
├── hello-py_1.0-1_amd64.changes
├── hello-py_1.0-1.debian.tar.xz
├── hello-py_1.0-1.dsc
├── hello-py_1.0.orig.tar.gz -> hello-py-1.0.tar.gz
├── hello-py-1.0.tar.gz
└── vcsdir

2 directories, 7 files








 $ dpkg -c hello-py_1.0-1_all.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/bin/
-rwxr-xr-x root/root ...  ./usr/bin/hello
drwxr-xr-x root/root ...  ./usr/lib/
drwxr-xr-x root/root ...  ./usr/lib/python3/
drwxr-xr-x root/root ...  ./usr/lib/python3/dist-packages/
-rw-r--r-- root/root ...  ./usr/lib/python3/dist-packages/hello_py-1.0.egg-...
drwxr-xr-x root/root ...  ./usr/lib/python3/dist-packages/hello-py/
-rw-r--r-- root/root ...  ./usr/lib/python3/dist-packages/hello-py/__init__...
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/hello-py/
-rw-r--r-- root/root ...  ./usr/share/doc/hello-py/changelog.Debian.gz
-rw-r--r-- root/root ...  ./usr/share/doc/hello-py/README.Debian
-rw-r--r-- root/root ...  ./usr/share/doc/hello-py/copyright








 $ tar -tJf hello-py_1.0-1.debian.tar.xz
debian/
debian/patches/
debian/patches/series
debian/control
debian/changelog
debian/rules
debian/source/
debian/source/format
debian/README.Debian
debian/compat
debian/watch
debian/copyright
 $ tar -tzf hello-py-1.0.tar.gz
hello-py-1.0/
hello-py-1.0/MANIFEST.in
hello-py-1.0/MANIFEST
hello-py-1.0/PKG-INFO
hello-py-1.0/hello-py/
hello-py-1.0/hello-py/__init__.py
hello-py-1.0/setup.py
hello-py-1.0/scripts/
hello-py-1.0/scripts/hello




Let’s check the generated control file content.






 $ dpkg -e hello-py_1.0-1_all.deb
 $ tree DEBIAN
DEBIAN
├── control
├── md5sums
├── postinst
└── prerm

0 directories, 4 files




Let’s compare how the packaging process converts the substvar etc.




debian/control in the source package




 $ cat hello-py-1.0/debian/control
Source: hello-py
Section: unknown
Priority: extra
Maintainer: "Firstname Lastname" <email.address@example.org>
Build-Depends: debhelper (>=9), dh-python, python3-all
Standards-Version: 3.9.5
Homepage: <insert the upstream URL, if relevant>
X-Python3-Version: >= 3.2

Package: hello-py
Architecture: all
Multi-Arch: foreign
Depends: ${misc:Depends}, ${python3:Depends}
Description: Hello Python
 Hello Python program.






DEBIAN/control in the binary package




 $ cat DEBIAN/control
Package: hello-py
Version: 1.0-1
Architecture: all
Maintainer: "Firstname Lastname" <email.address@example.org>
Installed-Size: 50
Depends: python3:any (>= 3.3.2-2~), python3
Section: unknown
Priority: extra
Multi-Arch: foreign
Homepage: <insert the upstream URL, if relevant>
Description: Hello Python
 Hello Python program.








Multi binary package


Let’s consider an upstream package hello-1.1.tar.gz and untar it to inspect files.






 $ tree
.
├── hello-1.1
│   ├── hello.c
│   ├── hello.data
│   ├── hello-sh
│   └── Makefile
└── hello-1.1.tar.gz

1 directory, 5 files




This is similar to the previously shown hello-c-1.0.tar.gz  but with a few additional files and changes.


The C source hello.c is the same one.


Makefile is updated to support $(DESTDIR) for all files.






 $ cat hello-1.1/Makefile
all: hello

hello: hello.c
        gcc -Wall -o hello hello.c

install: hello hello.data
        install -D hello $(DESTDIR)/usr/bin/hello
        install -D hello-sh $(DESTDIR)/usr/bin/hello-sh
        install -D hello.data $(DESTDIR)/usr/share/hello/hello.data

clean:
        -rm -f hello

distclean: clean

.PHONY: all install clean distclean




There is an additional simple shell script hello-sh.






 $ cat hello-1.1/hello-sh
#!/bin/sh
echo "Hello from the shell!"




The hello.data file is a dummy data for this training.


Let’s create a set of the following non-native binary Debian packages.


    

  • 

    
hello-c : type=bin, This package contains an ELF executable hello file compiled from the source file hello.c.

    

    • 

  • 

    
hello-c-dbg : type=dbg, This package contains debug symbols data of the ELF executable file hello.

    

    • 

  • 

    
hello-sh : type=script, This contains the shell script hello-sh.

    

    • 

  • 

    
hello-data : type=data, This contains the data file hello.data.

    

    • 



Since we are splitting the generated files into multiple packages, we package this in two steps.  The first step is the "debmake -j …" command (see [testbuild]).




The debmake execution (1st stage)




 $ cd hello-1.1
 $ debmake -j -b'-c,-c-dbg,-data:data,-sh:script'
 ...
 ... (snip)
 ...
I: $ LANG=C ; sed -e "1d" < ../hello.depcheck.log | sort >../hello.build-de...
I: $ LANG=C; find debian/tmp -type f 2>&1 | sed -e "s/^debian\/tmp\///" | s...
I: upon return to the shell, current directory becomes /path/to/hello-1.1
I: please execute "cd /path/to/hello-1.1" before building the binary packag...
I: with dpkg-buildpackage (or debuild, pdebuild, sbuild, ...).






The parent directory after the "debmake -j …" execution.




 $ cd ..
 $ tree -L 1
.
├── hello-1.1
├── hello_1.1.orig.tar.gz -> hello-1.1.tar.gz
├── hello-1.1.tar.gz
├── hello.build-dep.log
├── hello.build.log
├── hello.depcheck.log
└── hello.install.log

1 directory, 6 files




There are 2 log files in the parent directory.




hello.build-dep.log generated by the dpkg-depcheck command




 $ cat hello.build-dep.log
  debhelper
  libfakeroot:amd64
  liblocale-gettext-perl
  make-guile
  perl-modules




The build dependency to the debhelper package is always implemented by the debmake command.


The dependency to other packages (libfakeroot:amd64, liblocale-gettext-perl, perl-modules) seems to be false positives caused by the build tools used such as the pdebuild command.


For this packaging case, there is no additional package required be listed as the build dependency.




hello.install.log listing files under the debian/tmp directory




 $ cat hello.install.log
usr/bin/hello
usr/bin/hello-sh
usr/share/hello/hello.data




Now we know what files are generated in the debian/tmp directory.


Let’s start with the fresh source tree and build package from there.  Let’s skip generating tutorial comment lines by using the -Q option.




The debmake execution (2nd stage)




 $ rm -rf hello-1.1
 $ debmake -Q -b'-c,-c-dbg,-data:data,-sh:script' -a hello-1.1.tar.gz
D: /usr/bin/debmake started
D: PYTHONPATH = /usr/bin:/usr/lib/python3.4:/usr/lib/python3.4/plat-x86_64-...
I: set parameters
 ...
I: parse binary package settings: -c,-c-dbg,-data:data,-sh:script
I: binary package=hello-c Type=bin / Arch=any M-A=foreign
I: binary package=hello-c-dbg Type=dbg / Arch=any M-A=same
I: binary package=hello-data Type=data / Arch=all M-A=foreign
I: binary package=hello-sh Type=script / Arch=all M-A=foreign
 ...
I: debmake -x "2" ...
 ...
I: $ wrap-and-sort
I: upon return to the shell, current directory becomes /path/to
I: please execute "cd /path/to/hello-1.1" before building the binary packag...
I: with dpkg-buildpackage (or debuild, pdebuild, sbuild, ...).




Please note that the debmake command is run with the -x2 option as the default for the new multi binary packages.






 $ cd hello-1.1
 $ tree
.
├── debian
│   ├── changelog
│   ├── clean
│   ├── compat
│   ├── control
│   ├── copyright
│   ├── hello-c.doc-base
│   ├── hello-c.docs
│   ├── hello-c.examples
│   ├── hello-c.info
│   ├── hello-c.install
│   ├── hello-c.links
│   ├── hello-c.manpages
│   ├── hello-c.menu
│   ├── hello-c.postinst
│   ├── hello-c.postrm
│   ├── hello-c.preinst
│   ├── hello-c.prerm
│   ├── hello-data.install
│   ├── hello-sh.install
│   ├── patches
│   │   └── series
│   ├── README.Debian
│   ├── rules
│   ├── source
│   │   ├── format
│   │   └── local-options
│   └── watch
├── hello.c
├── hello.data
├── hello-sh
└── Makefile

3 directories, 29 files




Let’s inspect generated template files.




debian/rules:




 $ cat debian/rules
#!/usr/bin/make -f
#DH_VERBOSE = 1
#export DEB_BUILD_MAINT_OPTIONS = hardening=+all
#export DEB_CFLAGS_MAINT_APPEND  = -Wall -pedantic
#export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed

%:
        dh $@

override_dh_strip:
        dh_strip --dbg-package=hello-c-dbg




This is essentially the standard debian/rules file with the dh command with override_dh_strip to create a debug package. (There are some commented out contents for you to customize it.)




debian/control:




 $ cat debian/control
Source: hello
Section: unknown
Priority: extra
Maintainer: "Firstname Lastname" <email.address@example.org>
Build-Depends: debhelper (>=9)
Standards-Version: 3.9.5
Homepage: <insert the upstream URL, if relevant>

Package: hello-c
Architecture: any
Multi-Arch: foreign
Depends: ${misc:Depends}, ${shlibs:Depends}
Description: auto-generated package by debmake: bin
 This package contains the compiled binary executable.
 ...
 ... (snip)
 ...

Package: hello-c-dbg
Section: debug
Architecture: any
Multi-Arch: same
Depends: hello-c (= ${binary:Version}), ${misc:Depends}
Description: auto-generated package by debmake: dbg
 This package contains the debugging symbols.

Package: hello-data
Architecture: all
Multi-Arch: foreign
Depends: ${misc:Depends}
Description: auto-generated package by debmake: data
 This package contains the architecture independent data.

Package: hello-sh
Architecture: all
Multi-Arch: foreign
Depends: ${misc:Depends}
Description: auto-generated package by debmake: script
 This package contains the script program.




It is nice to see that the template files are generated with reasonable contents.


There are several template files under the debian/ directory.  Let’s customize them and erase unnecessary ones. (Here, we are skipping details required by the best practice.)




Manual adjustments of debian/*




 $ cd ./debian
 $ rm -f *.do* *.examples *.info *.links *.m*  *.p*
 $ rm hello-c-dbg.install
rm: cannot remove ‘hello-c-dbg.install’: No such file or directory
 $ echo usr/bin/hello > hello-c.install
 $ echo usr/share/hello/hello.data > hello-data.install
 $ echo usr/bin/hello-sh > hello-sh.install




You can create a non-native Debian package using the debuild command (or its equivalents) in this source tree.






 $ cd ..
 $ debuild
 dpkg-buildpackage -rfakeroot -D -us -uc -i
 ...
dpkg-buildpackage: host architecture amd64
 fakeroot debian/rules clean
dh clean
 ...
 debian/rules build
dh build
 ...
 fakeroot debian/rules binary
dh binary
 ...
Finished running lintian.




Let’s inspect the result.




The generated files of version 1.0 by the debuild command:




 $ cd ..
 $ tree -L 1
.
├── hello-1.1
├── hello_1.1-1_amd64.build
├── hello_1.1-1_amd64.changes
├── hello_1.1-1.debian.tar.xz
├── hello_1.1-1.dsc
├── hello_1.1.orig.tar.gz -> hello-1.1.tar.gz
├── hello-1.1.tar.gz
├── hello.build-dep.log
├── hello.build.log
├── hello-c_1.1-1_amd64.deb
├── hello-c-dbg_1.1-1_amd64.deb
├── hello-data_1.1-1_all.deb
├── hello.depcheck.log
├── hello.install.log
└── hello-sh_1.1-1_all.deb

1 directory, 14 files






The source package contents of version 1.0:




 $ tar -tJf hello_1.1-1.debian.tar.xz
debian/
debian/patches/
debian/patches/series
debian/control
debian/hello-sh.install
debian/changelog
debian/clean
debian/rules
debian/source/
debian/source/format
debian/README.Debian
debian/compat
debian/hello-data.install
debian/watch
debian/hello-c.install
debian/copyright
 $ tar -tzf hello-1.1.tar.gz
hello-1.1/
hello-1.1/hello-sh
hello-1.1/Makefile
hello-1.1/hello.c
hello-1.1/hello.data






The binary package contents of version 1.0:




 $ dpkg -c hello-c_1.1-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/bin/
-rwxr-xr-x root/root ...  ./usr/bin/hello
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/hello-c/
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/changelog.Debian.gz
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/README.Debian
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c/copyright
 $ dpkg -c hello-c-dbg_1.1-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/lib/
drwxr-xr-x root/root ...  ./usr/lib/debug/
drwxr-xr-x root/root ...  ./usr/lib/debug/.build-id/
drwxr-xr-x root/root ...  ./usr/lib/debug/.build-id/e5/
-rw-r--r-- root/root ...  ./usr/lib/debug/.build-id/e5/0948fb440ec9f6ffcf37...
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/hello-c-dbg/
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c-dbg/changelog.Debian.gz
-rw-r--r-- root/root ...  ./usr/share/doc/hello-c-dbg/copyright
 $ dpkg -c hello-data_1.1-1_all.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/hello/
-rwxr-xr-x root/root ...  ./usr/share/hello/hello.data
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/hello-data/
-rw-r--r-- root/root ...  ./usr/share/doc/hello-data/changelog.Debian.gz
-rw-r--r-- root/root ...  ./usr/share/doc/hello-data/copyright
 $ dpkg -c hello-sh_1.1-1_all.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/bin/
-rwxr-xr-x root/root ...  ./usr/bin/hello-sh
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/hello-sh/
-rw-r--r-- root/root ...  ./usr/share/doc/hello-sh/changelog.Debian.gz
-rw-r--r-- root/root ...  ./usr/share/doc/hello-sh/copyright









Note


For the normal multi binary package case, you must provide binarypackage.install files for all binary packages (excluding dbg type ones).  The build result is split into the binary packages by moving files from the debian/tmp/ directory to the directories named after the binary packages.









Library package


Let’s consider an upstream package libkkc-0.3.2.tar.gz.




Step 0: Untar …




 $ tar -xzmf libkkc-0.3.2.tar.gz
 $ cd libkkc-0.3.2
 $ git init
Initialized empty Git repository in /path/to/libkkc-0.3.2/.git/
 $ git add .
 $ git commit -m 'initial import of libkkc-0.3.2.tar.gz'
[master (root-commit) dd36e4b] initial import of libkkc-0.3.2.tar.gz
 423 files changed, 211360 insertions(+)
 ...
 ... (snip)
 ...
 create mode 100644 tools/kkc.vala
 create mode 100644 tools/kkc_vala.stamp
 $ git branch upstream
 $ git tag upstream/0.3.2
 $ pristine-tar commit ../libkkc-0.3.2.tar.gz
pristine-tar: committed libkkc-0.3.2.tar.gz.delta to branch pristine-tar




Let’s make a test build this with the -j option (see [testbuild]).




Step 1: debmake -j




 $ debmake -j
D: /usr/bin/debmake started
D: PYTHONPATH = /usr/bin:/usr/lib/python3.4:/usr/lib/python3.4/plat-x86_64-...
I: set parameters
I: sanity check of parameters
I: pkg="libkkc", ver="0.3.2", rev="1"
I: *** start packaging in "libkkc-0.3.2". ***
I: provide libkkc_0.3.2.orig.tar.gz for non-native Debian package
 ...
 ... (snip)
 ...
I: $ wrap-and-sort
I: $ fakeroot dpkg-depcheck -m -C -o ../libkkc.depcheck.log -f -catch-alter...
I: $ LANG=C ; sed -e "1d" < ../libkkc.depcheck.log | sort >../libkkc.build-...
I: $ LANG=C; find debian/libkkc -type f 2>&1 | sed -e "s/^debian\/libkkc\//...
I: upon return to the shell, current directory becomes /path/to/libkkc-0.3....
I: please execute "cd /path/to/libkkc-0.3.2" before building the binary pac...
I: with dpkg-buildpackage (or debuild, pdebuild, sbuild, ...).




Let’s inspect the package dependency.




libkkc.build-dep.log




 $ cat ../libkkc.build-dep.log
  bison
  cmake-data
  cpio
  dh-autoreconf
  gawk
  gobject-introspection
  gtk-doc-tools
  gvfs:amd64
  libc6-i386
  libc6-x32
  libexpat1-dev:amd64
  libfakechroot:amd64
  libfakeroot:amd64
  libfreetype6-dev
  libgee-dev
  libgirepository-1.0-1
  libgirepository1.0-dev
  libglib2.0-dev
  libgpg-error-dev
  libgtk-3-dev
  libgtk2.0-dev
  libjson-glib-dev
  liblocale-gettext-perl
  libltdl-dev:amd64
  libmarisa-dev:amd64
  libnspr4-dev
  libpython2.7-stdlib:amd64
  libselinux1:i386
  libwayland-dev
  libxml2-dev:amd64
  mime-support
  perl-modules
  python-gobject-2
  python-imaging
  python-input-pad
  python-marisa
  python-repoze.lru
  python-setuptools
  python-zope.interface
  python2.7-minimal
  valac-0.24
  valac-0.24-vapi
  xfonts-utils
  xtrans-dev
  zlib1g:i386




Let’s inspect the generated files.




libkkc.install.log




 $ cat ../libkkc.install.log
usr/bin/kkc
usr/bin/kkc-package-data
usr/include/libkkc/libkkc.h
usr/lib/x86_64-linux-gnu/girepository-1.0/Kkc-1.0.typelib
usr/lib/x86_64-linux-gnu/libkkc.la
usr/lib/x86_64-linux-gnu/libkkc.so.2.0.0
usr/lib/x86_64-linux-gnu/pkgconfig/kkc-1.0.pc
usr/share/doc/libkkc/README.Debian
 ...
 ... (snip)
 ...
usr/share/libkkc/templates/libkkc-data/tools/genfilter.py
usr/share/libkkc/templates/libkkc-data/tools/sortlm.py
usr/share/locale/ja/LC_MESSAGES/libkkc.mo
usr/share/vala/vapi/kkc-1.0.deps
usr/share/vala/vapi/kkc-1.0.vapi




Let’s clean the source tree first.






 $ git reset --hard HEAD
HEAD is now at dd36e4b initial import of libkkc-0.3.2.tar.gz
 $ git clean -xfd
Removing Makefile
Removing autom4te.cache/
 ...
 ... (snip)
 ...
Removing tools/kkc
Removing tools/kkc-kkc.o
Removing tools/kkc-package-data




Let’s create the fresh source tree with the following package split plan.












binarypackage


type


-b option






libkkc2


lib


libkkc2






libkkc-utils


bin


-utils






libkkc2-dbg


dbg


libkkc2-dbg






libkkc-utils-dbg


dbg


-utils-dbg






libkkc-dev


dev


-dev






libkkc-common


data


-common:data













 $ debmake -b'libkkc2,-utils,libkkc2-dbg,-utils-dbg,-dev,-common:data'
D: /usr/bin/debmake started
D: PYTHONPATH = /usr/bin:/usr/lib/python3.4:/usr/lib/python3.4/plat-x86_64-...
I: set parameters
I: sanity check of parameters
I: pkg="libkkc", ver="0.3.2", rev="1"
I: *** start packaging in "libkkc-0.3.2". ***
I: provide libkkc_0.3.2.orig.tar.gz for non-native Debian package
I: pwd = "/path/to"
I: $ ln -sf libkkc-0.3.2.tar.gz libkkc_0.3.2.orig.tar.gz
 ...
 ... (snip)
 ...
I: skipping :: debian/libkkc2.install (file exists)
I: creating => debian/libkkc2.doc-base
I: creating => debian/libkkc-utils.install
I: creating => debian/libkkc-dev.install
I: creating => debian/libkkc-common.install
I: run "debmake -x3" to get more template files
I: $ wrap-and-sort




Let’s commit this result.






 $ git add -A .
 $ git commit -m debmake_template
[master d8b23d7] debmake_template
 27 files changed, 2860 insertions(+)
 create mode 100644 debian/README.Debian
 ...
 ... (snip)
 ...




This generates the following source tree. (Too large to list here.)






 $ tree
.
├── aclocal.m4
├── AUTHORS
├── autogen.sh
├── ChangeLog
├── compile
├── config.guess
├── config.h.in
├── config.sub
├── configure
├── configure.ac
├── COPYING
├── data
│   ├── Makefile.am
 ...
 ... (snip)
 ...
│   ├── user-segment-dictionary-bad2
│   ├── user-segment-dictionary-good
│   ├── user-sentence-dictionary-bad1
│   ├── user-sentence-dictionary-bad2
│   └── user-sentence-dictionary-good
└── tools
    ├── kkc.c
    ├── kkc-package-data.in
    ├── kkc.vala
    ├── kkc_vala.stamp
    ├── Makefile.am
    └── Makefile.in

95 directories, 438 files
 $ cd debian




Let’s make manual modifications to the files under the debian directory.




changelog




 $ vim changelog
 ...
 $ cat changelog
libkkc (0.3.2-1) unstable; urgency=low

  * First upload to debian archive (Closes: #715232)
  * Depends skkdic
  * Update debian/license

 -- Mitsuya Shibata <mty.shibata@gmail.com>  Wed, 26 Feb 2014 22:51:39 +090...






compat




 $ cat compat
9






control




 $ vim control
 ...
 $ cat control
Source: libkkc
Priority: extra
Maintainer: IME Packaging Team <pkg-ime-devel@lists.alioth.debian.org>
Uploaders: Mitsuya Shibata <mty.shibata@gmail.com>,
           Osamu Aoki <osamu@debian.org>
Build-Depends: autotools-dev,
               debhelper (>= 9),
               gobject-introspection,
               intltool,
               libgee-dev,
               libgirepository1.0-dev,
               libglib2.0-dev,
               libjson-glib-dev,
               libmarisa-dev,
               python-marisa,
               valac
Standards-Version: 3.9.5
Section: libs
Homepage: https://bitbucket.org/libkkc/libkkc/wiki/Home
Vcs-Git: git://anonscm.debian.org/pkg-ime/libkkc.git
Vcs-Browser: http://anonscm.debian.org/gitweb/?p=pkg-ime/libkkc.git

Package: libkkc2
Architecture: any
Multi-Arch: same
Pre-Depends: ${misc:Pre-Depends}
Depends: libkkc-common, libkkc-data, skkdic, ${misc:Depends}, ${shlibs:Depe...
Description: Japanese Kana Kanji input library
 libkkc provides a converter from Japanese Kana-string to
 Kana-Kanji-mixed-string. It was named after kkc.el in GNU Emacs, a simple ...
 Kanji converter, while libkkc tries to convert sentences in a bit more com...
 way using N-gram language models.
 .
 This package provides the shared library for libkkc.

Package: libkkc-utils
Section: utils
Architecture: any
Multi-Arch: foreign
Depends: libkkc-data,
         libkkc2 (= ${binary:Version}),
         ${misc:Depends},
         ${shlibs:Depends}
Description: Japanese Kana Kanji input library - testing utility
 libkkc provides a converter from Japanese Kana-string to
 Kana-Kanji-mixed-string. It was named after kkc.el in GNU Emacs, a simple ...
 Kanji converter, while libkkc tries to convert sentences in a bit more com...
 way using N-gram language models.
 .
 This package provides the testing utility for libkkc.

Package: libkkc2-dbg
Section: debug
Architecture: any
Multi-Arch: same
Depends: libkkc2 (= ${binary:Version}), ${misc:Depends}
Description: Japanese Kana Kanji input library - library debugging symbols
 libkkc provides a converter from Japanese Kana-string to
 Kana-Kanji-mixed-string. It was named after kkc.el in GNU Emacs, a simple ...
 Kanji converter, while libkkc tries to convert sentences in a bit more com...
 way using N-gram language models.
 .
 This package contains the debugging symbols for the shared library of libk...

Package: libkkc-utils-dbg
Section: debug
Architecture: any
Multi-Arch: same
Depends: libkkc-utils (= ${binary:Version}), ${misc:Depends}
Description: Japanese Kana Kanji input library - utility debugging symbols
 libkkc provides a converter from Japanese Kana-string to
 Kana-Kanji-mixed-string. It was named after kkc.el in GNU Emacs, a simple ...
 Kanji converter, while libkkc tries to convert sentences in a bit more com...
 way using N-gram language models.
 .
 This package contains the debugging symbols for the testing utility of lib...

Package: libkkc-dev
Section: libdevel
Architecture: any
Multi-Arch: same
Depends: libkkc2 (= ${binary:Version}), ${misc:Depends}
Description: Japanese Kana Kanji input library - development files
 libkkc provides a converter from Japanese Kana-string to
 Kana-Kanji-mixed-string. It was named after kkc.el in GNU Emacs, a simple ...
 Kanji converter, while libkkc tries to convert sentences in a bit more com...
 way using N-gram language models.
 .
 This package provides the files necessary for compiling programs that
 depend on libkkc.

Package: libkkc-common
Section: utils
Architecture: all
Multi-Arch: foreign
Depends: ${misc:Depends}
Description: Japanese Kana Kanji input library - common data
 libkkc provides a converter from Japanese Kana-string to
 Kana-Kanji-mixed-string. It was named after kkc.el in GNU Emacs, a simple ...
 Kanji converter, while libkkc tries to convert sentences in a bit more com...
 way using N-gram language models.
 .
 This package provides common data such as typing rules for libkkc.






copyright




 $ vim copyright
 ...
 $ cat copyright
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: libkkc
Source: https://bitbucket.org/libkkc/libkkc/wiki/Home

Files: *
Copyright: 2011-2013 Daiki Ueno <ueno@gnu.org>
           2011-2013 Red Hat, Inc.
License: GPL-3.0+
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.
 .
 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 .
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.

Files: debian/*
 ...
 ... (snip)
 ...

Files: INSTALL
Copyright: 1994-2011 Free Software Foundation, Inc.
License: PERMISSIVE
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
 notice and this notice are preserved.  This file is offered as-is,
 without warranty of any kind.






kkc.1




 $ vim kkc.1
 ...
 $ cat kkc.1
.\"                                      Hey, EMACS: -*- nroff -*-
.\" (C) Copyright 2013 Mitsuya Shibata <mty.shibata@gmail.com>,
.\"
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH KKC 1 "DEC 2013"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
kkc \- a simple Kana Kanji converter
.SH SYNOPSIS
.B kkc
.I \fR[\fI help \fR|\fI decoder \fR|\fI context \fR]\fI
.RI [ OPTIONS ]
.SH DESCRIPTION
kkc converte from Kana-string to Kana-Kanji-mixed-string and list up
candidates.
.PP
Users can specify parameters through command line options. See
\fBkkc help\fP or \fBkkc command \-\-help\fP for the list of options.
.SH SEE ALSO
See /usr/share/doc/libkkc-utils/README for usage example.






install files




 $ echo 'usr/share/libkkc/rules/*' > libkkc-common.install
 $ echo 'usr/include/*'            > libkkc-dev.install
 $ echo 'usr/lib/*/lib*.so'        >>libkkc-dev.install
 $ echo 'usr/lib/*/pkgconfig/*'    >>libkkc-dev.install
 $ echo 'usr/share/vala/vapi/*'    >>libkkc-dev.install
 $ echo 'usr/bin/kkc'              > libkkc-utils.install
 $ echo 'usr/share/locale/'        >>libkkc-utils.install
 $ echo 'usr/lib/*/lib*.so.*'      >>libkkc2.install
 $ echo 'README'                   > libkkc-utils.docs
 $ echo 'debian/kkc.1'             > libkkc-utils.manpages






rules




 $ vim rules
 ...
 $ cat rules
#!/usr/bin/make -f
#DH_VERBOSE = 1

# In case you want to add more flags to the defaults, use
# the followings to harden via compiler options
# see FEATURE AREAS in dpkg-buildflags(1))
#export DEB_BUILD_MAINT_OPTIONS = hardening=+all
# see ENVIRONMENT in dpkg-buildflags(1))
# package maintainers to append CFLAGS
export DEB_CFLAGS_MAINT_APPEND  = -Wall -pedantic
# package maintainers to append LDFLAGS
export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed

VALAFLAGS:=$(foreach w,$(CPPFLAGS) $(CFLAGS) $(LDFLAGS),-X $(w))

%:
        dh $@ --with autotools-dev,gir

override_dh_auto_configure:
        dh_auto_configure -- --disable-silent-rules

override_dh_strip:
        dh_strip -Xlibkkc-utils --dbg-package=libkkc2-dbg
        dh_strip -Xlibkkc2 --dbg-package=libkkc-utils-dbg

override_dh_test:
        : # NOP to avoid breakage






Remove unused template files




 $ rm -f clean
 $ rm -f libkkc2.examples
 $ rm -f libkkc2.info
 $ rm -f libkkc2.postinst
 $ rm -f libkkc2.postrm
 $ rm -f libkkc2.preinst
 $ rm -f libkkc2.prerm




Let’s record packaging result into VCS.


(Hmmm…. importing upstream with pristine-tar first is better but let’s not worry now.)






 $ cd ../
 $ git add -A .
 $ git commit -m initial_commit
[master 1fee795] initial_commit
 18 files changed, 539 insertions(+), 2783 deletions(-)
 delete mode 100644 debian/clean
 rewrite debian/control (74%)
 rewrite debian/copyright (87%)
 create mode 100644 debian/kkc.1
 create mode 100644 debian/libkkc-utils.docs
 create mode 100644 debian/libkkc-utils.manpages
 delete mode 100644 debian/libkkc2.examples
 delete mode 100644 debian/libkkc2.info
 delete mode 100644 debian/libkkc2.postinst
 delete mode 100644 debian/libkkc2.postrm
 ...
 ... (snip)
 ...
 delete mode 100644 debian/libkkc2.postinst
 delete mode 100644 debian/libkkc2.postrm
 delete mode 100644 debian/libkkc2.preinst
 delete mode 100644 debian/libkkc2.prerm
 rewrite debian/rules (72%)




Let’s build this package under the pdebuild command.




The first pdebuild




 $ pdebuild
dpkg-buildpackage: source package libkkc
dpkg-buildpackage: source version 0.3.2-1
 ...
 dpkg-source --before-build libkkc-0.3.2
 fakeroot debian/rules clean
make[3]: Entering directory '/path/to/libkkc-0.3.2'
--
dpkg-buildpackage: host architecture amd64
 fakeroot debian/rules clean
make[3]: Entering directory '/tmp/buildd/libkkc-0.3.2'
 ...
 debian/rules build
make[3]: Entering directory '/tmp/buildd/libkkc-0.3.2'
 ...
 fakeroot debian/rules binary
make[3]: Entering directory '/tmp/buildd/libkkc-0.3.2'
 ...
dpkg-gensymbols: warning: new libraries appeared in the symbols file: libkk...
dpkg-gensymbols: warning: debian/libkkc2/DEBIAN/symbols doesn't match compl...
--- debian/libkkc2.symbols (libkkc2_0.3.2-1_amd64)
+++ dpkg-gensymbolsvrvsOj       2014-06-12 15:36:11.710990854 +0000
@@ -0,0 +1,344 @@
+libkkc.so.2 libkkc2 #MINVER#
+ kkc_bigram_decoder_add_unknown_nodes@Base 0.3.2-1
+ kkc_bigram_decoder_backward_search@Base 0.3.2-1
+ kkc_bigram_decoder_build_trellis@Base 0.3.2-1
+ kkc_bigram_decoder_construct@Base 0.3.2-1
+ kkc_bigram_decoder_forward_search@Base 0.3.2-1
+ kkc_bigram_decoder_get_model@Base 0.3.2-1
 ...
  forking: rm -rf /var/cache/pbuilder/build//cow.25965






Restore source tree using VCS




 $ git reset --hard HEAD
HEAD is now at 1fee795 initial_commit
 $ git clean -d -f -x
 ...
 ... (snip)
 ...




Using mc, copy DEBIAN/symbols from the libkkc2_0.3.2-1_amd64.deb package to debian/libkkc2.symbols. (Of course, you can manually use the dpkg-deb command.)




Update debian/libkkc2.symbols




 $ vim debian/libkkc2.symbols
 ... (:%s/-1$//)
 ... (:wq)
 $ cat debian/libkkc2.symbols
libkkc.so.2 libkkc2 #MINVER#
 kkc_bigram_decoder_add_unknown_nodes@Base 0.3.2
 kkc_bigram_decoder_backward_search@Base 0.3.2
 kkc_bigram_decoder_build_trellis@Base 0.3.2
 kkc_bigram_decoder_construct@Base 0.3.2
 kkc_bigram_decoder_forward_search@Base 0.3.2
 ...
 ... (snip)
 ...






The second pdebuild




 $ pdebuild
dpkg-buildpackage: source package libkkc
dpkg-buildpackage: source version 0.3.2-1
 ...
 dpkg-source --before-build libkkc-0.3.2
 fakeroot debian/rules clean
make[3]: Entering directory '/path/to/libkkc-0.3.2'
--
dpkg-buildpackage: host architecture amd64
 fakeroot debian/rules clean
make[3]: Entering directory '/tmp/buildd/libkkc-0.3.2'
 ...
 debian/rules build
make[3]: Entering directory '/tmp/buildd/libkkc-0.3.2'
 ...
 fakeroot debian/rules binary
make[3]: Entering directory '/tmp/buildd/libkkc-0.3.2'
 ...
  forking: rm -rf /var/cache/pbuilder/build//cow.29800






The build result




 $ cd ..
 $ tree -L 1
.
├── libkkc-0.3.2
├── libkkc_0.3.2-1_amd64.build
├── libkkc_0.3.2-1_amd64.changes
├── libkkc_0.3.2-1.debian.tar.xz
├── libkkc_0.3.2-1.dsc
├── libkkc_0.3.2-1_source.changes
├── libkkc_0.3.2.orig.tar.gz -> libkkc-0.3.2.tar.gz
├── libkkc-0.3.2.tar.gz
├── libkkc2_0.3.2-1_amd64.deb
├── libkkc2-dbg_0.3.2-1_amd64.deb
├── libkkc.build-dep.log
├── libkkc.build.log
├── libkkc-common_0.3.2-1_all.deb
├── libkkc.depcheck.log
├── libkkc-dev_0.3.2-1_amd64.deb
├── libkkc.install.log
├── libkkc-utils_0.3.2-1_amd64.deb
└── libkkc-utils-dbg_0.3.2-1_amd64.deb

1 directory, 17 files




Let’s inspect the result.




The generated files of version 1.0 by the debuild command:




 $ cd ..
 $ tree -L 1
.
├── libkkc-0.3.2
├── libkkc_0.3.2-1_amd64.build
├── libkkc_0.3.2-1_amd64.changes
├── libkkc_0.3.2-1.debian.tar.xz
├── libkkc_0.3.2-1.dsc
├── libkkc_0.3.2-1_source.changes
├── libkkc_0.3.2.orig.tar.gz -> libkkc-0.3.2.tar.gz
├── libkkc-0.3.2.tar.gz
├── libkkc2_0.3.2-1_amd64.deb
├── libkkc2-dbg_0.3.2-1_amd64.deb
├── libkkc.build-dep.log
├── libkkc.build.log
├── libkkc-common_0.3.2-1_all.deb
├── libkkc.depcheck.log
├── libkkc-dev_0.3.2-1_amd64.deb
├── libkkc.install.log
├── libkkc-utils_0.3.2-1_amd64.deb
└── libkkc-utils-dbg_0.3.2-1_amd64.deb

1 directory, 17 files






The source package contents:




 $ tar -tJf libkkc_0.3.2-1.debian.tar.xz
debian/
debian/libkkc-utils.docs
debian/libkkc2.menu
debian/libkkc2.manpages
debian/compat
debian/libkkc2.links
debian/changelog
debian/watch
debian/libkkc2.install
debian/kkc.1
 ...
 $ tar -tzf libkkc-0.3.2.tar.gz
libkkc-0.3.2/
libkkc-0.3.2/missing
libkkc-0.3.2/tools/
libkkc-0.3.2/tools/kkc_vala.stamp
libkkc-0.3.2/tools/kkc.vala
libkkc-0.3.2/tools/Makefile.in
libkkc-0.3.2/tools/kkc-package-data.in
libkkc-0.3.2/tools/Makefile.am
libkkc-0.3.2/tools/kkc.c
libkkc-0.3.2/NEWS
 ...






The binary package contents:




 $ dpkg -c libkkc2_0.3.2-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/lib/
drwxr-xr-x root/root ...  ./usr/lib/x86_64-linux-gnu/
-rw-r--r-- root/root ...  ./usr/lib/x86_64-linux-gnu/libkkc.so.2.0.0
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/libkkc2/
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc2/changelog.gz
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc2/copyright
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc2/README.Debian
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc2/changelog.Debian.gz
drwxr-xr-x root/root ...  ./usr/share/menu/
-rw-r--r-- root/root ...  ./usr/share/menu/libkkc2
lrwxrwxrwx root/root ...  ./usr/lib/x86_64-linux-gnu/libkkc.so.2 -> libkkc....
 $ dpkg -c libkkc2-dbg_0.3.2-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/lib/
drwxr-xr-x root/root ...  ./usr/lib/debug/
drwxr-xr-x root/root ...  ./usr/lib/debug/.build-id/
drwxr-xr-x root/root ...  ./usr/lib/debug/.build-id/17/
-rw-r--r-- root/root ...  ./usr/lib/debug/.build-id/17/96418989f1ba19502b6d...
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/libkkc2-dbg/
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc2-dbg/changelog.gz
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc2-dbg/copyright
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc2-dbg/changelog.Debian.gz
 $ dpkg -c libkkc-common_0.3.2-1_all.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/libkkc-common/
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-common/changelog.gz
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-common/copyright
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-common/changelog.Debian.gz...
drwxr-xr-x root/root ...  ./usr/share/libkkc/
 ...
 ... (snip)
 ...
-rw-r--r-- root/root ...  ./usr/share/libkkc/rules/default/keymap/hankaku-k...
-rw-r--r-- root/root ...  ./usr/share/libkkc/rules/default/keymap/wide-lati...
-rw-r--r-- root/root ...  ./usr/share/libkkc/rules/default/keymap/direct.js...
-rw-r--r-- root/root ...  ./usr/share/libkkc/rules/default/metadata.json
drwxr-xr-x root/root ...  ./usr/share/libkkc/rules/default/rom-kana/
-rw-r--r-- root/root ...  ./usr/share/libkkc/rules/default/rom-kana/default...
 $ dpkg -c libkkc-dev_0.3.2-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/include/
drwxr-xr-x root/root ...  ./usr/include/libkkc/
-rw-r--r-- root/root ...  ./usr/include/libkkc/libkkc.h
drwxr-xr-x root/root ...  ./usr/lib/
drwxr-xr-x root/root ...  ./usr/lib/x86_64-linux-gnu/
drwxr-xr-x root/root ...  ./usr/lib/x86_64-linux-gnu/pkgconfig/
-rw-r--r-- root/root ...  ./usr/lib/x86_64-linux-gnu/pkgconfig/kkc-1.0.pc
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/libkkc-dev/
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-dev/changelog.gz
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-dev/copyright
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-dev/changelog.Debian.gz
drwxr-xr-x root/root ...  ./usr/share/vala/
drwxr-xr-x root/root ...  ./usr/share/vala/vapi/
-rw-r--r-- root/root ...  ./usr/share/vala/vapi/kkc-1.0.vapi
-rw-r--r-- root/root ...  ./usr/share/vala/vapi/kkc-1.0.deps
lrwxrwxrwx root/root ...  ./usr/lib/x86_64-linux-gnu/libkkc.so -> libkkc.so...
 $ dpkg -c libkkc-utils_0.3.2-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/bin/
-rwxr-xr-x root/root ...  ./usr/bin/kkc
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/locale/
drwxr-xr-x root/root ...  ./usr/share/locale/ja/
drwxr-xr-x root/root ...  ./usr/share/locale/ja/LC_MESSAGES/
-rw-r--r-- root/root ...  ./usr/share/locale/ja/LC_MESSAGES/libkkc.mo
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/libkkc-utils/
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-utils/changelog.gz
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-utils/copyright
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-utils/changelog.Debian.gz
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-utils/README
drwxr-xr-x root/root ...  ./usr/share/man/
drwxr-xr-x root/root ...  ./usr/share/man/man1/
-rw-r--r-- root/root ...  ./usr/share/man/man1/kkc.1.gz
 $ dpkg -c libkkc-utils-dbg_0.3.2-1_amd64.deb
drwxr-xr-x root/root ...  ./
drwxr-xr-x root/root ...  ./usr/
drwxr-xr-x root/root ...  ./usr/lib/
drwxr-xr-x root/root ...  ./usr/lib/debug/
drwxr-xr-x root/root ...  ./usr/lib/debug/.build-id/
drwxr-xr-x root/root ...  ./usr/lib/debug/.build-id/6a/
-rw-r--r-- root/root ...  ./usr/lib/debug/.build-id/6a/e0281cd5fd129fff74a5...
drwxr-xr-x root/root ...  ./usr/share/
drwxr-xr-x root/root ...  ./usr/share/doc/
drwxr-xr-x root/root ...  ./usr/share/doc/libkkc-utils-dbg/
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-utils-dbg/changelog.gz
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-utils-dbg/copyright
-rw-r--r-- root/root ...  ./usr/share/doc/libkkc-utils-dbg/changelog.Debian...








This package


The git repository (see http://anonscm.debian.org/gitweb/?p=collab-maint/debmake.git) is used to manage the development of the debmake package as follows.






 $ git clone https://alioth.debian.org/anonscm/git/collab-maint/debmake.git
 $ git checkout devel




The development of the debmake package is done on this devel branch:


    

  • 

    
Hack both in the upstream portion and under the debian/* directory, just like the native Debian package source tree.

    

    • 

  • 

    
Set the proper version strings before the release.

    

      

    • 

      
Update the version-rev string in the debian/changelog as if this is the non-native Debian package: dch -r

      

      • 

    • 

      
Update the version string in the debmake/__init__.py.

      

      • 

    

    • 



After everything is completed, you package the source as follows.






 $ cd test; make; make clean; cd -
 $ git add -A . ; git commit -m "Release ***"
 $ debmake -d -b:py3 -i pdebuild




The last command does 3 things:


    

  • 

    
Generate the upstream tarball. (-d == ./setup.py sdist)

    

    • 

  • 

    
Generate the source tree with debian/* copied from the VCS.

    

    • 

  • 

    
Build binary packages in the chroot. ("-i pdebuild")

    

    • 



Then you register the result into 3 branches of the git repository.






 $ gbp import-dsc --pristine-tar ../debmake_*-*.dsc




    

  • 

    
The upstream branch registers the upstream tarball contents.

    

    • 

  • 

    
The main branch registers the Debian source tree contents with debian/*.

    

    • 

  • 

    
The pristine-tar branch registers the *.orig.tar.gz file contents.

    

    • 











debmake(1) manpage






NAME


debmake - program to make the Debian source package






SYNOPSIS


debmake  [-h]  [-c | -k] [-n | -a package-version.orig.tar.gz | -d | -t ] [-p package] [-u version] [-r revision] [-z extension] [-b "binarypackage, …]" [-e foo@example.org] [-f "firstname lastname"] [-i "buildtool" | -j] [-l license_file] [-m] [-o file] [-q] [-s] [-v] [-w "addon, …"] [-x [01234]] [-y] [-Q]






DESCRIPTION


debmake helps to build the Debian package from the upstream source.  Normally, this is done as follows:


    

  • 

    
The upstream tarball is downloaded as the package-version.tar.gz file.

    

    • 

  • 

    
It is untared to create many files under the package-version/ directory.

    

    • 

  • 

    
debmake is invoked in the package-version/ directory possibly without any arguments.

    

    • 

  • 

    
Files in the package-version/debian/ directory are manually adjusted.

    

    • 

  • 

    
dpkg-buildpackage (usually from its wrapper debuild or pdebuild) is invoked in the package-version/ directory to make debian packages.

    

    • 



Make sure to protect the arguments of the -b, -f, -l, and -w options from the shell interference by quoting them properly.




optional arguments:





-h, --help






show this help message and exit.






-c, --copyright






scan source for copyright+license text and exit.



    

  • 

    
-c: sinple output style

    

    • 

  • 

    
-cc: normal output style (similar to the debian/copyright file)

    

    • 

  • 

    
-ccc: debug output style

    

    • 






-k, --kludge






compare the debian/copyright file with the source and exit.



The debian/copyright file must be organized to list the generic file patterns before the specific exceptions.


    

  • 

    
-k: basic output style

    

    • 

  • 

    
-kk: verbose output style

    

    • 






-n, --native






make a native Debian source package without .orig.tar.gz.  This makes the "3.0 (native)" format package.



If you are thinking to package a Debian specific source tree with debian/* in it into a native Debian package, please think otherwise.  You can use  "debmake -d  -i debuild" or "debmake -t -i debuild" to make the "3.0 (quilt)" format non-native Debian package.  The only difference is that the debian/changelog file must use the  non-native version scheme: version-revision.  The non-native package is more friendly to the downstream distributions.





-a package-version.tar.gz, --archive package-version.tar.gz






use the upstream source tarball directly. (-p, -u, -z: overridden)



The upstream tarball may be specified as package_version.orig.tar.gz and tar.gz for all cases may be tar.bz2, or tar.xz.


If the specified upstream tarball name contains uppercase letters, the Debian package name is generated by converting them to lowercase letters.


If the specified argument is the URL (http://, https://, or ftp://) to the upstream tarball, the upstream tarball is downloaded from the URL using wget or curl.





-d, --dist






run "make dist" equivalent first to generate upstream tarball and use it.



"debmake -d" is designed to run in the package/ directory hosting the upstream VCS with the build system supporting "make dist" equivalents.  (automake/autoconf, Python distutils, …)





-t, --tar






run "tar" to generate upstream tarball and use it



"debmake -t" is designed to run in the package/ directory hosting the upstream VCS.  Unless you provide the upstream version with the -u option or with the debian/changelog file, a snapshot upstream version is generated in the 0~%y%m%d%H%M format, e.g., 0~1403012359, from the UTC date and time.  The generated tarball excludes the debian/ directory found in the upstream VCS. (It also excludes typical VCS directories: .git/ .hg/ .svn/ .CVS/)





-p package, --package package






set the Debian package name.






-u version, --upstreamversion version






set the upstream package version.






-r revision, --revision revision






set the Debian package revision.






-z extension, --targz extension






set the tarball type, extension=(tar.gz|tar.bz2|tar.xz) (alias: z, b, x)






-b "binarypackage[:type],…", --binaryspec "binarypackage[:type],…"






set binary package specs by the comma separated list of binarypackage:type pairs, e.g., in full form "foo:bin,foo-doc:doc,libfoo1:lib,libfoo1-dbg:dbg,libfoo-dev:dev" or in short form ",-doc,libfoo1,libfoo1-dbg, libfoo-dev".



Here, binarypackage is the binary package name; and optional type is chosen from the following type values:






    

  • 

    
bin: C/C++ compiled ELF binary code package (any, foreign) (default, alias: "", i.e., null-string)

    

    • 

  • 

    
data: Data (fonts, graphics, …) package (all, foreign) (alias: da)

    

    • 

  • 

    
dbg: Debug symbol package (any, same) (alias: db)

    

    • 

  • 

    
dev: Library development package (any, same) (alias: de)

    

    • 

  • 

    
doc: Documentation package (all, foreign) (alias: do)

    

    • 

  • 

    
lib: Library package (any, same) (alias: l)

    

    • 

  • 

    
perl: Perl script package (all, foreign) (alias: pl)

    

    • 

  • 

    
python: Python script package (all, foreign) (alias: py)

    

    • 

  • 

    
python3: Python3 script package (all, foreign) (alias: py3)

    

    • 

  • 

    
ruby: Ruby script package (all, foreign) (alias: rb)

    

    • 

  • 

    
script: Shell script package (all, foreign) (alias: sh)

    

    • 





The pair values in the parentheses, such as (any, foreign), are the Architecture and Multi-Arch stanza values set in the debian/control file.


In many cases, the debmake command makes good guesses for type from binarypackage.  If type is not obvious, type is set to bin.  For example, libfoo sets type to lib, and font-bar sets type to data, …


If the source tree contents do not match settings for type, debmake warns you.





-e foo@example.org, --email foo@example.org






set e-mail address.



The default is taken from the value of the environment variable $DEBEMAIL.





-f "firstname lastname", --fullname "firstname lastname"






set the fullname.



The default is taken from the value of the environment variable $DEBFULLNAME.





-i "buildtool", --invoke "buildtool"






invoke "buildtool" at the end of execution.  "buildtool" may be "dpkg-buildpackage", "debuild", "pdebuild", "pdebuild  --pbuilder cowbuilder", etc..



The default is not to execute any program.





-j, --judge






run dpkg-depcheck to judge build dependencies and identify file paths.  Log files are in the parent directory.



    

  • 

    
package.build-dep.log: Log file for dpkg-depcheck.

    

    • 

  • 

    
package.install.log: Log file recording files in the debian/tmp directory.

    

    • 






-l "license_file,…", --license "license_file,…"






add formatted license text to the end of the debian/copyright file holding license scan results



The default is add COPYING and LICENSE and license_file needs to list only the additional file names all separated by ",".





-m, --monoarch






force packages to be non-multiarch.






-o file, --option file






read optional parameters from file. (This is not for everyday use.)



The file is sourced as the Python3 code at the end of para.py.  For example, the package description can be specified by the following file.






para['desc'] = 'program short description'
para['desc_long'] = '''\
 program long description which you wish to include.
 .
 Empty line is space + .
 You keep going on ...
'''











-q, --quitearly






quit early before creating files in the debian/ directory.






-s, --spec






use upstream spec (setup.py for Python, etc.) for the package description.






-v, --version






show version information.






-w "addon,…", --with "addon,…"






add extra arguments to the --with option of the dh(1) command as addon in debian/rules.



The addon values are listed all separated by ",", e.g., -w "python2,autoreconf".


For  Autotools based packages, setting autoreconf as addon forces to run "autoreconf -i -v -f" for every package building.  Otherwise, autotools-dev as addon is used as default.


For Autotools based packages, if they install Python programs, python2 as addon is needed for packages with compat < 9 since this is non-obvious.   But for setup.py based packages, python2 as addon is not needed since this is obvious and it is automatically set for the dh(1) command by the debmake command when it is required.





-x n, --extra n






generate extra configuration files as templates.



The number n changes which configuration templates are generated.


    

  • 

    
-x0: bare minimum configuration files. (default if these files exist already)

    

    • 

  • 

    
-x1: ,, + desirable configuration files. (default for new packages)

    

    • 

  • 

    
-x2: ,, + interesting configuration files. (recommended for experts, multi binary aware)

    

    • 

  • 

    
-x3:  ,,  + unusual configuration template files with the extra .ex suffix to ease their removal. (recommended for new users) To use these as configuration files, rename their file names into ones without the .ex suffix.

    

    • 

  • 

    
-x4: ,, + copyright file examples.

    

    • 






-y, --yes






force "yes" for all prompts. (without option: "ask [Y/n]"; doubled option: force "no")






-Q, --quiet






quiet tutorial comment lines marked with ### in template files













EXAMPLES


For  a  well  behaving  source, you can build a good-for-local-use installable single Debian binary package easily with one command.  Test install of such a package
generated in this way offers a good alternative to traditional "make install" to the /usr/local directory since the Debian package can be  removed  cleanly  by  the
"dpkg -P …" command. Here are some examples of how to build such test packages. (These should work in most cases.  If the -d does not work, try -t instead.)


For a typical C program source tree packaged with autoconf/automake:


    

  • 

    
debmake -d -i debuild

    

    • 



For a typical python module source tree:


    

  • 

    
debmake -s -d -b":python" -i debuild

    

    • 



For a typical python module in the package-version.tar.gz archive:


    

  • 

    
debmake -s -a package-version.tar.gz -b":python" -i debuild

    

    • 



For a typical perl module in the Package-version.tar.gz archive:


    

  • 

    
debmake -a Package-version.tar.gz -b":perl" -i debuild

    

    • 







HELPER PACKAGES


Packaging may require installation of some additional specialty helper packages.


    

  • 

    
Python3 program may require the dh-python package.

    

    • 

  • 

    
Autotools (Autoconf + Automake) build system may require autotools-dev or dh-autoreconf package.

    

    • 

  • 

    
Ruby program may require the gem2deb package.

    

    • 

  • 

    
Java program may require the javahelper package.

    

    • 

  • 

    
Gnome programs may require the gobject-introspection package.

    

    • 

  • 

    
etc.

    

    • 







CAVEAT


debmake is meant to provide template files for the package maintainer to work on.  Comment lines started by ### are the tutorial text.  You must remove or edit such comment lines before uploading to the Debian archive.


There  are some limitations for what characters may be used as a part of the Debian package.  The most notable limitation is the prohibition of uppercase letters in the package name.  Here is the summary in the regular expression.


    

  • 

    
Upstream package name (-p): [-+.a-z0-9]{2,}

    

    • 

  • 

    
Binary package name (-b): [-+.a-z0-9]{2,}

    

    • 

  • 

    
Upstream version (-u): [0-9][-+.:~a-z0-9A-Z]*

    

    • 

  • 

    
Debian revision (-r): [0-9][+.~a-z0-9A-Z]*

    

    • 



See the exact definition in Chapter 5 - Control files and their fields of the “Debian Policy Manual”.






DEBUG


The character set in the environment variable $DEBUG determines the logging output level.


    

  • 

    
p: list all global parameters

    

    • 

  • 

    
d: list parsed parameters for all binary packages

    

    • 

  • 

    
f: input filename for the copyright scan

    

    • 

  • 

    
y: year/name split of copyright line

    

    • 

  • 

    
s: line scanner for format_state

    

    • 

  • 

    
b: content_state scan loop: begin-loop

    

    • 

  • 

    
m: content_state scan loop: after regex match

    

    • 

  • 

    
e: content_state scan loop: end-loop

    

    • 

  • 

    
c: print copyright section text

    

    • 

  • 

    
l: print license section text

    

    • 

  • 

    
a: print author/translator section text

    

    • 

  • 

    
k: sort key for debian/copyright stanza

    

    • 

  • 

    
n: scan result of debian/copyright (debmake -k)

    

    • 



Use this as:






 $ DEBUG=pdfbmeclak debmake ...








AUTHOR


Copyright © 2014 Osamu Aoki <osamu@debian.org>






LICENSE


MIT License






SEE ALSO


The debamake package provides following HTML documents:




Also, please read the original Debian New Maintainers' Guide provided by the the maint-guide package.


See also dpkg-source(1), deb-control(5), debhelper(7), dh(1), dpkg-buildpackage(1), debuild(1), quilt(1), dpkg-depcheck(1), pdebuild(1), pbuilder(8), cowbuilder(8), gbp-buildpackage(1), gbp-pq(1), and git-pbuilder(1) manpages.














debmake-4.1.7/doc/debmake.html0000664000175000017500000020336012416767353016454 0ustar  osamuosamu00000000000000




Debmake tutorial












This tutorial may be used under the terms the GNU General Public License version 2 or higher.


The debmake command is the helper script for the Debian packaging.







Caution


The debmake command only provides good template files. These template files must be manually adjusted to their perfection to comply with the strict quality requirements of the Debian archive.





This simple tutorial should be enough for you to get started with the debmake command, if you already know the Debian packaging.


There is also the debmake manpage which explains all the command options.  It is included here in the appendix.


If you are new to the Debian packaging, do not worry about the details and just get the big picture instead.  Please read the more detailed guide such as Debian Maintainers' Guide with debmake.








Feature overview




The debmake command is intended to replace functions offered historically by deb-make 
[This new debmake package starts its version from 4.0 to avoid version overlaps with its predecessor provided the deb-make command.]
 and dh_make commands.


Its features include:


    

  • 

    
use of dh syntax under the new debhelper (> 9.0) package

    

      

    • 

      
extensive check of copyright for DEP-5 (debian/copyright)

      

      • 

    • 

      
substvar supports for binary packages (debian/control)

      

      • 

    • 

      
support of compiler hardening options (debian/rules)

      

      • 

    

    • 

  • 

    
keep pre-existing Debian package configuration files untouched

    

      

    • 

      
automatic generation of the missing template packaging files

      

      • 

    • 

      
easy verification of the debian/copyright file against the current source. (-k option)

      

      • 

    

    • 

  • 

    
easy packaging command line UI supporting

    

      

    • 

      
non-stop execution with clean results

      

      • 

    • 

      
direct operation on the tarball archive

      

      • 

    • 

      
direct operation on the source tree from VCS

      

      • 

    • 

      
direct generation of the binary package from the python module

      

      • 

    • 

      
the multiarch Debian package

      

      • 

    • 

      
the multi binary Debian package

      

      • 

    • 

      
the non-native Debian packages from the VCS snapshot

      

      • 

    • 

      
seamless work with debuild, pdebuild, etc.

      

      • 

    

    • 



These are realized with the following approaches:


    

  • 

    
It doesn’t overwrite existing configuration files in the debian/ directory.

    

    • 

  • 

    
It always sets most of the obvious option states and values to reasonable defaults.

    

      

    • 

      
It aims to address typical packaging situation (90% of cases) only.

      

      • 

    • 

      
It has the -s option to copy the package description from the upstream meta data.

      

      • 

    

    • 

  • 

    
It supports the multiarch package.

    

      

    • 

      
It always prepares to build the source for the multiarch package, unless -m option is explicitly specified.

      

      • 

    • 

      
It always prepares to build the non-native Debian package with the "3.0 (quilt)" format, unless -n option is explicitly specified.

      

      • 

    

    • 

  • 

    
It creates good template files such as the debian/copyright file complient to DEP-5.

    

      

    • 

      
It makes template files for the Debian packaging in the upstream source based on the type (the -b option).

      

      • 

    • 

      
Use bin as the fallback type for the compiled program without its own type.

      

      • 

    • 

      
Use script as the fallback type for the interpreted program without its own type.

      

      • 

    

    • 

  • 

    
It delegates most of the heavy lifting to its back-end packages: debhelper, dpkg-dev, devscripts, pbuilder, etc.

    

    • 

  • 

    
It can integrate the whole packaging process from the source archive to the binary package.

    

      

    • 

      
It has the -a option to make it work directly with the tarball.

      

      • 

    • 

      
It has the -t and -d options to make it work well with the snapshot source in VCS.  These options also allow to make the non-native Debian package from the VCS source tree with the package-version/debian/ directory.

      

      • 

    • 

      
It has the -b option to make it work with various cases of Debian binary packages.

      

      • 

    • 

      
It has the -i option to run the debuild command as its subprocess.

      

      • 

    

    • 








Tip


Make sure to protect the arguments of the -b, -f, -l, and -w options from the shell interference by quoting them properly.










Tip


The non-native Debian package is the normal Debian package.










Note


The generation of the debian/copyright file, and the outputs from the -c and -k options involve heuristic operations on the copyright and license information.  They may produce some erroneous results.











Binary package




Let’s consider a simple C source following the GNU Coding Standards and FHS, package-1.0.tar.gz.


The Debian packaging of this package-1.0.tar.gz into a single binary package can be done with the debmake command as follows.






 $ tar -xvzf package-1.0.tar.gz
 $ cd package-1.0
 $ debmake
   ... Make manual adjustments of generated configuration files
 $ debuild




If manual adjustments of generated configuration files are skipped, the generated binary package lacks meaningful package description but still functions well under the dpkg command to be used for your local deployment.







Tip


The debuild command in these examples may be substituted by the equivalent commands such as the pdebuild command.







debmake -b


The -b option of the debmake command provides intuitive and flexible methods to customize packaging parameters in the debian/control file.  It sets the following stanza values.


    

  • 

    
Package:

    

    • 

  • 

    
Architecture:

    

    • 

  • 

    
Multi-Arch:

    

    • 

  • 

    
Depends:

    

    • 

  • 

    
Pre-Depends:

    

    • 



Let’s quote the pertinent part from the debmake manpage here.









-b "binarypackage[:type],…", --binaryspec "binarypackage[:type],…"






set binary package specs by the comma separated list of binarypackage:type pairs, e.g., in full form "foo:bin,foo-doc:doc,libfoo1:lib,libfoo1-dbg:dbg,libfoo-dev:dev" or in short form ",-doc,libfoo1,libfoo1-dbg, libfoo-dev".



Here, binarypackage is the binary package name; and optional type is chosen from the following type values:






    

  • 

    
bin: C/C++ compiled ELF binary code package (any, foreign) (default, alias: "", i.e., null-string)

    

    • 

  • 

    
data: Data (fonts, graphics, …) package (all, foreign) (alias: da)

    

    • 

  • 

    
dbg: Debug symbol package (any, same) (alias: db)

    

    • 

  • 

    
dev: Library development package (any, same) (alias: de)

    

    • 

  • 

    
doc: Documentation package (all, foreign) (alias: do)

    

    • 

  • 

    
lib: Library package (any, same) (alias: l)

    

    • 

  • 

    
perl: Perl script package (all, foreign) (alias: pl)

    

    • 

  • 

    
python: Python script package (all, foreign) (alias: py)

    

    • 

  • 

    
python3: Python3 script package (all, foreign) (alias: py3)

    

    • 

  • 

    
ruby: Ruby script package (all, foreign) (alias: rb)

    

    • 

  • 

    
script: Shell script package (all, foreign) (alias: sh)

    

    • 





The pair values in the parentheses, such as (any, foreign), are the Architecture and Multi-Arch stanza values set in the debian/control file.


In many cases, the debmake command makes good guesses for type from binarypackage.  If type is not obvious, type is set to bin.  For example, libfoo sets type to lib, and font-bar sets type to data, …


If the source tree contents do not match settings for type, debmake warns you.








Here are some typical multiarch package split scenarios for the following upstream source examples:


    

  • 

    
a library source libfoo-1.0.tar.gz

    

    • 

  • 

    
a tool source bar-1.0.tar.gz written in a compiled language

    

    • 

  • 

    
a tool source baz-1.0.tar.gz written in an interpreted language

    

    • 














binarypackage   
type   
Architecture:
Multi-Arch:     
Package content







libfoo1


lib*


any


same


the shared library, co-installable






libfoo1-dbg


dbg*


any


same


the shared library debug symbols, co-installable






libfoo-dev


dev*


any


same


the shared library header files etc., co-installable






libfoo-tools


bin*


any


foreign


the run-time support programs, not co-installable






libfoo-doc


doc*


all


foreign


the shared library documentation files






bar


bin*


any


foreign


the compiled program files, not co-installable






bar-doc


doc*


all


foreign


the documentation files for the program






baz


script


all


foreign


the interpreted program files









For the cases marked with * in the above table, the type values are guessed right from the package names.


The default type is the bin type which means the compiled ELF binary executables.  This is why the example in [simple] does not specify -b option.


For programs written in other compiled languages, you may need to add its run-time library package dependency to the resulting binary package by adjusting the Depends: stanza of the debian/control file.


The development package for the shared library should depend on it and should contain a version numberless symlink to it. E.g.: /usr/lib/x86_64-linux-gnu/libfoo.so → libfoo.so.1







Note


If any dbg type packages are to be generated, they should be made for all bin and lib type packages.













Useful options






Shortcut options (-a, -i)


The debmake command offers 2 shortcut options.


    

  • 

    
-a : open the upstream tarball

    

    • 

  • 

    
-i : execute script to build the binary package

    

    • 



The example in the above [simple] can be done simply as follows.






 $ debmake -a package-1.0.tar.gz -i debuild









Tip


URL such as "http://www.example.org/DL/package-1.0.tar.gz" may be used for the -a option.










Tip


URL such as "http://arm.koji.fedoraproject.org/packages/ibus/1.5.7/3.fc21/src/ibus-1.5.7-3.fc21.src.rpm" may be used for the -a option, too.









Upstream snapshot (-d, -t)


The upstream snapshot from the upstream source tree in VCS can be made with the -d option if the upstream supports the "make dist" equivalence.






 $ cd /path/to/upstream-vcs
 $ debmake -d -i debuild




Alternatively, the same can be made with the -t option if the upstream tarball can be made with the tar command.






 $ cd /path/to/upstream-vcs
 $ debmake -p package -t -i debuild




Unless you provide the upstream version with the -u option or with the debian/changelog file, a snapshot upstream version is generated in the 0~%y%m%d%H%M format, e.g., 0~1403012359, from the UTC date and time.


If the upstream VCS is hosted in the package/ directory instead of the upstream-vcs/ directory, the "-p package" can be skipped.


If the upstream source tree in the VCS contains the debian/* files, the debmake command with either the -d option or the -t option combined with the -i option automates making of the non-native Debian packages from the VCS snapshot while using these debian/* files.






 $ cp -r /path/to/package-0~1403012359/debian/. /path/to/upstream-vcs/debian
 $ dch
   ... update debian/changelog
 $ git add -A .; git commit -m "vcs with debian/*"
 $ debmake -t -p package -i debuild




This Debian non-native binary package building scheme using the "debmake -t -i debuild" command may be considered as the quasi-native Debian package scheme since the packaging situation resembles the Debian native binary package building case using the debuild command without the upstream tarball.


Use of the non-native Debian package helps to ease communication with the downstream distros such as Ubuntu for bug fixes etc.






Python module


You can generate a functioning single binary Debian package with a reasonable package description directly from the Python module package offered as a tarball pythonmodule-1.0.tar.gz.  The -b option specifying the package type python and the -s option to copy the package description from the upstream package need to be specified.






 $ debmake -s -b':python' -a pythonmodule-1.0.tar.gz -i debuild




For other interpreted languages with the -b option support, specify the pertinent type for the -b option.


For interpreted languages without the -b option support, specify the script type instead and add the interpreter package as the dependency of the resulting binary package by adjusting the debian/control file.






debmake -cc


The the debmake command with the -cc option can make a summary of the copyright and license for the entire source tree to the standard output.






 $ tar -xvzf package-1.0.tar.gz
 $ cd package-1.0
 $ debmake -cc | less




With -c, this provides shorter report.






debmake -k


When updating a package for the new upstream release, the debmake command can verify the content of the existing debian/copyright file against the copyright and license situation of the entire updated source tree.






 $ cd package-vcs
 $ gbp import-orig --uscan --pristine-tar
 ... update source with the new upstream release
 $ debmake -k | less




The "debmake -k" command parses the debian/copyright file from the top to the bottom and compare the license of all the non-binary files in the current package with the license described in the last matching file pattern entry of the debian/copyright file.


When editing the auto-generated debian/copyright file, please make sure to keep the generic file patterns at the top of the list.







Tip


For all new upstream releases, run the "debmake -k" command to ensure that the debian/copyright file is current.









debmake -j


The generation of the functioning multi binary package always requires extra manual works than that of the functioning single binary package.  The test build of the source package is essential part of it.


For example, let’s package the same package-1.0.tar.gz (see [simple]) into a multi binary package.  At the line invoking the debmake command, let’s invoke it with the -j option instead for the test building and the report generation.






 $ debmake -j









Note


The -j option for debmake invokes dpkg-depcheck(1) to run debian/rules under strace(1) to obtain library dependencies.  Unfortunately, this is very slow.  If you know the library package dependencies from other sources such as the SPEC file in the source, you may just run "debmake …" without -j and "debian/rules install" to check the install paths of the generated files.





    

  • 

    
Check the last lines of package.build-dep.log to judge build dependencies for Build-Depends. (You do not need to list packages used by debhelper, perl, or fakeroot explicitly in Build-Depends.  This technique is useful for the generation of the single binary package, too.)

    

    • 

  • 

    
Check the contents of package.install.log to identify the install paths for files to decide how you split them into multiple packages.

    

    • 







 $ rm -rf package-1.0
 $ tar -xvzf package-1.0.tar.gz
 $ cd package-1.0
 $ debmake -b"package1:type1, ..."




    

  • 

    
Update debian/control and debian/binarypackage.install files using the above information.

    

    • 

  • 

    
Update other debian/* files as needed.

    

    • 







 $ debuild




    

  • 

    
Each binarypackage_version-revision_arch.deb has files specified by the debian/binarypackage.install file.

    

    • 








Tip


The binary package name starting with a "-" (hyphen) is treated as the abbreviated name and the real binary package name is generated by attaching it to the source package name.









debmake -x


The amount of template files generated by the debmake command depends on the -x[01234] option.









Note


None of the existing configuration files are modified by the debmake command.













debmake(1) manpage






NAME


debmake - program to make the Debian source package






SYNOPSIS


debmake  [-h]  [-c | -k] [-n | -a package-version.orig.tar.gz | -d | -t ] [-p package] [-u version] [-r revision] [-z extension] [-b "binarypackage, …]" [-e foo@example.org] [-f "firstname lastname"] [-i "buildtool" | -j] [-l license_file] [-m] [-o file] [-q] [-s] [-v] [-w "addon, …"] [-x [01234]] [-y] [-Q]






DESCRIPTION


debmake helps to build the Debian package from the upstream source.  Normally, this is done as follows:


    

  • 

    
The upstream tarball is downloaded as the package-version.tar.gz file.

    

    • 

  • 

    
It is untared to create many files under the package-version/ directory.

    

    • 

  • 

    
debmake is invoked in the package-version/ directory possibly without any arguments.

    

    • 

  • 

    
Files in the package-version/debian/ directory are manually adjusted.

    

    • 

  • 

    
dpkg-buildpackage (usually from its wrapper debuild or pdebuild) is invoked in the package-version/ directory to make debian packages.

    

    • 



Make sure to protect the arguments of the -b, -f, -l, and -w options from the shell interference by quoting them properly.




optional arguments:





-h, --help






show this help message and exit.






-c, --copyright






scan source for copyright+license text and exit.



    

  • 

    
-c: sinple output style

    

    • 

  • 

    
-cc: normal output style (similar to the debian/copyright file)

    

    • 

  • 

    
-ccc: debug output style

    

    • 






-k, --kludge






compare the debian/copyright file with the source and exit.



The debian/copyright file must be organized to list the generic file patterns before the specific exceptions.


    

  • 

    
-k: basic output style

    

    • 

  • 

    
-kk: verbose output style

    

    • 






-n, --native






make a native Debian source package without .orig.tar.gz.  This makes the "3.0 (native)" format package.



If you are thinking to package a Debian specific source tree with debian/* in it into a native Debian package, please think otherwise.  You can use  "debmake -d  -i debuild" or "debmake -t -i debuild" to make the "3.0 (quilt)" format non-native Debian package.  The only difference is that the debian/changelog file must use the  non-native version scheme: version-revision.  The non-native package is more friendly to the downstream distributions.





-a package-version.tar.gz, --archive package-version.tar.gz






use the upstream source tarball directly. (-p, -u, -z: overridden)



The upstream tarball may be specified as package_version.orig.tar.gz and tar.gz for all cases may be tar.bz2, or tar.xz.


If the specified upstream tarball name contains uppercase letters, the Debian package name is generated by converting them to lowercase letters.


If the specified argument is the URL (http://, https://, or ftp://) to the upstream tarball, the upstream tarball is downloaded from the URL using wget or curl.





-d, --dist






run "make dist" equivalent first to generate upstream tarball and use it.



"debmake -d" is designed to run in the package/ directory hosting the upstream VCS with the build system supporting "make dist" equivalents.  (automake/autoconf, Python distutils, …)





-t, --tar






run "tar" to generate upstream tarball and use it



"debmake -t" is designed to run in the package/ directory hosting the upstream VCS.  Unless you provide the upstream version with the -u option or with the debian/changelog file, a snapshot upstream version is generated in the 0~%y%m%d%H%M format, e.g., 0~1403012359, from the UTC date and time.  The generated tarball excludes the debian/ directory found in the upstream VCS. (It also excludes typical VCS directories: .git/ .hg/ .svn/ .CVS/)





-p package, --package package






set the Debian package name.






-u version, --upstreamversion version






set the upstream package version.






-r revision, --revision revision






set the Debian package revision.






-z extension, --targz extension






set the tarball type, extension=(tar.gz|tar.bz2|tar.xz) (alias: z, b, x)






-b "binarypackage[:type],…", --binaryspec "binarypackage[:type],…"






set binary package specs by the comma separated list of binarypackage:type pairs, e.g., in full form "foo:bin,foo-doc:doc,libfoo1:lib,libfoo1-dbg:dbg,libfoo-dev:dev" or in short form ",-doc,libfoo1,libfoo1-dbg, libfoo-dev".



Here, binarypackage is the binary package name; and optional type is chosen from the following type values:






    

  • 

    
bin: C/C++ compiled ELF binary code package (any, foreign) (default, alias: "", i.e., null-string)

    

    • 

  • 

    
data: Data (fonts, graphics, …) package (all, foreign) (alias: da)

    

    • 

  • 

    
dbg: Debug symbol package (any, same) (alias: db)

    

    • 

  • 

    
dev: Library development package (any, same) (alias: de)

    

    • 

  • 

    
doc: Documentation package (all, foreign) (alias: do)

    

    • 

  • 

    
lib: Library package (any, same) (alias: l)

    

    • 

  • 

    
perl: Perl script package (all, foreign) (alias: pl)

    

    • 

  • 

    
python: Python script package (all, foreign) (alias: py)

    

    • 

  • 

    
python3: Python3 script package (all, foreign) (alias: py3)

    

    • 

  • 

    
ruby: Ruby script package (all, foreign) (alias: rb)

    

    • 

  • 

    
script: Shell script package (all, foreign) (alias: sh)

    

    • 





The pair values in the parentheses, such as (any, foreign), are the Architecture and Multi-Arch stanza values set in the debian/control file.


In many cases, the debmake command makes good guesses for type from binarypackage.  If type is not obvious, type is set to bin.  For example, libfoo sets type to lib, and font-bar sets type to data, …


If the source tree contents do not match settings for type, debmake warns you.





-e foo@example.org, --email foo@example.org






set e-mail address.



The default is taken from the value of the environment variable $DEBEMAIL.





-f "firstname lastname", --fullname "firstname lastname"






set the fullname.



The default is taken from the value of the environment variable $DEBFULLNAME.





-i "buildtool", --invoke "buildtool"






invoke "buildtool" at the end of execution.  "buildtool" may be "dpkg-buildpackage", "debuild", "pdebuild", "pdebuild  --pbuilder cowbuilder", etc..



The default is not to execute any program.





-j, --judge






run dpkg-depcheck to judge build dependencies and identify file paths.  Log files are in the parent directory.



    

  • 

    
package.build-dep.log: Log file for dpkg-depcheck.

    

    • 

  • 

    
package.install.log: Log file recording files in the debian/tmp directory.

    

    • 






-l "license_file,…", --license "license_file,…"






add formatted license text to the end of the debian/copyright file holding license scan results



The default is add COPYING and LICENSE and license_file needs to list only the additional file names all separated by ",".





-m, --monoarch






force packages to be non-multiarch.






-o file, --option file






read optional parameters from file. (This is not for everyday use.)



The file is sourced as the Python3 code at the end of para.py.  For example, the package description can be specified by the following file.






para['desc'] = 'program short description'
para['desc_long'] = '''\
 program long description which you wish to include.
 .
 Empty line is space + .
 You keep going on ...
'''











-q, --quitearly






quit early before creating files in the debian/ directory.






-s, --spec






use upstream spec (setup.py for Python, etc.) for the package description.






-v, --version






show version information.






-w "addon,…", --with "addon,…"






add extra arguments to the --with option of the dh(1) command as addon in debian/rules.



The addon values are listed all separated by ",", e.g., -w "python2,autoreconf".


For  Autotools based packages, setting autoreconf as addon forces to run "autoreconf -i -v -f" for every package building.  Otherwise, autotools-dev as addon is used as default.


For Autotools based packages, if they install Python programs, python2 as addon is needed for packages with compat < 9 since this is non-obvious.   But for setup.py based packages, python2 as addon is not needed since this is obvious and it is automatically set for the dh(1) command by the debmake command when it is required.





-x n, --extra n






generate extra configuration files as templates.



The number n changes which configuration templates are generated.


    

  • 

    
-x0: bare minimum configuration files. (default if these files exist already)

    

    • 

  • 

    
-x1: ,, + desirable configuration files. (default for new packages)

    

    • 

  • 

    
-x2: ,, + interesting configuration files. (recommended for experts, multi binary aware)

    

    • 

  • 

    
-x3:  ,,  + unusual configuration template files with the extra .ex suffix to ease their removal. (recommended for new users) To use these as configuration files, rename their file names into ones without the .ex suffix.

    

    • 

  • 

    
-x4: ,, + copyright file examples.

    

    • 






-y, --yes






force "yes" for all prompts. (without option: "ask [Y/n]"; doubled option: force "no")






-Q, --quiet






quiet tutorial comment lines marked with ### in template files













EXAMPLES


For  a  well  behaving  source, you can build a good-for-local-use installable single Debian binary package easily with one command.  Test install of such a package
generated in this way offers a good alternative to traditional "make install" to the /usr/local directory since the Debian package can be  removed  cleanly  by  the
"dpkg -P …" command. Here are some examples of how to build such test packages. (These should work in most cases.  If the -d does not work, try -t instead.)


For a typical C program source tree packaged with autoconf/automake:


    

  • 

    
debmake -d -i debuild

    

    • 



For a typical python module source tree:


    

  • 

    
debmake -s -d -b":python" -i debuild

    

    • 



For a typical python module in the package-version.tar.gz archive:


    

  • 

    
debmake -s -a package-version.tar.gz -b":python" -i debuild

    

    • 



For a typical perl module in the Package-version.tar.gz archive:


    

  • 

    
debmake -a Package-version.tar.gz -b":perl" -i debuild

    

    • 







HELPER PACKAGES


Packaging may require installation of some additional specialty helper packages.


    

  • 

    
Python3 program may require the dh-python package.

    

    • 

  • 

    
Autotools (Autoconf + Automake) build system may require autotools-dev or dh-autoreconf package.

    

    • 

  • 

    
Ruby program may require the gem2deb package.

    

    • 

  • 

    
Java program may require the javahelper package.

    

    • 

  • 

    
Gnome programs may require the gobject-introspection package.

    

    • 

  • 

    
etc.

    

    • 







CAVEAT


debmake is meant to provide template files for the package maintainer to work on.  Comment lines started by ### are the tutorial text.  You must remove or edit such comment lines before uploading to the Debian archive.


There  are some limitations for what characters may be used as a part of the Debian package.  The most notable limitation is the prohibition of uppercase letters in the package name.  Here is the summary in the regular expression.


    

  • 

    
Upstream package name (-p): [-+.a-z0-9]{2,}

    

    • 

  • 

    
Binary package name (-b): [-+.a-z0-9]{2,}

    

    • 

  • 

    
Upstream version (-u): [0-9][-+.:~a-z0-9A-Z]*

    

    • 

  • 

    
Debian revision (-r): [0-9][+.~a-z0-9A-Z]*

    

    • 



See the exact definition in Chapter 5 - Control files and their fields of the “Debian Policy Manual”.






DEBUG


The character set in the environment variable $DEBUG determines the logging output level.


    

  • 

    
p: list all global parameters

    

    • 

  • 

    
d: list parsed parameters for all binary packages

    

    • 

  • 

    
f: input filename for the copyright scan

    

    • 

  • 

    
y: year/name split of copyright line

    

    • 

  • 

    
s: line scanner for format_state

    

    • 

  • 

    
b: content_state scan loop: begin-loop

    

    • 

  • 

    
m: content_state scan loop: after regex match

    

    • 

  • 

    
e: content_state scan loop: end-loop

    

    • 

  • 

    
c: print copyright section text

    

    • 

  • 

    
l: print license section text

    

    • 

  • 

    
a: print author/translator section text

    

    • 

  • 

    
k: sort key for debian/copyright stanza

    

    • 

  • 

    
n: scan result of debian/copyright (debmake -k)

    

    • 



Use this as:






 $ DEBUG=pdfbmeclak debmake ...








AUTHOR


Copyright © 2014 Osamu Aoki <osamu@debian.org>






LICENSE


MIT License






SEE ALSO


The debamake package provides following HTML documents:




Also, please read the original Debian New Maintainers' Guide provided by the the maint-guide package.


See also dpkg-source(1), deb-control(5), debhelper(7), dh(1), dpkg-buildpackage(1), debuild(1), quilt(1), dpkg-depcheck(1), pdebuild(1), pbuilder(8), cowbuilder(8), gbp-buildpackage(1), gbp-pq(1), and git-pbuilder(1) manpages.














debmake-4.1.7/doc/examples.tar.xz0000664000175000017500000032531412416767354017171 0ustar  osamuosamu000000000000007zXZִF!t/]:J'xlӛH<ߔ?$A9/";qZ}1).`=uߘ='ZTLI.*+<"UAq[#QĖw\R
1XUHlD{ߓ-7KhPmpC\Xv?cRG$ON(GoaX9CN؎!3chc%:LB;]	ƯI%8܉	eOMHml]"p`Vl攎Էr<)#9Ex+oy3'G3gppVg,jgң9aswGXGI}{sIﹿlGB8,I4<Tr|H`b{+Gj/a>|.j-`BKpʈ޶BNlH$oބ|fJ.P'dH!AY,|]ehF>5/lI|GdA
!'c	ךY6K=.5$w%6CUc'NoluԲDP]
\)RY1vN{ljP%NDxz
>rzSʛ^CUXPQsÑ=cOrnFѷm^e@WXhVvjݪ
r<^d[e铯*S+`]14ڹ$ 8,Bcۭ];n4BSxN}Y^(Ms7P4[CxPME.`EujFMN|;0f0B;|l2`5EIz,䡺@Mҧݛc7 EbPN=R8+&2
NQS9/"ogFl$\Ac<.(S~[`&
7YY%1\8=mltvCի6E|bG1@`DOw9į^#;֥Oe~/YdYwd5YSrOTo7{5'yhlੁP
jrMQײ
~$;p!] }<.ń>9ӅN,rVI%uA:d0TPB*rşV)E~=
{m*fSYFH[&0Z/ؼp/KHp~;'-U+	V Ks[*K|T*ɀWt.Z4uYsZۍEcd	kȃWt]~L@k^m$Ifĝ"7ì(<4x*òYFW
&zӧ|/#RDbRӸ2VmD)^f> AwNEoSHKrZAW"*f`@G]M&5ݵ;!_=\c'm.L/Maמ{K
}.ZP[iE>Mt-E1w:@eJcۉ4	rT)
'ڤ̪Pe3,XĎ=e0F
zǞ4(GôI*G]{q9S9h"rf@߉*Zi@H+yO滋!R c3!?|barp	L@Ca_(xnǙu&N
32P.Rl/40zk%@`'~ ú><YCv0yn[,Pۇ\lbNRB7((<"<.5|@x|S
|@pŢ?
X๸?RA
Z˾=MW'sҏ\M>rC16OsqD]y/OaD_,NA1.؂p}С
ЏdꥲvpGWѷH8Etxqp}ђ9R¥{1[c+4si!(KWSlj"ypynn
5,[6LOIT3g)"1*T9Bto$g$KK(ViF<߸Gc31!^%J߳PB4h̊jUsֳn
W#h ?q_,`v;C
su7ҭJW,Le(Zgԑt0MB~fp/H{x5ЙCMӼ.6N.jIJC!Ǽqh"#~_mrzGҫFf|n1ΧȬ[>o^xôDshj=^,6qҴM]R{T0u'l=آV(E

Ql ??^W;q즉Z''ݒ
wWX1H6|ͼSiiK6LCw}PMO
CĽRhjLqIflAa>w|<fx1;Y~W/=#sVm+}(`SURשL^Ϊ릿;Dʦ=)wfl%/GlL%-@Ww빺rp/
I8w+|z೩;.!\/(iOЏ!u
q~m)b&#IKTbgCU!¾Evc:bZC'&	wUbg*v2B#M$&ISs$fFVHQb~3}[VzÎĵClL-♟-ΕNdaq>B"f;Gl2<fMLPb9eDZA=P&nM*ּɈRlFHM)D]wͲVR0:[|	+o"|['A5en7?apw@-U7=CX!_*JqưBf es#8%
Üuꕔ'xoݷB9C)[  1c4m,߂1Ep68Wy@TН/Š"H1La}zvtv/}UF=UΣh\S3MfscOy(|$~6#	/ZZڍh5ZQ(fDKؔySVTDnِhP=}*`4x:ko7;ԸDZx-{eMx_)Ʌo/\Qr,<|>KDXT2GpM__	MvH
Kvm:~VʦOljIȺQ)?>#EaZ.ЋL=A*_`p$|Ǡw$,ҳFg凹x4WB60_iBZFȠvэLfD¹a:V)JpjA̓N4˓$ߵICXHmBGW:Ȳk[oR3 [G7Dvd݉ż4;oXzppJDִ)ESF{4Dp%eRNӠ),\4CmK̫c'OH?7\[03v[r,@I X<9|~Jkآh@qhh	Go9KxB#7
7jR[~^i:~.vKf\RdigݢY~G[ڒC1ymBqiSd]30rq%'s) =;0-M<-x{<)k~ Dd>efOe6I]p˟V09Цq0JB"a+G<5c7ZWbҠeVXC@HfQbB<]q|;Fև)SӬn<1*HyԇQ	GKqkQђ8Hiy{&$O?=%~1 BūHν=jH3*NBtjN9]ԿEvn>2"6ed|N`ۜϘzyEGje^#$N'- rԇqL3ײKhT!/թU.S&km|)Q2s"P1,Ll;'$㭲\٩*g+w@HLNkK9ZA0ucEOгewgD2 ζg"gi[+F9ԓɩ0@ˆ;aUIs(O*uv8ŰBV):J& IX~鹁y\X(oWJ=1ꎱ1EڅĚ(?סK
[[X3KDgQ&{B\۳l'] œcl6V&¯=Ӎ z2N/wX4FpWB46o;tsW;*u勧/X^Fb/j2Bf'lǻO7!*{{4'9Iz4+s0]b3[2K,uAXgҶ{jJc
-hbH%*- 
>> %eSXDDK\7绨BSY?3MX2 {[Y_y}J̓q4*ch`Xp{U#yԐ[X
CRע0ei ^̀XrN;7q 3 i+`?%={u/mx:k'/wr0Oui0}-PJ#mzW# SA0x8bfgLTTv<%~
>QGxrS-Z6:7K?v H|sq&HxmkicyC75&;Qg3 Q)BK[W
5NCT<:VDfv㰎~(@pOЄڱ8ŚсO/Uՙ~ݲ97&oeAN!է^/BSK2庘;T,㎟!LcՓRtVX¾'x1Y<%-MB-:56M	UB-4P8-/_1\leuO:20ټ,kBsԓ[v>mŗBu)={G04#F`T^QݝmdVcZ.*
13\„{=!㧬LtA"MRHP!q\
($FKt|H^/]|jܭ#G!$#yB~:ŞV7st5p7vLm\{KXH<]8cvnVWC[	?jR]|QkבOyXƱ '6Ⱦbp`amKD!o3VF1,ұ{%AwYNV8Q"g>yv裿3R9W3(-Su
Vy%(MhET]ϗy~ܹoM3xW2BhuHҢҤ(z*6ޝ
Хm=p0ѮFy"mZӛBI*2ѓ}&4J?ک7]z%ېOd"u9$ŊpΗ3RW34vʊ@-	Gum3tWc.xʐ'5ci4=ʛuq.!:ʋI3տo'<#}rl8{*Fd#^rFe7nY$30.Yhd]te7L_?r#20^džBtDїJv=8do^
bŮ5VV9H?oFvrU|t\su5V?pQ1z'{ki3^jl'Wњ{sSA9tS؇m??>ԛ\U,Fw (nhWՃВ%]}œ!ެ/2Tt]Jep;-sqܤ+U˃hfY(~דz9o5Ic>Q]F*!ҐM@̨ˢpk.vOJZƓ9#wE-7A)ɵфUo;a)IIu&ƌeD`h&6aв=/ok+VdΡ
-kI㢲iƴfdt#4In\IFpt4<\Iifx>yq$
	+N!%=r{}ez^džHLbfn☗"LbWSmAT=>}Pմ5MkbXBXH簪J=nvm\1t1[N`?LScU.~Ͷ˜Tjv(e0~!kM{uNq_In;N0D)܊`‘BOZ]nwmV$/'%'wy~$W4
Ng
Z[1ؒIlǍm`fOV(DY[	k4`cțu;瑧H	-j5	
(T0Ok&sNr
{_*A5	BclXĠTIc>"f'^+~	KBa)ԁa"4*Y,2!-"VZq?BR:Q`0zC	oSW5IB
edF^4[櫢n
is\ʄw~ مg:&"{T&lg3Mr<	q~%$uw	LsqJ=D5@O7ѐVR]fUW@F6=tt{aDb.f|jju>h+%D Î'=D|7%rvy4yQu0U
#A^[9%wIl;AW}Bk)+x=e쿉Fff,`B"M}pGÔme10YϽˎjU`S*ѣTψVt
cFOwMz93im*$ꉳFJ%b0&"k$O,_F<tM2n,tW>Ghaq~m#6VBĠ
8Kdx%zII/`܃>H$t3h彭qI9*T,jkȩ8	`EhSpj=ܢ\1Vvkx3{QD5me[hZvDՠ`Ь)`j1F$Ņş'g8Pw`+rۻz3u	mYsv{(>GVvW4RjȒx9~m]
h(r
@XJEC]7	3˵K|;2o|˭%3 "䫦yDHe'qQxS@Z
,Q:d7f\ySgM#ħ
ZY5ָq?5a[Fg/)SctHaDu&/2H\8K?^%{	 K[#2Xxka̢/]*aw@0Zf3_y%:Nөr/ꬊ-T{x.5pOx"}uM0tY
l
#ʐCa]O<Ѹ8r
!Sp"誜jl]OLD$RB+\3P{
vQƊO!Ѫ6Rg-}ni8gS)/74etfl5 m!	D-\rH>|HP-3X*$j A?
+~ҰǴ#>-Sgĵ2)_@0X_=HT8gk[K (ȕ'&Bm5WbYf`MޯF<_	WpNq/>"s$vzyWγL%Y	8x9A[pA+i6YTbK糐җB=sӳ˯Ey^J3\&3G&F6_ԱB b=+Zl].o~Z,!ciHi3=1s޾)5=Me"GgI\Mϯ\Ǣe^Կw7}w
vSQZ.AGQ:0Zrv:
?]Gn
ÜF ?n>vR9cEz6?ec<;ײ 
<>aPe(/2׊8_nwbNh̟ɬLs|L']:f	Q[Lʔ0{{/6:AY(2[/uB읞}|]!9JNYs2ZI&Kj<q55zח8#(7XCC+,c%RD?Yv`

b+':7ؽ6ᛪ_G2X28PԨTPW?o~{v9I2qi3H^WyrWOB6a/`>d
iY'3k-u:8:Q#Rx;G~-&?DKޘjيaUD1;)?Sza{Ɇ,
ʧD
5gRE~O-z^OO
'41Fhu/&7d<'B5i\nnIS~gvlw?9b	d_'1΂#;z/,Gy^7aBٙOݿ|Jp\Zl
j2lciz8ğzᒴҰ0>%"K;VIƁ~P_Z˯IioP=eN QE$q
{5ϭL
Px"OSJO61
AZfT&i7ޠu*!jU*+H/LLߝ GJBI>a->Ajgjaoʘ`=5EnkuS7Y	Ɲm:*GkI)˰	lP)$YaUYKQ
7hGPM"G,>q!q p+5qR風4!z"FotsW
]iƍsv**m@+=
	Eej&9͕H3n_$oh"KH\L2VF}2h6X%Ld"rMddI,'
="ive8~$~xB??b@uY0^Y*~$l !
f3"dg~t]qBJ/_K7^-%:	tkF,C5PqMzbxH
!)
tnޱ8{طxA~
TDz7j/~6R8o]}	Q7;`֌]"3T5><,sz?q${|x,VhuE8LMg@~OOWx,f	}{kB^Ox:{À*ݸwD#"ꑤZ5cgF8).Aږ4ɂt	h}fTq% !9'pln0$kx:/Uig5ՙ?B\F밣O8FVPFQXm}T|>r}&((@R;1V8#z
K߿	Yџb
C|A: uzU`jDKÿ]'~UG6`76eWЭi)"57y#n
aGNIo֜OY_|7
f
˘@AFMFк1TatsENl1VآJ^tR*1z3ڼ#OHz#;ʱg&4ek2#f|)_ӬHg.jHih1vdfγN
W?ɥ@F̅H>JLO~ rժ{Өe2{D^&qv2G{T^"f:3?/a+FfO6P܃92*h>CU2
E^>ŀaY0	-*>e”߃o$|ݭcCE<╊6]fӘ;Hv0\xeJxfF3Ar2>(`XbqgUbhYHe
/ބYWzM/z[>v|-gJmG' Z8r=Ze!}]d/Heu<X
 3KV7m%]" S.7ct*ILH81<A4P*QkcnOq`l	jclv4>?IY[/gKh:HFOڟRXĨ~, lLI0{w:Px-iQR~5Z9FJv
|Ca\2/u=3i2UH];.(wr7|n1r>XixLDByB4(RI}O["̯}ͣɀ]p-
YjPDF>æ.^qc5T
qIHM޿\1U䉚
諂:L`QVMf,L`5gsMA33&6S@B|,4}E}l`1@)J'60Yu}6vFj݌OҎ?5X#
ߴ1J/H.Rҽ>T"$e'-y)!As"aG$-XXQä'4P$AS{sF[HƝ;Xd1AƳW2%G\tQ}䉀zL\MIyrlI1;k^[&nZ7bKSUeao[:lyeuqr+iQ*s7K3;0*bIdA}=TOc.J'eFQ`^~:WS/WEQ6`ެ`6d4G֛|Ai48TxbGOJlCq3ǜ8FJ(.fL>JXV,zjh	bAi(lד1{t=|H섍K>LkjS-M',ƽjHv*1͇af[ל2.,J[`vb'SwE/OYŃ/ LqJgxvåEwZJP)O-qoNE?S6eԖ3L['͝LZ讞Z2뼾^JgtCE׋G&?_.pܧgM/j޿ɎШ~f沜*pawb]#^нԀ0/䢐iK,zAhdp[Gh0GWSo~ ɼn8o,$]l)4Gl5	'w&k>"6Q
/kH1qUOM9}
,cɌn*ӟ*+RFu8s+:Pn1x٣?5՜UņOoP8x'K7Z%Ҍ!D&
_A*KSGD?ia qpLieWwb8mD.4s3iؔ7LGM"8OR	?p"A
t6׽$\jAp-=bDˏX|薅G(Bc qn&7c6:Sjχ?#QAS_4wIx,w;#RSm9r,3)4GB-t6ʈGe"UUif`]mt'P+?/yVB̭QA_qQ%P&co*vG"ݒ!U#}+351+Ej`R|Df638-K|F1M;u3	tAT{lZS3qnœ67*%#OJԂzC_@m.KFm59SFjRNJ򂾣sw(9;Q*y%`O,2QRFq8.pd(Qm"`)L 'Cm#ʹH,^:"m e?1@5d̅dѯ|UIY1gAzb3Z*#<ݘRU7s=5
>;1!T@/#5TWս
IaҪ]<^(}wRD/}ߟnroxNL"ѝgs0L))JDc*UEA!hX(Ko-L0@ƪkhIU	
m
$9ZgOd'I×?&/@B+1rh7*Kֹ妩(֏$ؾ՛`JŴ
wAe.f~&BB׼{-Nѫ7NU6	J;hr
cYPDo
`e\0S)4 g
Avnb}zQS`o(ݱ"dś_畇LZ6m;G,ݻH/T[/"7@Mt-R,26NqլN[SLڬMCFbAaa_hSrb`f4>sQ1+WقqJ<5U=8#Lߕ1<9Ez>(z챒h˽?YF)~UY0MGC?ҩ
bVUoMĐKKi~
5~^b@f^d2PH7llrp9%DcNtQ~EIMƻh`OrJ	UGJɵ:E/iRUv9!:kЫgI<0f?eP?p>,ƻ_pŴb..z#k)_Q׺pɤYmtJ~0Z۪L0g==mners^$:<iwEAF%'|Sg.*"Y$J-Wd^iJk
\?u#!,`nYtek2jUm&q_3XO@1I\F
_%u7u,>:s${^١Dr;K!RZl'X+ؒ#JP5!͝^kG9
E\iiw}qU}|*4n@T
.v[UA?U4w(:p	+F.;bJeBݬJ)|)fB+V$ѿDOO2GV^tk73?6`!lZe$_kKW%g\7+h
OTFiGw슧éȀj/k-:\,D4`PtMxwu=@waǁRδ:'zR3u?V$]5,vǀhgGrp/p0ȉ|֜>[%V3zn{PN槴_0)}k7'HHOٜý=̷WxT#j-mRRLFgXaE$-W!L|$tp?Sb|?Q1gbirB6)pBk|WjNpdd
Ma#gkc'z?VY(/,om/
OIW$ސVeJj^.QME]Fh_*7
cDOdϛqX#gwDK 3V,9azzt)Ij9U˳EvWwMPB*Z
!<{,V*+TnMHpf1;ק
i0aYI
oa4nEdH$GJѸsMơCx<ݜbZܒ]ven@0PTNof2Îj@e4!?j|=	sBu6/z&w3 (GK
]Jua4g4Fiz5&ȂM\Ӆ(SXYޏJ~-R/!~w{#ѳÓB*ÿ́;4+Fә+I`NA9r>8KS69$Zڅ1z3]%t!o;ASqv䖕D:qZ$쀹 	IlѦ0Ѽ%-Oڊ&s5w2XHT_ZaO	n/r&,YGsF0Άα[ĭMQyVV:#?A2F!}3+F$f#,SU˴	=kͥGͶ6iIY,K+"Hmf#6HG0
.Td$AɟWrv)+IV'96peu@hyϠ4~L燍2%v;v$`iQg8r08]D&Z=w޽!M5U{)ӽdN_AiXNCb]k,ch,rO}C=Y37giA;'%&Zpd~\6l4 ?\AzsRG-܅{FMF31mgK[ԇoF-wgEM+8͙#TzRk~Y߀?gs,胔|K?A7MxXy9"ڛTyd`|T%)'9@^rtRtվqsbY~fz(2U^9)qC,h{P,mSκה|EhC;ᯙZXM.3b(Wwwz3( ZcLgPzKE[Gsd~T:&cRI|@-brFq
>Qģt?EAhlf('88.f❚<.;1c:qTu8t9dzdFAEZY_ j EұrM-[[K%!JQU$({Bɦ#?gm50>@9r#	)M6=9RP.Ό(.,C=Oy00a-y+>#kW=%vE[^]k(n-ęOyҝ(;7;?8ߜ0o@ˣـbj7H]hhQ
A{T	}ԶOyN3OWGZʞeCGj5rT N".YlhF4Z)C|+TмcV
kUnߣNI.бYQRm:Ahjx0ȵ+);vsϸF
.:t-Bҝy3ǍD"]7&DCg#>5guv+
)+9C"؜n52YcmFq`T>\u-eej](+ka̲|>^(To)e
mczM,{z|ym+	킚e0'
sIIw&ڎ3'
a=̍'.ey1yjb8;AW%Ngĵ!;=,6`;HuԁM^ue/EKʒH7G㪒
[DO>Ԕt!TZ!&.5h!֜֋󩪖kkn0BGK e. fTw[Wt.V3_ےȆ[x=4|WЉXg͐}w}Q:9o/C0f9w5rBy!
]Ƣh45

'}J~_\kRcp
,f?C('ZH68.\yMDiK=%
^zZN_HQ!aZh⪿Uxdi|.Oq^hp.u˩+4?YKorden,۬
zf5K:D͂sC#>})!O>Rz@vG5	܋Vٱ-3ZBI.|iLS:nfRiBv*p:H{v_Aev\Yѹ!-U񏷝 6x6lR>f‡,{;d۶IeIɅG聅-HCs
Ҋc;;Z֊kL{
d	)Ѹ3MJ cykBH 9fIЁ!ՆmGMQ`2pBIo&egS@->"T_2Cu݉ca3Pϖpbo*OꚤW	sՏT>*cuo0vڢd3a~gϠt.Hx`mT1!ketv^<^~G0R/5'
fv
لvhA\⇠ŜzT]=ujmܺX:	@{Q` Qۮ-%Tդp=$bsbʽGYB>1Jj!/*^O͎ڣ;w#coS(t50ŭ1=Ve
wg9%_/&}_ˋ]
Esmw*q5dhE͵fkU&,HŝN17BѪ
ɭPl*xao$FM3?>sa3e6㨡Cz[>*RX>ܰ ӝRVcMQOQB6VJ†ȋ
su~zF8U|ghJß6{>v	~IirJZv.
F)QEnYO†fø)Tzgݘ0/h՝IȸBz=&4Tg_6%N4oq,={9%sFl(OM3:~E<먙ӽOnt`/
~AlF
jq#CRyzÄg㈿iji
=A%1=dr>Y±܏jCK_3ߖ;za7'}S5^{}=6"Upj)ɝINZy'r҆|+m=fa0~qFsIĆ:NqTJ
ǧ[]1Qi%q&Tvlt=ܫJ[{y[`ZG٣ef~0v!̶zT}ap"XíT՛S勡.:0tA>QYg25L2֡(ib|!O-m/xka>!vK]km)UVDJ%2kXFrZgqN6,ܜ
G7a'-đbOSL.IR,_`䇬ҷ~Q4Ld,%v6 CҺ'p\qjJ`NH1[:nE=]qAgQX*0uޱ-ù$`@Oqttw;{d{72?{8Ęs'O[ce?ЛcО/-:#k|	}kV2:n26u5
W&`{_TFUxkE{!-kbowGe~HoTZQbHm_!4G۶0)bE2(Fw/i^?:*܃s);p?jS,l}j2SEp>LOfB¬ú?a*dWS\v["5h(sfZ%zmJvfFK:+No)0U{XﺙPasJOQ
:)dj4|uTL6ɀBwSes!i}Ίnt(=EcҤ`-.`q^Yr^oT1ϻ[sI%|Q8d!={pT!L8m&mOB]TU\QqYP2QKTOm4f|~Iz1XEur)uhU:NS~-CݥVkD0W.X
2ܣ4K\?8A%srW֟Bo? Hۿc(E1"%XoMLMFwe̋5nvS_D"ShNU<9*H\b\Mze?*ݎ+cw_35D3[+Tc'E41t)x0G0oXlc|0	oz|.lH9:pzU?R-	
Fς?&uطsԻ*RR69^IJmZ+-"Bh4]7|2LEedbt[)i!al>VYG2(?+j~T~/\]j!Ƭa'?.[}*%]57/354s1 a/sRX7596%Tq}^Hkl&I,8!)T峏a7A}*~MU$)>
dFVPyYN14)*&1aO*`~sfaW!l]Bh,)\b'M=Ѣ&ix^/"yZ_ղ`*MK4O'-Xu(A[ǝg]kyj%L|Q~qUO{Kɐ`*\wIjɺuوDz1P
SX<<]?eA
'
=FټT]+E#*֏~0b>[~*1&;F!1B@xf7`箃g)M~r6aCabwm;{yFjT!wN*m~Ͽ
<:LQ.e2NGG{7m	sM7HtUZ{גCpuZΚ"!ۮPY˝b+Vl	d)SȰ3:!nAUR7K	SA^Z/HDŸ(S~R~CKQ{11(ӮQx%w
Ak5W&[cYZ\e'ן]fW68oAqk*`
L_gww,펑TYV>Nk4-4}#*HG~Uo7
Vd'k;Ċp0k+T!j@ۣPݍ߆!
jt(/2׼PcD>/W3><|HPTOJAwpXUw_sت薒yF3K'{wYf_!MlE08 &]V6H+U!,̃:9(SgZw~C'pdCyQh֤zqXZh'f#TgIw<)

`"ҩڕ-LtoRYC0Q-
Ũv"gԗ/:r~?a:o"=Mtl-7!vVjݡ^v]1xh{%9^mPL֒?`m Kf'ᗽ^JlȪwgD!bp`Ʉkc}jo#ݹ]Ҳt$ulڅsbw>{kg#\!K؇Y2XO
\Dvt׈d@,*+uY
HG?Or09t?h)xD:fӰ4G;[a1ZpyYM'1m.APт>ٗxaB8BvMO~{ZE{`{[mxdj:5q13v$(}IRhRw	xWv1Z^{#(Bk{r[@PSsM$I
v?W`78j㣦!'4o)A,=xO9"ŊpNSR$sdLhŹ
ԝ(D@dL4;"7hUQg鲊W&&79ҟa\ OfXuiجlgn1g
Wvi7n2-$\ǚF},Md5DD|Ax{?V-$
;g\-hDk)
ΡgT.fNzAOk{k&e_&ۏ0rhdaD\ϰʨSUY33mrىkBoilFkt0OWFG)L~N%s+Ý~?͔qA"yߜc_N#Z/Z?w;FM˶km̔`9{p;&NPWK䨙X`t9!Zqk.53bAeMjYEq7!9:4R@Hoyj$:*5;.{MLCd.B:ƄOgE2#oQ;XaH&ӕzNwԓCPRxNOH1)1?)YD\`x1X.BvJ+4}py
7WaQb	XcHp=Рh!xY!6F)W,I3Vr:+$JCh`z80B8u>&Ad{ee+7"~ az݄Ɉ BX~,EHj2fɍ&T[D0HJJW[*AӊzV*#jO;/{ߥz*Hj"?\77"3賤'g6_&&wO)hBSMnc@+@O͉u5_n/wu"HFlHvq	[h,WɅ[ ;p&aUlHeӆSdD~T:Mi'1a+>l)5۟s,WlfvR*-L'{rN~1v_Pz6f"lX=tfPエ:q@6poGC!L$'ls_tWOP$-"%d(p
+5XMK;} I3HCQ~b1wair>˪HSLY'%qLI7klRx?̼r{|
_.I$SKSMHxDUH*Ht"5TMqXn~=#d8Wl	쩲"M*:mM.4)N~p`V<.s?]V.vBםh^lԏ4Qػw_Me?%6Mu_͆(ۗ{vmkۣ_!	fq'AW(ht'xBmUɚG"-T|›FvJdM.>vD\ii54!yTң-i~bfn6jaa	r󮑙%D'.|膗,\
-\	3OW=R)2,ƛ5?!O[3 C}[dm܎iAUݹ4 }R]aRxް
+LYPg_U
	>Io+oAQpr@!-E!ygwFQF{yIc-'Y-c?ԋS9e==&7	ZYˤ2s+QI9[)˼+==i3QfZz߯hjxN.(wJfj+޺oB+9g̊wÂc(m߀4t%iO.&n"KxuRg)棩#Wʶ"gNwcb'I$Qs@]'D2#%`M~vaT.̎.ǎ
Y~vdefSRb?f+Ljw6`%FrE(Ρqi@R,[
;h.XJ$TL?Ls\!-!-%+I-SF1T?!(OV[ͯt5תvhS3k,	@.zPӰwD&5QF"bt+ҵZK#V{2.7"#B5ar옕P:zWTSHew 5"NTH"W>Zm8͎c!	+yNMhc>%q'nzA/5T҃uf|uhy]AimeQ
[!qQgk"|ϡoj#^7
b4[`!X|"
@?IpX䏱l/
v!7T}HDu:;=N#sHsOWƎ{;E
VĦ94<ڤ	YRy"IRWE3{,Or)y&5i	1M_7ta/ؿI]<ظrP-a
)>ª2`yBQfbq8H|W|JȋIO+k|9:?"Ty`ѽ4|
¬Tݲ%ܙD)it2
TM%T6gf|l><4rs
Z®5}kCz0LvJ«C*nȪމ&,0C5:?w^F_lDa;g8e+1FxB`gljF~70A.G"rh0je	k,~WW˴D>FYj<\,wz"c-x[_+`m#F8JzjSd,ܻU?0^Td(A.EU9g%-ѣ)WXbu^x=*o.c;Vc̭4Y2K2'0?K_xv'`O&VHHKjG_D ▇95ֻȣ󣹮
P=U3a)8\mM.xnߌ>/3F'=3lm"*}ɱ,H\c,j	8:ª:=1juT)RGLtK4E'P!iB6ELuIjF7PzD#t`!hdp0"I m'cQjZ1&q޴KU|_K>JBjU7?F/Y(Xa,uQR
s@;z $2o_ʄCމ6'|񱕁}l'XOtŗyO"%)*A.{1٩P5? pAbFɅq9K$[)8U v$F.Q*%6$-P
S)\|:?;RtUE9+z}dA
yO&9*nÌ9I"e߀\II:HtH}ԧ<.2G7SǏg+HƪP4śD L2Ȩ1SK`G<
3H4W=䘑g	yݶmQtl+kFU(	@H{\;f,lP;95*¨]J-]g;>`."fNKt？ZX*\C`E88~],3]Wڪǹ np	֏Z3`LnԌOz "J.P8enB}B%$\묦ؤm2
Ha?vN.#u06|=q
?!~<#c=3eXhXX ^L']p#1 m'͐[R>n{=skU:𺟶	zglu8{VDEEx%{Hu]oPȒYCOM,P`FUH tv[VlZ`*y3
+wx*&N
jtTQc:3cgEtj)xqW鴙1o$
v9c
.	ξxゲFs	2dĘX/'?h#:$?tvr=p80,!YB,O8n&mȐ-z;3wJh}0bO9Xzk8''e|1uM;v
|)ACDb6΄eʶtůDxJGD9KL*>(אdey1DH'Iݚ-pk`zlK%ρ\8Q::jzݛ~aծA5 5Dy*@.6dc"0a8~,ójŕ,굃N``?#yd,dS4XXӷm'tX\*qƛ
ު~Q5,~OdXDkpeJp{ߺ}ڔTE3#,%
}+'_tiFH$=ҥDwASn(f,Ͻ<>"o).
3z_UWAs!C˻462D L%Cbx.TV:wth4
d!p"|lK*KbDC;߀DM2[T
zW*"
yd|ԇd/sIWRda?jsay'>Ɛ07fnp7yOc] ZE}4]3>Q`zR@@'a(:"mwR{UEU9s?UTn-jH־#^&%-<&Jhvvvsns{܆x*^ԅiKc.v9G2 :@+F.̮8a3jh_+:1`Ÿ hicoAp#O[A̖8CJ%2@)	K
^q؅M=a7	!&G$bͮofXMcCq5׉zk K@a*\MS>ǂ&ܸXd  ޹:J_J'Ɣ.O.~Ku9O>5"Tua"ڗ\e>EA3?7K[DȣseFI|MJُ!9뱀Ġpb*u-cI4
u9p_p{l(,q'邍9^
17_μw=QOk 4.RIro_&z+^:_E1Q4WY}:7ƛ?ԜJX	OC6UK*BzSs|R*YOwuqpI(;x
\x|

U\e.0ST]t_q)++0.1sؽLykYPDȥ>**})Q>[vu~䕍GVU1TKVn+'s?:#/QH04QԵ|C7	DNxsj.|u7Z95῏V(	mJ_jO{oht1)_"TH5Q|BxO2f`?܂y,[XVjWz}z(.x%2]>HrXXABw۝؂EwBC9ts/b7N&WI;AZmϤ6wV8I2w)OD1^t+@9g3!$28Ġ#c0:J6
`3א5)$~=f٠UPiat`o
:pD]
JsOⲓ:O5`EB1aF
UqeS&2ΰo.yՇ؊gؙO3[o
.2c?#4>Pm7qh̦usgrObm-E(F 5^fJ/db0V1CWOՕJgԞ2Ų+W)6Zwzj$MsjɼEY	[LF+p&:z7V)1M,!YR)`.ÛURS,6gLvL**A=GN!9_a`^-)ea@3*Wܲ@hlZ1-"2@Rj5
GFSJe3{wz4
S\D67<%QX	VOJ|ED	
_G(v~!S;rQ`w(2
Ml0XNUb~CӾga[	=p	b=nOE^,2Mr̟}g.䝆]KR)zi8CH+L tNZ$ue7M$^^|mO `KJ΁4³B")+,V#eS-
qɚBsZh1tʞĆl0htN6P.5DVѕQ,5ͻr-\͖5xl8͙@xerL:ŧI߸O.Frwr1*	x?Y5mmˍ/!2v-jzx NC)6n")**tf96$R+4JTb
Sg,Whg8hRƌ_gqֆ@AX{@
NJ4C܆u6mG˷Iz~ևfaqezE`wS}6‡$.ۢmTrDi:n/
gffl&2"f?h6%^fJ%<SF3
/#
Vzv="8XZ(JtGAN-'NCmISmRh~=Iyf5}|pڪ;5pDP9Wa\ЮU%J=m&-
xXV\vR?I܅jΜ
⚃kU>þ?&p{Lm=6Ⱦ+Sa^Al{l9*fmSjkgmDD?	xQvѯͫ'83Ħn&ܩwg읡fb+{h
It9?N Q(~ҡFKf9#,طxM&oP1ˡ5$yEWvz/ԩ%8YHfF
@	;F42_cGHm4Ì}$Sߊ々U#΀u2Q58Ȑ{ȓa(=T]JuZqY'=uXk@Vinpŝ!uz.B?K0TiTldWVxϲ<17Kg}?3a$17/KpgZn??Eo[6Ȑh,7\7W+)ׯ0yM(,D&ȳ,dB'yso\pT-:s
?FR۬N0h_]ԭ[)~Tqm2J4x&e;R8W)ۘYÃ5_(#77aɋPrʦv(Ԓ;J(maPX@~obfs#bā1y\zwVo44 ;Gv
As`f2Ƹ3]pK[OϻGt.Q	R[[B;F1^A(K'i~Դswe)!'l
=qJ֍#OMYxYuLsi]os~
hVK.ށ;or	EovtLu #ۯaP8JIȮC[\T,܄@ڈ8lNu>S	D(()vd"̺~u9*'¸KzQyNaM^sSV_vD@ܠȜ
qaܝGpbR&mPVCMԑVd1}RsIGG96eFծ~"H)2MI<JLB`-cyUҌs{乼#B	,6K
(>뗾sxˑlX9s!LC%=S5C	ybh
հj,v8h\uۆf&
KWICt7+JA9g4єV0ɁcTzKlF"]qyniνhr[57-eTK 𫘆F>ܻ8#AI~QH??OK&fx#aLs
_@+~'wPJ#Ev7y$"$"dd8kOך1av#yZgOED&7'3
w߄#͆z=%*tZ<	nTh@az/	Qj Oāf	W,?,&l̩Y'~AQ{߼M>(!	nQk1<*(kU&ɞVڈbs%v[
5?I0(1

HA5H,/Svi.j(h5n.鎖WGgsˏ+c=iG%@\ϱt@ŤL\>YN3sȽ?l0ܔk5ߏޔT@ʴ
lXk_Z6NJ6FxzeCO{+'̃Nu8Y	OçHXz%ʠh1j[f^@aaÙش4V:5%)iu/:@|uiH~a	Oʂ
țIk|5WZzOTrKB?:}f%㊹58?$J$?n{K{.ݪ}>$6w3)j
h1@tv!	JeH[,%;ԥ_%ʋE¸ -{w0mmÕrz[ A
紨Yr2ѤNme9X\Yp}Ź`4Vu6]W;L^	|t"<$g`o	^Z5K6 %<ikI$Gn[1Y:ڸԬ:Zq/.j{3	&TziL5|22sϧYEH,X6Bg(ՊODL2;FE{2Oлp'W+9zĝ![nXuVQ/
Lt(yQzoc(?`Inp)t;(<$vIEg_LD3iI`k/T,6R-_W@ں)#pHM\2o/n.l6n?|Dg'&Ai,/&5@s=߀ɋ߁A.WIRU
,@=,rWV9phL.leDV5)	#W_u+ 0uw2qh|"LkHB)
K+\Ok%
,ȄFw¬ZjS6V1bLbSt YEU@S~1u]9o*iq7ї+hCBǣ$SlW~ PwSW-om%.l%
mٵұ3tgz
QN.Uy"[[jvվ]IXiQ]J:q',db72ʳ?^_yBT-Ṷsi|DsZfzʧpv߈gvmJCU}/#vAlepp˖-|:yO\4PF5Tp^>-PF}Dn6ŧcmv_'#y?}H[׳B&.M5V_!VSiv߫S+ 9!rd2>f!cidV_u: 	u tWm|aU+m@mE
6vO칽n.VsP6ŦI0+D. р@o+qP-<4!<22).F}Ɓ%[TVͩPv<*Cƈ>NR)b"ЦJOZ9}Z6qU	(3tGx4+N%T{be;H\{P"ra:!(ܟ/AO:'645z(irB
׹03&ڮ5VfXG x<*U/DfXus.O1,KlTF(kwd@F<";Xkv+4e_9I-:ƭ_d[Pؓ<â@9by=rNB,1	a+$m|WR.mm̻Bf7EE6?ߖЄ˞<Юĕ,cX~;6^ueQ-X9Gplqa*y?_)K/Cd35 Tm.q	r?Bٽb/Z^-\*/nhAEJ6ܚ5N6%D~Ke8ynUD/\']x"0_q"-&=[ghYG!]DoiӁ`w"IĆ+_hMgzg?a-
f9&qn'4~9=hyQUGmfg1V%'=6>:V1U_>@bDUE1#TVw>2rv
h.qA-jc\U/=/]v+2-
 FrGz|o64E%WIiDVPnֹc<͗͝[œn?sS=hd0BgP*~%>qǃ&ċ^a^wbup
+2'v<7x]OZ*ʞTLG۱xt*0r3U)`M:p*H!9 F>>Ij'NXB뎮#؎w^u31uZ@b+]b|Oa|
X_ڝW/hKf>1|M̕x&ɮߵXdayo%336Nz^EDԭDSL{$x!V\+
Euה
of帿 %:\&ؒі
|l,EZ<_}H_|gFtv']RWo<:G4Gz-_=m:>	*Nt:۱T{`)†ayRzuGGGZGJ	-ŅuS;!6Rip-X,[^zY}j]CFHR7u*|͇W>0w39჎CcYhThZ,􌂳]Mj0^h"터y tf-hܼ4YÆJ.q"wi.ʻ9h8i#X !g{gt;Dd>Sɀ$*Fsُm#mB4_W'^b'`ÔnxFjMA1\oMf/GW1W Ky+-W!^?NۊCA[Av]wʄyBx!jwJS
cSbp '[RX^ϙc;FrfD]2xtlpj`*I<GOKn-P.d>5Kh_1<
vtÛՁڠ~!O);4oCVR1xBpM
6P;(\$zSHl>Cv-{/$3#9}$%/7>#e'EsHhdoV֍L9|6#>PHѺPB*
ǏdST/Y\`d5!P^.ݰ"DBz焏S^8A-p4M'_~
mqg*2Uͅ TiMYiB"R!|^Iڒ1z|5g*z#O7Cղ.<5շd@׸D3O޽:j!Ӥ(^p-9^kiLPn-@4@dtfSb!!O
c2嵡iZ;9i5^n+1^g	q[6B{(w–bH}dPsSoWl
(l,57Y0"( \aö}E48u{/a#ekR9U*I>~5*Ȟ¨8GIhs}PhvBW$50u$u>&96[)]3j(0gKOܚ\V|D䡒'p=*Y`}N雰1duuuhhE:.hs/gOu?YN bORV廞j}j1y
ܔd\
P+D|n@9M#}JS9}/ ZvytSf7b4?{~?R\5|}	'D(r
B`ZVE_'ۺҢds'Yd^	)%3p͹[\U`9WwM=$RHrx?@/nac-1ga#íK3VgS$̛Ed5o泆LZ;G>`nbحNTMd4&J%$H;l"dTPq=#Nw(_xtvdErH'^աD#䪾ت?`j^Q%SYLoq-}_PFw3z)y|9'{8)@'{ľuM'Xz{Udm:U9z#;C;W:,3r^?TÑ4bS#6,8X]o	tHȂihzǀ>ez,m4DZOK[Mɏ50Jgݧ2(*&α{DR_;[;QvJ JZF>oHa4l)Z Eo!5muzr!6o|dWs
"Y^/*	j@;bU%Z1|Ƌ1f$9fyQ`#8,
+÷}!ߙW&Xv1pMO2HsܙrsMGN
e^RϚ?՝=@k>mkZ0}?Wϲ~8-|!"INId
2y$>t0s_S:'gavP'K.P!1S*AƤ'woDhch9Rv9&u::t"Dm4&ϊe$~:kʔ8MZ6"!sKF޲ BeҬ&wVD!k3Έ)e83Q
n\ TEesd!ƚAnYèzbPIT;@R]C-Mboܑ~ImdĺG럳(}!Ya).]1-^w#Sfv|5ްjK.r7vC
>'M&<];_6#$XjVs2XrZM`nmK]VnI3&1YF^z(haQͣ8
J{8#ht[4o3ߒ
DlԌ-cKRQϕ]X
\vT2G9BghLXܾ/~Y̔8TN69{%>TęmQGԺJC}5E?۵

_
YX=Őc3'"{ox!tO[6lGbX
3svmMMˢ:[1x8c+i&j
ZK
pIk1oAfnRCRI4[]P@_)l
rmЗ.gQ}`QP"B$+KgKƕdodoYH+SWqR`4'u%8y36M-Vyjs͇(iCg"eio8HrWDۇ9]ߢʛ.r)bKJ 2c%U3^37s.T  A~9Fbp=ǧ_Nڤbѵ]+Calv7bzvNϼSP?`"!XAŽ)p*(&;0QhmC>25Xŋ;CFGS+&eDF6	b
>qGѡ߅%S$W;ˋj
<3T%h̿y,`l2$hv?ʋWbw,**HFn}+FdZϨ]#  Jx
AX}n2C}|;|Uh¬G䎆7g3ONgIz.6n6(
t`4H6t~`PCqK\0oS^+ȃ9|8Q(|Ι[Rށ:R~tq<(YCl$'Wܛ:#K1	TyTD9g[5n.'k1)|S
e[tCE;BG?b`P36hFd7?PI>.9i0?IFDGc2FjNR(	.L0v?7P܇ύ5Ǝt4RT])dY}Dsh6jnH4]44 )(3QaϷ豆UeڇtjbsIb$*~ǍfB;|$*"U+D1ɤhܣ
W	BaT`j4@K_oMuI@Ae+Syߌչ@!.PS7/
^P&ۀU?Yk!/:
!^Dd
qm	ho7*t7NkSl3FWi4qGիn֦7g%Ѹ8&tҮBثSoPĺ6zBƿ]&V;Ň
/*}|{r#
Kq0wv2e}GGFELldz;@%y+;^Ň 46ij)Qܑ@X1ܦy*Z0qIVb#bz+V}iO}r4ܝBo
h`'g͍OcTbpA%/zʂ	ƍ1;WsOEB}p}(vO㶃
VHT`ݯv>V.:h222x%OUX&Z'N}ZK20b_01b.t6e[zkt_P2DӧsMRZRà'QԜU2d&[j0+B=/jVw>H'"񄱰tq"ut3mnsGc/?GPj=sF䢓KP!vgѡO4Th,66nb5vZ|^%fQ
m2ZzȰkA;n)qsb/WxZcNi㫞L
ښ-M{XXP:3φptA!GDpl<>7CR;kJT|i2O
jZ$^ Y~4r_5)4?D-
]meb|Z3V8I<$ahS,*+DFаrb=[CԵqP*#h['ްtU'*\4MY\,kjHOoG8+KիBv5$=v/B,_I(\JPLM^8b%P[?Ѣ
Yoэ%q[JSmjwk9JMABn+8W\n$2詘=h:sL#vz/=gE?83T=pMO%ӐƁ?a-:P2֒oLE\Fe%Ė,a.rr<"|a3ucsNR!TqxAϡPԀ$ZP\E0v#ںͫȶ&ZјK|s_?Ѥ9w9$(𣬾pvX(B9C2	3|y%]է](J.f"%]o8ܩ3^Î,e&!7(,H	KǣuE#iq{-V>`c&;Ht,m0Wj.#"EwxIkY~ٿN}ڀpYd,a[uW8
oJz(nDe- 9GnSTT%F_p.~^]<<{p'龅:>Rd=Ӽi|{lSi~*??In%hq"#L߿Uk(],m0-
TSEC9I\0N^`8\oVtKi$d)xO`Q#)6\cxVN=OXvHh2/aJ/rGcR$2v{k!Ht
d	b%
.D(s+sZc3rPT&LkT|YAxF%i|8Al6Gu_`"Q:͗6kK5M[m'%։M-mv
WmR&TeF@?4&B	lj{T"4)p+o(iWDJDnTPY5@=)F% I}bqWUn:	+Fùd};|y.Xr0YF9leZBWk>;/ݦ[:\w+ITj4ҿIŧ
)q3x,c8t/p#M"4tsX6c
bcp
zE2Kve.&(7Ȳrv8HUED%
H윌'H4YWFH`SCZ
0_Hnf%΄7æ&oUe.ʰ@EvAת1I1q `76̳= {_CV>u#Q7pky$np
a#T.-ҟn|m՟X\6.p0!ͥ#AV9-I^n # /T7%M jJaFc'pΑH5S1xHF{`Iv+aEt{vJ(ɹn(
Q*#-J~a&fT[U$[>O$IgP]cT/?cI)A[eTkI^W64[WJ:*@զDr[u4ovssy=?wB9X&+B.l14ndoR(qFy%J~K9m_ǥ; <7`Px#tlf|{Ƨi׸1Kbk"&'_p˶C}bL+kh>TҿQbXfTy[%ɫ@OQnn(wדíSh\TwjZՃ&f)cE22̰n?)?E12-4( o1chn#ǪEKٹ-W(;0PO|ڂ3OoJb@A\B>aWg_^4>*]+c7vh5QX f6W_/9>Ae~HtV#;\Z?ST`䢜5q Gkz@>%hR~-hAP)xa4/Mzw'pE)\Cۿ߻GxʆQ_fI1tY=}t@Ag38MI=g1v0X
y`*
8(s074X؂`8Rg1sX_~S'Y?KY=]Pյ4s{"h3K{Jc'/"3{_˵وz6BD6Fj ܂/'52pc_˔)['(_qwոh蒊F0bDL,DUDu	dn0jB
()du@V0b:W(:ήIa)cb;
'@9MP_ό	
pnI8jyM ߧgfQ-,o^0tlwxH]z†
}=ISOy=n?k=eM_6lk[7t]XoT@BMӱ9Am/EuSs(65L)$Y	u'׮QN/ƺ3olH8.mPקlDܞeJQR>:0j5ERTϠIyi
7-+Y[
劐8Onqǯd^I02oE&ҳhbSBh1JNnz Xp-}!ǃk]`IY/IXU{[qY)Ϡ}o/Ph_g:`ptYb!7`j뵟@Ȧc6&>&L#rEM
$~sʲC6IwC[ｺcגn>ϤsY&HhHnWTNrCN1ٓbwǷM
^3X]Ț
+\S'#|ct0WE|3
@	8'rؘoKGPsDfg$9ha-
lz>.gF?ԙgAUYsO@/V"M6ζzD4'f[$>7EkZI!KPeݞS2A*g
t,ۭ^M zu&/ca!5Et6n_IAlbG;PvSWeǐ|<čK0D7r:_dDLfT&'~OFc/☫=diDJc(~9g(, 
7lRkdfzW22q>lt2R)\JĨHA_ࢡTRl0Gy@Os\Ka\nj(UX}b>DP4 	~-x8x8Ayw<}<9f&\5Ho6BX@*ȧ)	brq1\Y5&7ud%AfmT&xX^aiVq[93xw8=h!-ӈS
^}Q9}HɨKZVh'ۉC3^fdbw{ Ȉ#!WDEEipTfbZtnTH'A>``/FDWFOT!'P?Dsِǘ:䙐ȵ_I6\jD]۹ 0~(dr&b:hzZ`NBoSVP$M]cQar*<]?EWx,UO`GC9"ij8{iզ^ZTj<zhKQ٢Hv'@)Kv4HF2?Y*byKXRр$)y715x.?7zwS7=ӭ*[\PuO')ғQ32^# Xz'F=ZjMNkK @NFNQdfv|E8]FGF\7U.`DPHZEqJoHBk|=PV+&q3gɂG۹<CџIOgwT)۷|PL_dx[2ɐ1B;qhEܫ&@cYVڥSKÇSM'&cw@{F07d	/y/ܙxjR%+(W`oEdq*Pp7X<ZĤÌwȝanf͍Ҟs.Yǧu$Q%:1QԮD5P2%dUp9!d4Yh
 x!a6cNT)vb`c-w)&,,}NmBjeҸ,K&Ɉ6Vcez]e5t#^~CZ)voNo,T5I1?W~,@A/Nf^1~B@J!t?o\pvf`b)3B®
v&ƖЌ]%;|v~K$vP)5tHc׌rg CJwhg8beئxɂl 'CY|[LV߷=.Y~TfLG̢A		e@q/ut$|AdN"LlqJY`O5cgwi}hdQGAa(f>jqCZƝy}nu$ۉAU3LX
e41۰!JLFzyJ7xbQblYN>3tKbr,DA,\\uj-Ɛ<$&; ڨ>:\	$̴K4,Ƹ8ɝ67CxZ`MdQbKhY^<ڠ.:0iӴGΉ?Q55:xNAD=cV	1kF
~7$!zߏå,ػLԚݞP:ⱷ&c(~<[n#5oB4"'mCCK"cvt+@cĄU0L5'Egy~w9\T@`C[,z9GNcsq*q*S?YYR&;ۅBM81m85$ͺңj	!Gx{(t1\Ձuf8Ɵ>]20h W$X,ݵ`hғWצ{;RFeL-O0JF@~ɞE
0dߗY9p~8EdVqށBFL{bo_w62E^v˔NYXA"YxF1%:	Qo?H^-/:ճjI(Ua"{tRNS7\s9鑦l-H>2X> 
=XϸWu@欫vFc0;OrN[4 DKԳ&\xF,X-ʍmje򝽿 %џso/=RPKXd{4r3+,AM?P	I*+?*aF?c5-CöZຓ9uT*'qsH@J~U3'HZ-Bh:n)]>.W㮁Ǡ[*
]<{؎/
M}I3oھh{e%XBXiIR{"ϰ9M.bGE)ރ_z_s*R!ReMfnމmsYF4_.BB-ҽ\#׶_fl#{'cҡ#o:jʊY,XU5,7"Hyy!
;(UA!ד-h=w'@jv
wʸlTgo BWyufI?fzLP*lܮP7$*&?u
c:
dosӧ԰F
/5D8$vK1XIp9~E:%dBט99U$a! -?Z!V;H+"{(c3arLo4i~W}f<"9){,(hQ1t
P
LV@%CZWRFJ~"X\YEa6y0$>]3n]7	
ƌct!cd}t
>nDqהY;9:fwim/V]f[1YLjͧ	i8<BBeJT>6Lpš!HՙYWkҬcM5wSOX`a(J.,0vsw҄'Lx8+]}݀X(L)"s%whKqw+~qķI ;~y:nO1~~MҞl.#5`T@4vlbVw>;p3{(qA}\.g
GG<	_`]+H7Ry0]K1Ww
W%|.CTUt4p

j*/f$T
rj'X[/W	Y ~#IHK˰9d`V8`rtpQc|1haX}A9od. WY!+
XJ3$^jtcd	90_=1za4EQO:{*k-rf/}n~Qmv>O?3h(/D~ZvM8qD̀#ŕ`gf8_>e3ƹLLLHrG9HϽ_ฑ0Y~ۦO&j~czԻYGlil&9؊b*qz(hl\k0}?DQQ$&+*~?*VotbKN'H|#4e`&bh߸`^(K'&G`JgAȭYI5.5:7pRFP}yTLjӐeW#hLD#!8U}֛C Zu{hCLt.THDP.!C1HyR铌Hzk
yOX03A>ThyԽ^
7yFRO1=63.oyɼ‡l;,U@HU(vq v*#>p9cj$ΩE9;!PkXБRs%;4zb6fۏD]0I:Fd涵$]PC=!%-XQP}WkB{Z{G/٪>9p~9	B&^+g)ʸp|<Ϋg>K8n-*;ĤKԁ_}`;*?t<0"G5RU†
·鶿%4>Co<~:U#AzNM\okyJ0`ũYӟ \ƞhpXѪf7b^+ӡPo%x!=uG߭"7ďfվٗZdkDOYt6C@{f=8TOLiv<]z8Z*
d_ey܁PIM]7l&=LCF]c
򒉆zx:|%<VS3Pu"}{6%~?TC`"bՇOpi6
.>Dc*]ȳTX@~%Ic`a53Z[5$>-m6?hW}@wW6ÄR굩'LI@1S)+	UR?;=N˜1VҨ˩$~|:`L4Ų}lfYF-sVkEHʤcaH4 a4T%Wq~Dmb5a缮^Uy(a/*B6@Rs#14W}>\$ uH.5ͻs<ll)Q{
-:#|mP?ǒFپ+N[Ks='k'6#e]2-2֨aKKŜܯ]uwfwևhmL9$RgK%5(	PE"DήPTbQ*`N誹LxBs[2UO*1f08.%Ʌ=&uՉfl=͍2.hNd`mZB׬j&O7Zp=W=Hngq%="x+c(F7\.WINхRT[/n r#Ӹ]ZL=DemU36Jʌ̙/{0ryrTXVb8r1"?n>A]К5ed#d%Ѝ(Fu%0\7^	vXnL0)nO1Y!v^=L\\%bjpN
\ٙ,pg)Yr|c̼&>IWc6st/{뽙٧
-qu2ֲ3,.6)U:@s.kƝz0ٓⴀw2@{[Fo2vͿoՆ1G>N7}Ȝ~:`y¢O&m!xJ5D6C0U'm:@({"]A`3d5f7IFsZ
5L'*̽@[^y*
W|*_N:pLr Kn靲@x(qBTTMo}#ujʱ:I	PFM2fXs➔9>*}kiȃչg~Ivܛke
BX*`/$,-;go
VK|.O9"ʈvZwhPK&&>Їq
Γ;bĂSͲs
ͫwKϡ֟<xM)Ē:6O}HGi3 c{MFɅU1gQ7^>O=863˰[%Ty'zQԚYܦUk|ƃ!O($A
),O@'wD̗5ayכ	^I_Wbvw!C$Lx>Q
v|?s@}55Ss
8Gl>Fx 26Eg\`|-ZڒZ}&W}|tdOһstNH] z7ZG,&OIge{	v~R x<9/8K|NЩϮJ(
RSt{534ZmOݮdY*Q
	RԵYx沀Hq,zawO#!AEZ_ZՎKgB;΃@*~fa2
ujI~F`N]({t&FI-
ڸ9KZU5'`>KP.%Ԗ?ݓ̙M9apCɓ9Ϗ9ZzΆRdVhBs{e	@Xo"+h֕o_kV1HY+(U	]X6Tf$אƂzROJ@7׸Tw+z]E6
f&Ěx$T
H_Ȭ$r#ycpp57WnݯiCWP#GVSj0˭TGx{Ҍȟ&WSBE!SQiErfdz Ac80ۉ%sFc%Ae+`u/DwT`	^9`fIח_Ͳ(/vl'gZ""wt/#YY9K!hؤ	KǸLSo3_sɿ~cyI^Jw8jUF}AĠ{E?U~AC&gObWjX:=@$f(Pۓ|_zGoDc$/Øg!&;MAy3$	tn5rUrq=[Ns$_+Sk0$L~Wb>Ci~Lψ b̵2w]o0U{ht
9,-F!j`0r\KW؝_-`%@"{ΞM,êHAeLO(_Yb x5߰=*X.Yd7r4qoG>x'fd/O%5n){;8RbTV-¨
	K1a
f9G6YK	x_z]>v|<&*'yBKktz4wDq	H
x:4cz'kCQ1S(*X~,X
{@vQ^	~\
,ˇuId*1𴩦
1
@B-oŠ#t"EO2(!) ՛G@<|i
4L5Y
; 
q̨i<kmWV05ow3G	"WVag&GC:
).9&z|1~0롃;Ζ!*RR{ބjsIR60v!ּj$0!Bg@>"Z)񢺵ulNЛ:{D뺛rA*`琔]:Opք+nXκ)y`3w^aד6fqۿ»a;RR`\ACz[e2tK?,_Ywp'z|9FuDAMEQlY	mb]>
4=<qD*1Cñ,fy6
NW葎iWply'M@C65>gѬM)q]f%j(Kfܸ=ZZ)q\I7)|dZ_3Z-U%jm{A	.ZljB˙W} ׎¸f`.JOى4,Km66VQa:gc-҇YDB	wTыANޖyxi\aNL!ôgz#!Ā0q3z:J}/sQ}~$$Y>#i(MWd8M^ט'CE*\V"y)UkEslt4cpvGh|V[y_-?`khs%bS{p;71~&EO¾"Z_]0p'O)ƠYc>T9^XByHAC8gi@3I`#v\#)*ٱD"6j9q
/-F(){€dq*2/B]vy	uZt#Ly=k
O#j:/${H"]Gf;oܡvgoH	.|^	pe΅/ڐ3y,=QĄ1)Wm{yNU KapHCŒo`a^llfO$tv?ܠvn|ڤdJ)s>a;3A)6YɭڙV&atrB1f}V{qC 䙦JQPIjTo
c-҉%h$9Vz!QK9JA~습d`F]U_~m[n7DK*Q}Y;6`hs
ON<t`Qd9m
1=kNGK,q=PFv7AJQ7MPBk-]x_lզ}KOm-XAkpDcu y
ЧWoj7X_P#7:Xca3R/DW|wef!J0%sKofBFJ}F[W<D%{4M(zW<7F;J5Zy5W?~KUn2ʍ7GcybX'7QD\e/*7HƝM샰Jphrt,[A5/#jao-a7"7+&w![F4ᒕM8$}	Qߡxi*#Q.0aF]VKI_ds
YjT5`xJLDϘ15W\.>g
,+E^D!+(Sim.]H{tszJ8^yiB5.sJ]we`z3ζ#<Ty~*m$6UouXWaצVȬiokϯ2d9k?L1.fAt,y<eb*+r)똅BCLDEzW&Rgr0j$|ǤwePz[eIٺ7i!yM[Gfh@1:yn/έjQQ)H/)\V$.SZ_e$1 p~.@d,Od`Uee J
wjcRCU{|`@~B20#_]1xz]CuJ
z5">0yOA5GXfߙy&`X8/n	7&N 唘uKN5ET#LJ KSFp$uζl]YZRy85%>eA&+JV)Wځ߉BQ+j8Z$Tm9̼Tz_1{Jq^z;O(.a2qi$[IvE1Clmr`
y
)}OѿX(='Α6Ezj	21<ZNv>ThӬhT:(Wv]VVQsHւ,#D*TnA[kxqJٝe7'"̈́;m6a4{8KtxMS9,7Ý
y0kzu@8*B=bv6sP^F)w
 BIQgQcO5sAkACr$_a|!@LH$5ku]آ:XNjQ\yw}wu!@üWv@Y5uDb&>]v'd@"S_D&5_uO.a"_RIȘw"ޞS<~wr
(٭rP5dC!195BNz~w$d
SԤgVsIXhíۆz8hb#TX&1Qtb5ȧb@t֓ Oϼ剔G'LY#w񷊺S\ͭJnv^$c3\tUB0u͋wשvp祺݄^Ps$KYvƍE'l?MY6D!zExjU%%gI6b$NW#u5mT~ibeb3 /Q|=NeHvSψ3i֛B28H5gQX7ߊft&lBN
Y
/н($XFLRfLeiRFr:dKM
	t"jGp]E⋥^ɱ>3+Wyp[3x]x>O,lD T)UC~_MA3kϧFߜy!TU%Oj\n F
%ȼ4
Ld+BU
'Z
Kj1" bK;9`Y|D"90{W]VFjj}FʦPʭxNJ[|`!$PRfl>@!:W
i0ϲ:4K6f]agm|[\n!$'/MIԕΨT|%0nMdfA2YR!P&GAΆUXK>yObQjd%ܙ͸g&4wm^nK(pc)fN?*Y=n5B3[PYxc[%4s5W
yڑݯWvH@3%B̈-OrgЙnk0]13	8@j{LNEA_Nq&qVvm ƃX}nYLq&]ɱ)a%i>T\c	)l|Z.DSZ*I:Ж$c,}K+lgA=5\t#%I.JR=MqHRJSZo{ILh]g3NapM+|iZoEFq4k:UXrgMe)}a-E…(ZuoDq6"4A'|8śQ"n[uR"5s˧߻	~υmb`܂P"^%BZ Qy62\2E)[@Hfl漪JܫnAHFaA}p0:T&+TeْA@л.8%uc[j\ao~&zvTН&z,H
[MދBBƭ!	]ǻQwu|ӒGle2QF9u3	F.c FT(93Jh|dB~$6;Opx|KpF+gV{Qȸr	C
l:{E	7&Qa6RKu"	;P0*o\&p7A]
0Qv"/+ZAkb1' ^-pM0؇ȞDJOg~,W+؈SZ^ykma/GuLS%qD^Rx
s̜,Ag^:W#?
0f$zҀ!⿟mRDe2O3Nڰ8z>Fq>ɾc\}R|d>W理2M+Է`,ӟ: d>ZﵯȳK6`c\2`zXnЧ뿠Gr>fwɡ`m;b6E J~,{I(P6Ls^ȇىwBE8pJnlO JHjC3Y=f^F%(i#ή*}UƐ>†<}UR9
"EItw`-^Ir&/cAHXCJߊzLU"Ѭv!E	w2GzJ:$l(䨟Gu(5H:m'z)ֱrl=mO
ǟ&y+fUr,98$_{_/h͚.D2+1g\S5{l^kdAnI{,m_1ř!2uD?8uhU+1k=3~<7
+Kq}̢"HdɺL3b/t3ŮW{Cl.;J7:`5_F{E6Pi7x>y.osZKxs1I:FJ틈c2n&8˅FGYD`T>G>GsOinlU2%˃Zf`rp'":ه0Z6o+g?vDo=åZ<ms,HT8ܰi'3xP7ТxoP
2pȿr}{#&2,<A#FmtVJʰ|ԜpvT],aXkBa.MCY@u^	9?-ޅĿDPKL*'5pHe&g^ukY.wLiΟ=? 7MqѸSyMC. CwS|}1[Wz[H'[-V#e`&S{!{] }vF1H.=pD_v6*ٕ8M';~<#UYS%#[AZ1B}fj+d̲j\kTcnЭ.@q;M,)j}44_y41Ws^s-HAZb3GCR=I*m:EG1Q(!Ԏ04p*Ĺx,?u:A*y T|gu
KV#R$l$0MIx)$[X1yTL,{>
v5D	o>Oqkb>FAӵWPtSynVF qWE70W?Ok0@+4ak_|D fQ!0auQ0v=\EStbYJ6tz__<}MJԙ瘞_].ma
쀀&]PwgыĦkg,	tc'7'y+]0"JH=Fcz	$6UDH7>qE}]FNo^]\Gq,UrƒeڬwT֐Ge<0i1ld`y$D*>`߭0ڮu+	X^L7`q`,ZUd=63r"8rPI-ػ/bUt	EĪMUҐ:/-WI/WMpߴ
X?gpR`!_k:J,8׎">Q!u0]1;+:)@¨dawb5.\ќ;b@@/<%pv*-{2-dq!+@f#vӯog)I9tEu/:P.t#LH,MTM(Wo3|E))~X-q2K]aԈѫ6
l%]թ*Ob`3 `DN"LnPnaȂTVD'MvUK@f=j3ъ?	ȝ/#PǡVz!eǬc#vBӇ0fz4ۑIz×1ے*鶊	cäԕ$2.Kv,O!Md d
Tb9gӅn4i8E1re`{zv{~u~部m_nvfLRC紂g{YJSw^և-R8?Es#WɑvȃQ`I]~6WFo]e^3>gZ0/1aG2R\E &͹c]'}U`r~ژUoe仠MoRJx@Q(I7;?54n:
 (:xj_
w0T.qPyG`ݒiyaZf=+| *Pta@2~H%M+t.kiN^12Lzôv!Mh'	Pia͌""ug}<է½j\S^t_W`#~6puʴTUG3ŀ`4EwCC
	-znzѬe_+[eΫ#,|*NT	2QU}e3{?`yv'_{H%#
֮hDŽvq$UN8z:KD9:&:"~c]|xet)|jDZVܓoe%Y_17ڝCm:EtyPܰ	^gL!9]Ӏldȷn=9vH;T4^M1HM3wp9i}mx⍯6L@ڬtfTT`
\^`?qY7_,ПZĢS٣9V5wB-7γBYe~
UA$QJ3J094k
_"$hW~$epq_XE^H&RZwy얞_X3ب'Rlgɶ1cG){?>Ծg`OR15%mf^Nvm|C’{-3q;h]_7
0KdGX\-L;2=CzLNnOL+sXV򑿒|w[`֣B^WT~sDͪX9#oI-g0#e[<:<$POMQLLd3x\$?=fupGbdkMoBLzrFM0SGSM$eɍTo
&~4/;qy~<3v
àV460Ʊpqfx^ke"gbMk{Ia(^<,IdWutKڗ?dcYR蘾ƾL5)g(t*43ߚ[J1,ݳ2ЃCͣ}'[fjX V❲߆y+ؽ]wyxFt<#@vZreT|Eͤw`%cӘi6h#RX-@an}q:_X9V`в]<)'VNz=ҍ ϗ^dE|o?_!]NҴTslu(mG#(H&aM?XJqux`jm6[ҙb9n&eD~< ^YaBWۢ{]R1$Mŧ{I;v
L_'`O/xgkE:5|ij^sJ3n,n€%kxg*
w/}ʌvW<^B>z_jYsIдAWWhlBCTc޾vJ,}\_)ݜ&F$omﵑtE>aZY`uGM{tJ RKLf-Gwtͫ7S7,\8D^p40I,;/Y5vY,OdiA4K_QOpn]{?^45"qpw>vM\޺<&HF]cx/^F;qbjk8Bj'umXQ>nD |Mo9:8ɢaxOh`:>ӹu]c
k/-I|	o_$476h+·*p8[6}:?Ʋo9f#gܻōu'(VX+}YbWP3JJڲTljzeDo~Q4ËWZMiizwX"rDD/`0>DMdԚ-럥HXhR23;Ĥ"U\ca2O'UcsEXT#/a4_.e=_8N%;V	_
jBn*b;鷒Γ8kK7Il.>8zLsNjyjЋ5BWC;mVLsˢ#g\<[f-5xvW$D-bOSF;Q`PU,CWi~}lk쉁~PfFDc:@T&x(NMr.3fRQEݠ/ΫzzLhN	~a/֎X2DajpxӞX+U{&?o&	eѰv2-K竤@zݜ2ZߺU&Ii*6Ǟcte_z*"Go4
*^s$^KRx-?6ꯎҮw	,/&K
fnxYK1	hSSאu^x_KZI@Oi@Lvy/=֐-uy^ϊSxxmP8AFj@5Єlb?_Y
CZ8K:z7Yޙ&{!-
O>YPaCrB0-j>j)wKT{$epP&ep2y /Z6ֳT#5N'@V
'DUI^bx(ނ5G<`ʒ	cz?qnjK\*o5V8AQc}*j$8&݉-hW7H \[0Y`Ba7჻~JxF<
@@cGZ`=#inVYB)\.iUr35(==ُgu`$41DZ?G"(	Kl!`*?u
x&[jҠ"Xd ~yiĆ17|n
>;'Ê#$
I%>R^qD;c$y
@Dn;hqd&pxQJm<~!4RGwkh&-X\bAQh׬	},D[2Do|d"?7f?M`O̱Ri~_ZX
=hQ=47m(te=8"Ĝͥ}7!L]i5nk+1Wn"Yyܨh]q#BQ
Iḅva-+4>wqk'!|:AXl"<?kRύߢ\Tk	"bֻC*Vǀ߲lnR[n% -)a\юj&#v:hrDi$qLf~%r۪\FQE8%.UN-'D;КmiÏKOŬvV@b%5-MWn$%4nb\²)Ɩ
8R0tMc*|?TqC-l*N(k[8,NJNB]͝5N{'Dyme2P[:Dsd;,
_{ĝ]sTm5D`4n/k@.!}e>e/O_2lؑ9[)+tNS_ESr:ε*;ƥ9@d~y8HcY36qK|9|x0X0rIJ6HC'Hw6"NdbZ9#jEŻ6b ͤL"&*.@0qã&v肁_k8vCI:'LJٙOAJ'73EA@FT>E
/%6
N``+
LzclB!y<FW$23^ow/RGԎiЈhn\0ÊGIw6D|^E8uj30E5XV(/;^0Ow߫JL5n4~Ao3DHwi@pY.r	@U<
ۻx:Y|1'δ7|-wY	?V	bWOopmFkǩ>K_L7+b3Α?-[f696lzAu&:c*܂HsD^24t0J((g^oy|Wk}~[Rd Ij[dOy5(@d
&$i
̯piZEL8-GCl?_6gedj$VQ,J)kmğtqaDͪ
YQb[(7$tWEFqo#'mSj'6QgYRTidxjxdjmR:#mz5UB,ejUP'jfK6;a²
A,lnLGOw9@?D&T_̃H=w#7[)]#	f-LXse8zGi@?@܎xƳܡ3
hIت%QQ EbQxVkVlu%L0޺^/8,IRrjarxѲ	Ia(s5wҩ1Toݝf-{
LO܌ȧrTqX!K("ui9lI&xy ~7zr"N* 	+y
">p1 #
yz|VE

mp~*,<~DUGd}H)@̵Y4G&츎ϼ@x:DD/`}tW\վ!1/,Ժ$R9*aϐʍ%{^ˌ2d(6joVy>=RII|o{G̚639WFRQ]+V[_drIUL';QޢxP'^)'>5uHGN2woipcoFҼ%%	ՄRTV\,F2ClOgԹU/ncz9i{Gu|p+U_EHY㙷v¶/sq$2	7P㒺鱄,gW
yDVEO?3ȃtKA
g3KPhٜC!gȡY¤7̔	J*:(V:$mRJFl'zMz[йAt;tog3agz?L3A
`oTf\z	ß28	Ѵ쬻Gߑ&f,U7j
~#޲eso_0$
qnZ|`-/[R•߫j
jklΆ"aUT}KٿjI6)GL.? C%cԗ6wm?a.d|<&՛`Y]h}Ф&L
¯~F,[uݳURK[Hs!YU5Jm=~wZϊww+NW;׵̲<|kC3 &8	B!@Jpp1ͺ	m	m~􆆕v
d`@edmo@1rK?	(]}v\xrd㫣6q|f0keOr4=!MsꕦkSӌU+i+U;xFeȟ
)ƜĢ>nAr&T0J3=8*[/-y8sQJu٨u|"dzzy昶=x_nG)N&^.UL^Z?	@n{@1K_5BLSgy'O	$wM=ZrIKHbykv_bSKJ%*%oQ
tVZ-uýIqͬwIM<1YЬ2/A\6BE_:-]PwPYqw?ildZH6Y?5sx^
ș!)$&9|^>Xfp	80gAsuѶvU@-MLfGic6BcR f>܋3ʥG+HSJ%u9IpHsF}Cݢ@v5
J'ݩN?svzmK>s?~b;1tۇ)c擤2ǬT`CM(9aJַy|K
Z-83*ѣ#\(Vתּ	k-Βm5N	N"
BZJ|KVh&g8{?8NNv_zƙd=[77`~̋E^ꠄ
:i9Z.׀*u_`؎bVxL٠
a>ژʬk\mIt-Z?aeĕ.ܗ-(z%-b}t;K^[Zw/-n"0\$&V&Қo'º×n$#%q{juf{GWES¦oxÊ&iQWV]Y(nְX-y|{?
.;:	rZ($)#'ѾL;hۣ$UaL F`ПE"hmİc`cn =2|RV.L߂hdf>E,t
C`Ft/n|"*ngZ;n}Ŧ7ZSrlrDW`enzt:op$t4Ty[疋0Y,Z՞t(.4!E$Iѧ#	>ˮ^j>Є@|ƞ;]"%+X
 ,Q{/5%1&^&xu7axQZ
b'ǁ'>BT?*ece=??Ga8G4-m9>SİUcNBt:j	uV|汽yxTa	/3]D纑dNMm|@2pnsҫHawdFV(l)-sEj$Q_:kw,'
.B>m
}J6l5EN%o^SeK	v{vK.QQF^,'to/1YEMt!`"&>l1lmX1tR=!Z[l#c7A\'1UP~ymlVˡ'CC%x'@@ksUŴZ:xI..sNh?np<{v`;\V06Y^'/ʷp6']8wX3SDWBT@7~AY鷬Ǣ]},DtXQb!SU9"(oIc'z!	
2G^ V;lN)D.~	y#b
1.H7‚ ʾ[q
H
2?ךHjcT+Ur3QF}I{"#Yh3)*`/e]1.޽sѺl(N
#m1oϋz: p1(74`sqrת.Ll]^˹n&S~f{c0+򎑥l)2XFxBȶޕucB@,}9hWi&hm$տLzΜn~t-׍n{Ep8E\D|hDK*vyٓ_S5liT|V;
Ww3*g=cu+y d	h*-/kW^!.y'v	5-j{
3n'ǽA]Bf]}:ZPVՎQ}|Qcԁ,tv˕A
表1㮎+eNVmVUi*U+/X
l
\*:OIvq4ʳ̸.Ψ!.JCTdy3ad*pp+lb3 ҖX	uT]B8sXWSoyGe@zqXiB}gk(3jj*1+-})10g6B7mE*u/]N_+M7Ֆ0iS}2߭/f-&`/;ù
A
&oU,V
֏ωHv)'=[Hao	|98]jP׀ȩG`LFwЍHpyYw0r/coNӡ'Mcvmi
%7Jķ]8tjnvzr#N;zތ{"~i@4ocp,o|y,8;&2^,Yer=a}ײf?}yyWdK=-rԍ~9'=|e󓭰
sPHvVFKٷ( oi<$$IJY۽[dkл	*o[i̅BDWsu1~->>}ԉ(.Fga;;s4|Z,--YDZ4}iwvWX?OWja8兪PZQ TT@MIBt:I}#
hѼa❕ZT&&VUv}ʕ&q~+EraPl8lY08+|h=:dQS($f,>Tb?.uKo
Fl[ЬC8Z?L- ?9{!$3rI`-[&sg=_ޟlS`:
$NE0/uf|c1zlK,W"6C.3AcM^S)LRYz(}yRmoYUW#Ua7R_dy=0]ILi#'	:.Ƿ;?+tz|T]7A\t!W97:R;ɗ+=RgeZWN*~er~[rTOȆs9>=O҂4Z/?LyrK,
cN~R4\5'`.N!M9^eԴe\oM"at!Ҫ0Ӭ~.Q9u\^ㄥ

ݠ ViƉًQ	
gtT4C
0_x5iˡ}ilrzތ]5otw>Sn1bNsOXO0]E"ȊV5|kiYƔՕ9}N9H7M_瓾٦[$%s%?Μ;!*Bt93W'L{
/gܨ)Ukvw!Nj/sx6 ie
*8>t&'|oG5R~C霠cO-LA_r]"ofĹp~*dY'vVmj6O:ϲ &ƣ0.
n?]Ts-x(EYNǏǾ!h5rc6!X%B
f[
THbP}Q'9/TbT2Or6s\(ƓuoԌd7(6Ucf%?-[~ܒ&~%pMˡXeܵe~#}[;-BvuB&?w&U8v.{
5,.CqHnG›-q`Dp4Xzz0D28nݱPt%	CX~m

y8DT\&PfJ|YϠ,P&Q
;ȎuP`~9}3S@Fn-M}x?4Ngmzu; vpu|Gr۵ -́6xL_2m^?/;N=Hƀ^
O>O^NݦjA;ʿ>)qlHJ1VY-븻3Daq	?47(3&l<=y9g)2]ʳ'M3-y+CT2ظqֹԢNVvyQI1܎;2g|JyPb"c8b#^q]i^
agh PKx?vi5|e`~ݗV\Ռ-"{C
'Cvо4Ĵ{bq271x!Dv#$L2M$BS2dHzOLܰO yuZ!.sE>/jtldu.k
G0~E([1h5ݢ{[:ÝFù*dۊ8FD(0bW-uDyV UP	J9sc>ձr
_Op*CX_q-
A;aV}*⌄l#(/O4m^[5Ȫ5
w?"er^'::fS?3vaD>Jl|HnJgl|H>ٶ*+i4D!tm0苾ĴH90fٷ;haTP@M]*]fe2Dpvii]>u$V`3梤Wb_
n-7?yW.̈x!_"#]_`buzξ{yj{:SYc]I/ǹ`DAi7X3H<67sG>4TA17WApUAIX~񳈾k鬀E(MdO\rK(U
*bF"ce`6ʿHA%ˀ+e&dbǿ5+Nleuo+.XFBCċV&JbBjbY3
CDJGd
W[v"6~O'@k$!2\VӋ߲u+L2
i9| $5\K&Ckjx^&-l*f1*OAAhVYNLv-r,U/İ7bZha~UU|+->TL"St)	u5fA\w;D`T[Ѐb@nq\yA5OPL~gn26
NO)V>$ːإl60u\w{}]ҰDɿ9TQ9f9FcM
t*4Կ5Mi,̨Pʆ1l$3MŌ[ye0zz¯C(H%a4Z5tF^6QnC>ڲ
պT𮢙硦IMG^%ntIw/ˢVagylĉbD2Bszl,4nMvUd>-7otNrUR7$͋	;\#s^::Um0;.PȬ)`ȹ{\P8[enA=Kz4Z>^(Ip;ZyG.s[ˣL{2׷NCiX4.D>a´.灋:H:.e^{{x"Myz(}"۫XI#A::;=W1K@&-Vs$aبoz'Ҷ)a$s.ZF)cgf$h/Dyq?%dj,Bu3(,D$ Ş*>BJ[S[I6/'Vq3^ xFu3HW]zMQrЌƤ:'oBeGu2TEb5h\waѼ9H&E!N+ʰn8@Ok>XO"R1w41T-͏a(?>R2}6Nv[-]u´0]k(gɺ׈aÂ֪X\~բ㴂mW
[fEH&3"zo#OhRg,dYW#e>Mn:棓U{wB
=N.vq-͌*XQi#"6E$	Z	ȭbBv픾pwuC|뒼,ȅXB*uRMiHS9=(y[s'˫-FݛJˬ$j+u8`~CŢ\k*	ĥpz_rSǫ-~U_ZT4`ᾠi񻺀f@~USlʹ5O<&dA-7y[wQ2֫@i%D=[':xءSB(4?R%&!E±I!69zQ,~$omY9Om)~W+/xʢɝJ3\fa}9AǬ 1?KKp7*J3Cq@59ZKl+Ritѓuc@h!ś1bO}@ baO.$&7@o{B7Dؕ'
褉b@'+bLx	lMC6vXB)2ܲ9=Q\zI:X]K w?CStF4SAiok_b%'
o\her|Pu;(mKϧ^YP؏3;.!oY>?PX?G򫠯,|Ymڞsz1Hz0^$eAi	,;ys-ƒ&k;mW/)E*Gok{";s4GhOmQZqF8F̣(	JO}DsS<ʉҬ0'vA!G
	FbKX?
QjJ/}kb
ڞdzۂ P'1S%@Qą
+yY3Ѭ7Ă~g7y^aV+>"j>9
yFlP~ sbyAga59'í`DɿE0_E)!C+og|A]"&Սkt,iJ.S~cϭU7gCoZg#:okrsXD6)X^/3
71
)ޑAk1tl!׫zvHגL2ZuC)!vԤ_Ԗ8k9^pI^h!=S';Տ횝Ԝ_F0v2o)7|r3L']}JQŭw+_%:nudr@N):/HOc)el(P$W6ǒ0]._}{ʸa4
,ݧn	uAѻHP*Q:2,WVd[dѾ	_\rlN:PA@IN	UlS\(GEoda*6?[,E
0pU6:4iiLa|?%*2wk3!nzaEK	Uv,2S
{ޮƌF31VY>`$/VY03L]uiUnSb>_GX[&ZQy I;҂W?:Erc3^G%KXk8 [uX\XOZr2hF'am,do~.$
߀U؏{Q-3ô@g0K.2
=xoBy6/>;DŽ[4N+SZ5|SxΗP\]q
hH^K
$'b,-{SLbV.[,b+o4rPYW/S7X	MVDz(_t4~u:9dEW0H)|,hb#<%ͷd$	,'EYFJPnIj*	+ڀ]@y	Q@
6lӎ)8M*%E6S ĊM	/ʮ8b
8&L @w\馗E^]:ڬRswd
V
˵;8v8:\>{lg06(/ =T켧S ,(CI&b~xt-t86>ol=̢/#جhU#8WmJ8r$EPɸ5ú&vSHɫ4m9C#RB11
Q뫖;9ݳ8I7ur
%u(VT&G8@3н޿w0oUҕ%4F+>XÙVb7.gKiu3	H=~aY,icmv…c@(L/s:Dy2m?>0d=yFħcW3dISiI*#3m*Jsȴ|
w^$.r(fCFj"(\W!j?9,%foVEUIdk#\)p7	teErwMm}Ƃ[eL
t琗.T66lpo([~B?-?WnU
y$I),Zѓqt#uIdxP1x&zKB~fu.XH7=SV1 szFkd31cAyуwm-3TFq"1A9x>Y ,)|Uoy
tv4_Bgg:{u1l6^(E``U䒫-["0NtV[&caxe*s\SfVAI1W㶂E
JRk;~bT,ڿk|T`(զTW闀VZKH>H^†!ۻǗ[qVWz!.@,|l'Jp,"JrI[UE`
	ú G]PØlSaD*BZ4˼m֘\,lW]	-~ˈ!4Z|=fґb%1{"in]3C>t@+Դ|kzx!
G!$W抌h  gerF]B
FG}T0:W
Dy=mVUAƺpEI>AQv=T`98h&R#ظI)
>Rl3c^DrG=纷K4丝V})	0ȶz UxZ'Jً Wqx[.Zq`{ahs3mXhDZFonN$h/t؅XN+
seŮӝ"T}ۄtY8_^3LX#m?XBN2وx͐ffe-rІ=q	dэhJYsPVSWԀv[_hJWAlw}a1
}`&5]:jꆣZ9W?qv΅ȝQA
Am2[[6EGٵ;2VXwO8ցUB]N!LPMM\fc!waM7&F]REVu}.B,p;F<٭;P	v9M
|F4VɳnB~7il!4VۉaTf-~B$6'[V}~JQݡ]qFIv5:U}QB	{"2%;AG7(k8TMnpaQ
}`]7I8_#6r]M)t&@_O)חA0<zjM{&9(Wĭ,Gho0<=Sa`乍#隣
_d}zmM,ohtU}uAm.yD0z~T@)'.5j:Z~ƱDnϺp	%FI
I-=44qOhu`B>5sݵO5cbD1l+O|Xp)nq{Au;=4칪8M>'D\)>5]"Aׅ6mڔ`w3ڬe}앩ޠ[[oL$cmHL0NwOmcR; q9ex,EPP, K4G+PPcg8r/E?63-캠GLrq08r4
|{tJxR؈zzM
^>'mY<<۪pEyÝ+w;Z4s+2}v$R?q\]Ks[7'M;ß5r/bډzE2w~L@"\sd^"x&A#ﭞVv`\ؘW_ht膧!"{mS۔
'9cزXߘ>M^>L"@m]'i\{TˢX$5)j}KĆ@/DѱnN$ 삟~f:cgt>2,;%TsWez{=XxHR/q)ro!>^΄m87x:
:7%0CkI,%
'`_i*t5wlHL((016r֞2Mp֤`s둎<ܨjߣi!{=6&~A4fKBK0)D_5ML0e!u17Qсܷdx]?RqI_XVO۟FBiFlpaZ䓩p=
wNTS'xi|BmP[VaZԠl,V}>PP:]Ҵ$m1F(ƣx<`(fN[̑eQ22-Mp#ev4%bC40t^0}n53!ƨ}yVa
FfweEupݨzx]`ަgešf]*8AQʡדv'3!;^*5۬%?S*789|U/~;90QP@}pWPx5M1q_wچbї0q As)#iR_x*[HD
(1RA'/#5f;g)i}mF
2	\c%{HWA͜F6lZѰ6(Ѷ$
$uEY1rl#f-kHlONo/,:{fvE<9Ʒb@x,zR-jn\3q!]pA)qNzE
88;"&˅Eս.J+6C3?Xr? +@z-&f0=%af{GdU4dtЧmM
|5c|#91sUBNOCKB}*i
f$mҍPvG^;knZ]3\iA>Pܰr	YQURpF
X
-L4#d{Bf;VuI0>^*=)wgl%M;,CW0	֎smp턡a\*]0Z(3{pix0zM|k,hx>V}Jы.}{5Ƣ1H1)G6Լ:v􎬜=BIYb?)C
(QNS\a׎lqppsUM9_"VwΉP)	ĺP)fA70b	"x@z5fPVmk#i4eTm2TM%S/n"<(0VPvNf~o<*E>evn|eMIA\lGioYeGvu8z<3/;&]sC^",0%zdZWDx~v9!v74R[C%]fn*UY`ťP57?QYW57(OdGo嶛Wlt+"|7U
qKbgqqnP}mJAqV2?`:-)f.=?GdJeRYX"^ٸgPo&^míwڛZ&9Op4V7HSiŠ4RMج@ŬwiMHNBd;t p&ǭK31(x]ǧ
WofӇ1!ؙ#p[{";7ue`䐘H8CӀl!޹z$JvP;Z \=N90eWWS8ġ.™ъ"?G*ix+2@L:{J#_?:YX+j	_
Tmz!ںb0qke7sGt~4}ibTUY
;ȎrWC;rnIFk$Lp aZP%mĻg[ҦxcE20Vqj1Keɨ[eZo{j&.>1w\2	f,wl
B;h͊BIBiYd9^JLn:
n?t5SO}QCط}0c_9-zc&r
f%Ϟʯ*xHO>.DK>dPL9ása.PoN+~_v {Et;۸h6|
#[H`}`Kե/XsbPObfvG2+ɲ*5ʄ=o0QRfG,/Z-D^ݪ	/uc-nC"(@^\ޝh9"i&Un\tWT J䶉_2yRw_[z;[	$27)Fzu>ٖ.,KJtdf&aZP$~'t2F"'zyO6&nhТIAe/6ğr9mc/4U
‡tO| Q9Di%<dt˥rA˞{.)@fT73v&kKDHSjNz3{</B̺uvn"Egf-HNόOH\`st)0U.c&G.MFQľ`9`5$KPɞ_,]^?z6(YL:B=YLF{3n,+F:왣W`kkOβIWwz1F%|T2ΈP"dum۽wbrJ,E5%{/H,}V􎯲~MWL(=D

6
һdnptǼ(G%ǃ
wL_53UVi1*QXU7UFutQ+(k':gZDz`&)-RE*	G+gV?ظtZm;nϊL(fGtooͯl1R>I_f_mqH5y&t
y}U9I'T^<S.?6=s)Xg(>F/wh+x]vZ4Z%03U6a]1t^$Хh +G`nkGpⰜ0`$ jEIWaj H);_S\zz^)h)
A7\N(mo9Ůӭx*17FGRjk>0!>RFjlq.KxTll7"=%㐔tU
t2葊ð߹yRj{oXS:2",rtXD~x`6/4,<|̮zn">Q#"4@uM		
-5&
?^&@'hZVtv$[_mߌ&"!eРQ~FRrZqޕ`jZO3}	Ho.QDq/3Ԓ*bj:EWO*	4_&%
h#smν}U:wy/oݴ݆O_Pe˽ge13+5IM
3rNNijtg݌f0,L!DiPyD4]z^ӟ~8fiްK3ere$xXx_M?t\稞cdA6E\
ɤ$>OG^;80˰;VVu~zTYT2[ыGʳ:Ӗ3HM_Ή-mǴOXd2FgQt<dž$#Cn:QK~jU p9a6=X|pu%R#?$vCoӾdKzПkArJC5H}ɷҜޫz0E^Cr4t0P4[?GvFǢ6]ˬe g#WG_ڻ1J.NIcjxz-zW!zڹő]|:L$#;!x
aa;iɿsxEx
g1)cgX
>{8DGwnD}wF݄h5l(Nuv[~oצ6Vh=޸B ._k!V
"̓;C:ZkcJmk[z+>|xe=Q*%}Q5GNGȲwl;0~6?(Gm&Z8_NViiRx(Z8O^I=/,Ӆ0&@s7iG;'+(uwZEIL޺sI1xmv|!B˨ǯ6^
:_k‚:֐|AL9t>/즸zi=LrĨ&ũi&@!{_3z4ⷡ玘#GB=|Vһc1quHZh1)h.4:*'ޔ]
mCōX=
]Ύp-c{NpWr0W$w~]uT7`UBCuu'ʻnIY4LG஫JNC_*sJNA'j鈓e+j1}@_}M~MmXcgVH/ŒAO/jj"jal	uGq`:|({6-͕6Zp!paS^&Mˡ+oF~vueԫ9}_VfrZc{5t.	G:fο >4\e	
ڑ}lx܉{ar	rmYdz(\}K3@ D_@Ydm'~Eߛ|c*`(
3#^
,of@}iSG7B3R"ituu_YZx,+|>D9H$ƗMx0;~YfA>T	T;!A?Ycp0,&+5ɋfkYym|"/aE݇-"klbW_*WPynx4P:+%Cr $rҫU~43P;ǴkU/.`6 Rv--3
ʧdͭʌ[gYZdebmake-4.1.7/extra2data/0000775000175000017500000000000012416770056015456 5ustar  osamuosamu00000000000000debmake-4.1.7/extra2data/package.install0000664000175000017500000000012012416763277020441 0ustar  osamuosamu00000000000000### Candidates as below and see dh_install(1).
###etc
###usr/share/@BINPACKAGE@
debmake-4.1.7/setup.py0000775000175000017500000000425612416763277015152 0ustar  osamuosamu00000000000000#!/usr/bin/python3
# vi:se ts=4 sts=4 et ai:
from distutils.core import setup

from debmake import __programname__, __version__

import glob

setup(name=__programname__,
    version=__version__,
    description='Debian package making utility',
    long_description='Debian source package making utility to populate the debian directory.',
    author='Osamu Aoki',
    author_email='osamu@debian.org',
    url='http://people.debian.org/~osamu/',
    packages=[__programname__],
    package_dir={__programname__: __programname__},
    scripts=['scripts/' + __programname__ ],
    data_files=[
        ('share/debmake/extra0', glob.glob('extra0/*')),
        ('share/debmake/extra0desc_long', glob.glob('extra0desc_long/*')),
        ('share/debmake/extra0export', glob.glob('extra0export/*')),
        ('share/debmake/extra0override', glob.glob('extra0override/*')),
        ('share/debmake/extra1', glob.glob('extra1/*')),
        ('share/debmake/extra1patches', glob.glob('extra1patches/*')),
        ('share/debmake/extra1source', glob.glob('extra1source/*')),
        ('share/debmake/extra2bin', glob.glob('extra2bin/*')),
        ('share/debmake/extra2binall', glob.glob('extra2binall/*')),
        ('share/debmake/extra2data', glob.glob('extra2data/*')),
        ('share/debmake/extra2dev', glob.glob('extra2dev/*')),
        ('share/debmake/extra2doc', glob.glob('extra2doc/*')),
        ('share/debmake/extra2lib', glob.glob('extra2lib/*')),
        ('share/debmake/extra2multi', glob.glob('extra2multi/*')),
        ('share/debmake/extra2single', glob.glob('extra2single/*')),
        ('share/debmake/extra3', glob.glob('extra3/*')),
        ('share/debmake/extra4', glob.glob('extra4/*')),
        ('share/doc/debmake', glob.glob('doc/*')),
        ('lib/debmake', glob.glob('desc/*')),
        ],
    classifiers = ['Development Status :: 3 - Alpha',
        'Environment :: Console', 
        'Intended Audience :: Developers', 
        'License :: OSI Approved :: MIT License', 
        'Natural Language :: English',
        'Operating System :: POSIX :: Linux',
        'Programming Language :: Python :: 3',
        'Topic :: Utilities',
    ],
    platforms   = 'POSIX',
    license     = 'MIT License'
)


debmake-4.1.7/extra3/0000775000175000017500000000000012416770056014625 5ustar  osamuosamu00000000000000debmake-4.1.7/extra3/package.emacsen-startup.ex0000664000175000017500000000236112416763277021701 0ustar  osamuosamu00000000000000;; -*-emacs-lisp-*-
;;
;; Emacs startup file, e.g.  /etc/emacs/site-start.d/50@PACKAGE@.el
;; for the Debian @PACKAGE@ package
;;
;; Originally contributed by Nils Naumann 
;; Modified by Dirk Eddelbuettel 
;; Adapted for dh-make by Jim Van Zandt 

;; The @PACKAGE@ package follows the Debian/GNU Linux 'emacsen' policy and
;; byte-compiles its elisp files for each 'emacs flavor' (emacs19,
;; xemacs19, emacs20, xemacs20...).  The compiled code is then
;; installed in a subdirectory of the respective site-lisp directory.
;; We have to add this to the load-path:
(let ((package-dir (concat "/usr/share/"
                           (symbol-name debian-emacs-flavor)
                           "/site-lisp/@PACKAGE@")))
;; If package-dir does not exist, the @PACKAGE@ package must have
;; removed but not purged, and we should skip the setup.
  (when (file-directory-p package-dir)
    (if (fboundp 'debian-pkg-add-load-path-item)
        (debian-pkg-add-load-path-item package-dir)
      (setq load-path (cons package-dir load-path)))
    (autoload '@PACKAGE@-mode "@PACKAGE@-mode"
      "Major mode for editing @PACKAGE@ files." t)
    (add-to-list 'auto-mode-alist '("\\.@PACKAGE@$" . @PACKAGE@-mode))))

debmake-4.1.7/extra3/package.cron.monthly.ex0000664000175000017500000000014312416763277021214 0ustar  osamuosamu00000000000000#!/bin/sh
# Monthly cron jobs shell script for the @PACKAGE@ package
# See dh_installcron(1).
true
debmake-4.1.7/extra3/package.bug-control.ex0000664000175000017500000000032712416763277021021 0ustar  osamuosamu00000000000000# Installed as usr/share/bug/@PACKAGE@/control in @PACKAGE@
# See dh_bugfiles(1) and /usr/share/doc/reportbug/README.developers.gz
# It is the bug control file containing some directions for the bug reporting tool.
debmake-4.1.7/extra3/package.default.ex0000664000175000017500000000036112416763277020210 0ustar  osamuosamu00000000000000# Defaults for @PACKAGE@ initscript
# sourced by /etc/init.d/@PACKAGE@
# installed at /etc/default/@PACKAGE@ by the maintainer scripts

#
# This is a POSIX shell fragment
#

# Additional options that are passed to the Daemon.
DAEMON_OPTS=""
debmake-4.1.7/extra3/manpage.1.ex0000664000175000017500000000371012416763277016742 0ustar  osamuosamu00000000000000.\"                                      Hey, EMACS: -*- nroff -*-
.\" (C) Copyright @YEAR@ @FULLNAME@ <@EMAIL@>,
.\"
.\" See http://www.debian.org/doc/manuals/maint-guide/dother.en.html#manpage1
.\"
.\" 1. Use this as the template for the manpage for  after
.\"    renaming this file to .1 (if it is for section 1).
.\"
.\" 2. List the path to this file in debian/.manpages to
.\"    install this manpage to the target binary package.
.\"
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH @UCPACKAGE@ SECTION "@SHORTDATE@"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp     insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
@PACKAGE@ \- program to do something
.SH SYNOPSIS
.B @PACKAGE@
.RI [ options ] " files" ...
.br
.B bar
.RI [ options ] " files" ...
.SH DESCRIPTION
This manual page documents briefly the
.B @PACKAGE@
and
.B bar
commands.
.PP
.\" TeX users may be more comfortable with the \fB\fP and
.\" \fI\fP escape sequences to invode bold face and italics,
.\" respectively.
\fB@PACKAGE@\fP is a program that...
.SH OPTIONS
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`-').
A summary of options is included below.
For a complete description, see the Info files.
.TP
.B \-h, \-\-help
Show summary of options.
.TP
.B \-v, \-\-version
Show version of program.
.SH SEE ALSO
.BR bar (1),
.BR baz (1).
.br
The programs are documented fully by
.IR "The Rise and Fall of a Fooish Bar" ,
available via the Info system.
debmake-4.1.7/extra3/manpage.sgml.ex0000664000175000017500000001006612416763277017546 0ustar  osamuosamu00000000000000

  
  FIRSTNAME">
  SURNAME">
  
  @SHORTDATE@">
  
  SECTION">
  @EMAIL@">
  
  @UCPACKAGE@">
  

  Debian">
  GNU">
  GPL">
]>


  
    

      &dhemail;
    

    
      &dhfirstname;
      &dhsurname;
    
    
      2003
      &dhusername;
    
    &dhdate;
  
  
    &dhucpackage;

    &dhsection;
  
  
    &dhpackage;

    program to do something
  
  
    
      &dhpackage;

      

      
    
  
  
    DESCRIPTION

    This manual page documents briefly the
      &dhpackage; and bar
      commands.

    This manual page was written for the &debian; distribution
      because the original program does not have a manual page.
      Instead, it has documentation in the &gnu;
      Info format; see below.

    &dhpackage; is a program that...

  
  
    OPTIONS

    These programs follow the usual &gnu; command line syntax,
      with long options starting with two dashes (`-').  A summary of
      options is included below.  For a complete description, see the
      Info files.

    
      
        
          
        
        
          Show summary of options.
        
      
      
        
          
        
        
          Show version of program.
        
      
    
  
  
    SEE ALSO

    bar (1), baz (1).

    The programs are documented fully by The Rise and
      Fall of a Fooish Bar available via the
      Info system.
  
  
    AUTHOR

    This manual page was written by &dhusername; &dhemail; for
      the &debian; system (and may be used by others).  Permission is
      granted to copy, distribute and/or modify this document under
      the terms of the &gnu; General Public License, Version 2 any
      later version published by the Free Software Foundation.
    
    
      On Debian systems, the complete text of the GNU General Public
      License can be found in /usr/share/common-licenses/GPL.
    

  



debmake-4.1.7/extra3/package.cron.d.ex0000664000175000017500000000026112416763277017746 0ustar  osamuosamu00000000000000#
# Regular cron jobs for the @PACKAGE@ package
# See dh_installcron(1) and crontab(5).
#
0 4	* * *	root	[ -x /usr/bin/@PACKAGE@_maintenance ] && /usr/bin/@PACKAGE@_maintenance
debmake-4.1.7/extra3/source.lintian-overrides.ex0000664000175000017500000000013512416763277022126 0ustar  osamuosamu00000000000000# See dh_lintian(1)
# cut and paste the lintian(1) outputs without leading "E: ", "W: ", ...
debmake-4.1.7/extra3/package.cron.hourly.ex0000664000175000017500000000014212416763277021043 0ustar  osamuosamu00000000000000#!/bin/sh
# Hourly cron jobs shell script for the @PACKAGE@ package
# See dh_installcron(1).
true
debmake-4.1.7/extra3/manpage.xml.ex0000664000175000017500000002312512416763277017404 0ustar  osamuosamu00000000000000


  
  
  
  
  
  
  
  
  
  
  
  
]>


  
    &dhtitle;
    &dhpackage;
    
      
       &dhfirstname;
        &dhsurname;
        Wrote this manpage for the Debian system.
        

          &dhemail;
        

      
    
    
      2007
      &dhusername;
    
    
      This manual page was written for the Debian system
        (and may be used by others).
      Permission is granted to copy, distribute and/or modify this
        document under the terms of the GNU General Public License,
        Version 2 or (at your option) any later version published by
        the Free Software Foundation.
      On Debian systems, the complete text of the GNU General Public
        License can be found in
        /usr/share/common-licenses/GPL.
    
  
  
    &dhucpackage;
    &dhsection;
  
  
    &dhpackage;
    program to do something
  
  
    
      &dhpackage;
      
      
      
      
        
          
          
        
        this
      
      
        
          
          
        
        
          this
          that
        
      
    
    
      &dhpackage;
      
      
        
          
            
            
          
        
        
          
            
            
          
        
      
    
  
  
    DESCRIPTION
    This manual page documents briefly the
      &dhpackage; and bar
      commands.
    This manual page was written for the Debian distribution
      because the original program does not have a manual page.
      Instead, it has documentation in the GNU 
        info
        1
       format; see below.
    &dhpackage; is a program that...
  
  
    OPTIONS
    The program follows the usual GNU command line syntax,
      with long options starting with two dashes (`-').  A summary of
      options is included below.  For a complete description, see the
      
        info
        1
       files.
    
      
      
        
        
        
          Does this and that.
        
      
      
        
        
        
          Show summary of options.
        
      
      
        
        
        
          Show version of program.
        
      
    
  
  
    FILES
    
      
        /etc/foo.conf
        
          The system-wide configuration file to control the
            behaviour of &dhpackage;. See
            
              foo.conf
              5
             for further details.
        
      
      
        ${HOME}/.foo.conf
        
          The per-user configuration file to control the
             behaviour of &dhpackage;. See
             
               foo.conf
               5
              for further details.
        
      
    
  
  
    ENVIRONMENT
    
      
        FOO_CONF
        
          If used, the defined file is used as configuration
            file (see also ).
        
      
    
  
  
    DIAGNOSTICS
    The following diagnostics may be issued
      on stderr:
    
      
        Bad configuration file. Exiting.
        
          The configuration file seems to contain a broken configuration
            line. Use the  option, to get more info.
          
        
      
    
    &dhpackage; provides some return codes, that can
      be used in scripts:
    
      Code
      Diagnostic
      
        0
        Program exited successfully.
      
      
        1
        The configuration file seems to be broken.
      
    
  
  
    
    BUGS
    The program is currently limited to only work
      with the foobar library.
    The upstreams BTS can be found
      at .
  
  
    SEE ALSO
    
    
        bar
        1
      , 
        baz
        1
      , 
        foo.conf
        5
      
    The programs are documented fully by The Rise and
      Fall of a Fooish Bar available via the 
        info
        1
       system.
  


debmake-4.1.7/extra3/package.upstrat.ex0000664000175000017500000000020312416763277020261 0ustar  osamuosamu00000000000000#!/bin/sh
# If this exists, it is installed into etc/init/package.conf in the package build directory.
# See *dh_installinit*(1).

debmake-4.1.7/extra3/package.cron.weekly.ex0000664000175000017500000000014212416763277021021 0ustar  osamuosamu00000000000000#!/bin/sh
# Weekly cron jobs shell script for the @PACKAGE@ package
# See dh_installcron(1).
true
debmake-4.1.7/extra3/package.service.ex0000664000175000017500000000020012416763277020214 0ustar  osamuosamu00000000000000#!/bin/sh
# If this exists, it is installed into lib/systemd/system/@PACKAGE@.service in @PACKAGE@
# See dh_systemd_enable(1).

debmake-4.1.7/extra3/package.emacsen-remove.ex0000664000175000017500000000073512416763277021477 0ustar  osamuosamu00000000000000#!/bin/sh -e
# /usr/lib/emacsen-common/packages/remove/@PACKAGE@

FLAVOR=$1
PACKAGE=@PACKAGE@

if [ ${FLAVOR} != emacs ]; then
    if test -x /usr/sbin/install-info-altdir; then
        echo remove/${PACKAGE}: removing Info links for ${FLAVOR}
        install-info-altdir --quiet --remove --dirname=${FLAVOR} /usr/share/info/@PACKAGE@.info.gz
    fi

    echo remove/${PACKAGE}: purging byte-compiled files for ${FLAVOR}
    rm -rf /usr/share/${FLAVOR}/site-lisp/${PACKAGE}
fi
debmake-4.1.7/extra3/manpage.asciidoc.ex0000664000175000017500000000113112416763277020353 0ustar  osamuosamu00000000000000= @UPACKAGE@(1)
:man source:   @UCPACKAGE@
:man version:  @VERREV@
:man manual:   @UCPACKAGE@ Manual

// See "Manpage Documents" in "AsciiDoc User Guide"
// http://www.methods.co.nz/asciidoc/userguide.html

// convert by:
// $ a2x --doctype manpage --format manpage @PACKAGE@.asciidoc

== NAME

@PACKAGE@ - program to do something

== SYNOPSIS

*@PACKAGE@*  [*-h*] ... 


== DESCRIPTION

*@PACKAGE@* do something.

=== optional arguments:

*-h*, *--help*::
    show this help message and exit.


== AUTHOR

Copyright © @YEAR@ @FULLNAME@ <@EMAIL@>

== LICENSE

MIT License

== SEE ALSO

See also ...

debmake-4.1.7/extra3/package.bug-presubj.ex0000664000175000017500000000032612416763277021012 0ustar  osamuosamu00000000000000# Installed as usr/share/bug/@PACKAGE@/presubj in @PACKAGE@
# See dh_bugfiles(1) and /usr/share/doc/reportbug/README.developers.gz
# The contents of this file are displayed to the user by the bug reporting tool.  
debmake-4.1.7/extra3/package.dirs.ex0000664000175000017500000000063012416763277017524 0ustar  osamuosamu00000000000000# See dh_installdirs(1)
# Lists directories to be created in package. (w/o preceding slash)
# Do not bother to list directories here if they are already listed in 
# @PACKAGE@.install etc.
# Any directories which we need but which are not created by the normal 
# installation procedure (make install DESTDIR=... invoked by 
# dh_auto_install). This generally means there is a problem with the 
# Makefile.

debmake-4.1.7/extra3/package.init.ex0000664000175000017500000001054312416763277017532 0ustar  osamuosamu00000000000000#!/bin/sh
### BEGIN INIT INFO
# Provides:          @PACKAGE@
# Required-Start:    $network $local_fs
# Required-Stop:
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: 
# Description:       
#                    <...>
#                    <...>
### END INIT INFO
# See http://wiki.debian.org/LSBInitScripts
#     /usr/share/doc/insserv/README.Debian
#     http://www.debian.org/doc/manuals/maint-guide/dother.en.html#initd

# Author: @FULLNAME@ <@EMAIL@>

# PATH should only include /usr/* if it runs after the mountnfs.sh script
PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC=@PACKAGE@             # Introduce a short description here
NAME=@PACKAGE@             # Introduce the short server's name here
DAEMON=/usr/sbin/@PACKAGE@ # Introduce the server's location here
DAEMON_ARGS=""             # Arguments to run the daemon with
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME

# Exit if the package is not installed
[ -x $DAEMON ] || exit 0

# Read configuration variable file if it is present
[ -r /etc/default/$NAME ] && . /etc/default/$NAME

# Load the VERBOSE setting and other rcS variables
. /lib/init/vars.sh

# Define LSB log_* functions.
# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
. /lib/lsb/init-functions

#
# Function that starts the daemon/service
#
do_start()
{
	# Return
	#   0 if daemon has been started
	#   1 if daemon was already running
	#   2 if daemon could not be started
	start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON --test > /dev/null \
		|| return 1
	start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON -- \
		$DAEMON_ARGS \
		|| return 2
	# Add code here, if necessary, that waits for the process to be ready
	# to handle requests from services started subsequently which depend
	# on this one.  As a last resort, sleep for some time.
}

#
# Function that stops the daemon/service
#
do_stop()
{
	# Return
	#   0 if daemon has been stopped
	#   1 if daemon was already stopped
	#   2 if daemon could not be stopped
	#   other if a failure occurred
	start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
	RETVAL="$?"
	[ "$RETVAL" = 2 ] && return 2
	# Wait for children to finish too if this is a daemon that forks
	# and if the daemon is only ever run from this initscript.
	# If the above conditions are not satisfied then add some other code
	# that waits for the process to drop all resources that could be
	# needed by services started subsequently.  A last resort is to
	# sleep for some time.
	start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
	[ "$?" = 2 ] && return 2
	# Many daemons don't delete their pidfiles when they exit.
	rm -f $PIDFILE
	return "$RETVAL"
}

#
# Function that sends a SIGHUP to the daemon/service
#
do_reload() {
	#
	# If the daemon can reload its configuration without
	# restarting (for example, when it is sent a SIGHUP),
	# then implement that here.
	#
	start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
	return 0
}

case "$1" in
  start)
    [ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC " "$NAME"
    do_start
    case "$?" in
		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
	esac
  ;;
  stop)
	[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
	do_stop
	case "$?" in
		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
	esac
	;;
  status)
       status_of_proc "$DAEMON" "$NAME" && exit 0 || exit $?
       ;;
  #reload|force-reload)
	#
	# If do_reload() is not implemented then leave this commented out
	# and leave 'force-reload' as an alias for 'restart'.
	#
	#log_daemon_msg "Reloading $DESC" "$NAME"
	#do_reload
	#log_end_msg $?
	#;;
  restart|force-reload)
	#
	# If the "reload" option is implemented then remove the
	# 'force-reload' alias
	#
	log_daemon_msg "Restarting $DESC" "$NAME"
	do_stop
	case "$?" in
	  0|1)
		do_start
		case "$?" in
			0) log_end_msg 0 ;;
			1) log_end_msg 1 ;; # Old process is still running
			*) log_end_msg 1 ;; # Failed to start
		esac
		;;
	  *)
	  	# Failed to stop
		log_end_msg 1
		;;
	esac
	;;
  *)
	#echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
	echo "Usage: $SCRIPTNAME {start|stop|status|restart|force-reload}" >&2
	exit 3
	;;
esac

:
debmake-4.1.7/extra3/package.bug-script.ex0000664000175000017500000000040112416763277020636 0ustar  osamuosamu00000000000000# Installed as usr/share/bug/@PACKAGE@ or usr/share/bug/@PACKAGE@/script in @PACKAGE@
# See dh_bugfiles(1) and /usr/share/doc/reportbug/README.developers.gz
# This is the script to be run by the bug reporting program for generating a bug report template.  
debmake-4.1.7/extra3/package.emacsen-install.ex0000664000175000017500000000241012416763277021640 0ustar  osamuosamu00000000000000#! /bin/sh -e
# /usr/lib/emacsen-common/packages/install/@PACKAGE@

# Written by Jim Van Zandt , borrowing heavily
# from the install scripts for gettext by Santiago Vila
#  and octave by Dirk Eddelbuettel .

FLAVOR=$1
PACKAGE=@PACKAGE@

if [ ${FLAVOR} = emacs ]; then exit 0; fi

echo install/${PACKAGE}: Handling install for emacsen flavor ${FLAVOR}

#FLAVORTEST=`echo $FLAVOR | cut -c-6`
#if [ ${FLAVORTEST} = xemacs ] ; then
#    SITEFLAG="-no-site-file"
#else
#    SITEFLAG="--no-site-file"
#fi
FLAGS="${SITEFLAG} -q -batch -l path.el -f batch-byte-compile"

ELDIR=/usr/share/emacs/site-lisp/${PACKAGE}
ELCDIR=/usr/share/${FLAVOR}/site-lisp/${PACKAGE}
ELRELDIR=../../../emacs/site-lisp/${PACKAGE}

# Install-info-altdir does not actually exist.
# Maybe somebody will write it.
if test -x /usr/sbin/install-info-altdir; then
    echo install/${PACKAGE}: install Info links for ${FLAVOR}
    install-info-altdir --quiet --section "" "" --dirname=${FLAVOR} /usr/share/info/${PACKAGE}.info.gz
fi

install -m 755 -d ${ELCDIR}
cd ${ELDIR}
FILES=`echo *.el`
cd ${ELCDIR}
ln -sf ${ELRELDIR}/*.el .

cat << EOF > path.el
(debian-pkg-add-load-path-item ".")
(setq byte-compile-warnings nil)
EOF
${FLAVOR} ${FLAGS} ${FILES}
rm -f path.el

exit 0
debmake-4.1.7/extra3/package.conffiles.ex0000664000175000017500000000075412416763277020542 0ustar  osamuosamu00000000000000# See dh_installdeb(1).
# Files listed in this file are treated as user configuration files by the
# Debian system and will never be overwritten without user consent.
#
# In v3 compatibility mode and higher, all files in the etc/ directory in
# a package will automatically be flagged as conffiles by this program, so
# there is no need to list them manually here.
#
# For most package types, the only place conffiles should ever be is under
# /etc, and so this file doesn’t need to exist.
debmake-4.1.7/extra3/package.cron.daily.ex0000664000175000017500000000014112416763277020622 0ustar  osamuosamu00000000000000#!/bin/sh
# Daily cron jobs shell script for the @PACKAGE@ package
# See dh_installcron(1).
true
debmake-4.1.7/extra3/package.tmpfile.ex0000664000175000017500000000017512416763277020227 0ustar  osamuosamu00000000000000#!/bin/sh
# If this exists, it is installed into usr/lib/tmpfiles.d/@PACKAGE@.conf in @PACKAGE@
# See dh_systemd_enable(1).

debmake-4.1.7/extra3/package.lintian-overrides.ex0000664000175000017500000000024612416763277022224 0ustar  osamuosamu00000000000000# See dh_lintian(1)
#   http://www.debian.org/doc/manuals/maint-guide/dother.en.html#lintian
# cut and paste the lintian(1) outputs without leading "E: ", "W: ", ...
debmake-4.1.7/scripts/0000775000175000017500000000000012416770056015106 5ustar  osamuosamu00000000000000debmake-4.1.7/scripts/debmake0000775000175000017500000000223012416763277016430 0ustar  osamuosamu00000000000000#!/usr/bin/python3
# vim:se tw=0 sts=4 ts=4 et si:
"""
Copyright © 2014 Osamu Aoki

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.
"""

import debmake

if __name__ == '__main__':
    debmake.main()

debmake-4.1.7/extra2multi/0000775000175000017500000000000012416770056015677 5ustar  osamuosamu00000000000000debmake-4.1.7/extra2multi/package.links0000664000175000017500000000007412416763277020344 0ustar  osamuosamu00000000000000### See dh_link(1) (copy to each binary package as needed.)
debmake-4.1.7/extra2multi/clean0000664000175000017500000000002412416763277016707 0ustar  osamuosamu00000000000000### See dh_clean(1)
debmake-4.1.7/extra2multi/package.postrm0000664000175000017500000000176212416763277020555 0ustar  osamuosamu00000000000000#!/bin/sh
set -e
### see: dh_installdeb(1)
###      http://www.debian.org/doc/manuals/maint-guide/dother.en.html#maintscripts
### summary of how this script can be called:
###        *  `remove'
###        *  `purge'
###        *  `upgrade' 
###        *  `failed-upgrade' 
###        *  `abort-install'
###        *  `abort-install' 
###        *  `abort-upgrade' 
###        *  `disappear' 
###          
### for details, see http://www.debian.org/doc/debian-policy/ or
### the debian-policy package

case "$1" in
    purge|remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear)
    ;;

    *)
        echo "postrm called with unknown argument \`$1'" >&2
        exit 1
    ;;
esac

### dh_installdeb will replace this with shell code automatically
### generated by other debhelper scripts.

#DEBHELPER#

exit 0
debmake-4.1.7/extra2multi/package.menu0000664000175000017500000000063012416763277020166 0ustar  osamuosamu00000000000000### Menu template (edit and rename to debian/menu to activate)
### See dh_installmenu(1)
###     /usr/share/doc/menu/html/*
###     http://www.debian.org/doc/manuals/maint-guide/dother.en.html#menu
###
###?package(@PACKAGE@):needs="X11|text|vc|wm" \
###                    section="Applications/see-menu-manual"\
###                    title="@PACKAGE@" \
###                    command="/usr/bin/@PACKAGE@"
debmake-4.1.7/extra2multi/package.prerm0000664000175000017500000000167212416763277020356 0ustar  osamuosamu00000000000000#!/bin/sh
set -e
### see: dh_installdeb(1)
###      http://www.debian.org/doc/manuals/maint-guide/dother.en.html#maintscripts
### summary of how this script can be called:
###        *  `remove'
###        *  `upgrade' 
###        *  `failed-upgrade' 
###        *  `remove' `in-favour'  
###        *  `deconfigure' `in-favour'
###            `removing'
###           
### for details, see http://www.debian.org/doc/debian-policy/ or
### the debian-policy package

case "$1" in
    remove|upgrade|deconfigure)
    ;;

    failed-upgrade)
    ;;

    *)
        echo "prerm called with unknown argument \`$1'" >&2
        exit 1
    ;;
esac

### dh_installdeb will replace this with shell code automatically
### generated by other debhelper scripts.

#DEBHELPER#

exit 0
debmake-4.1.7/extra2multi/package.preinst0000664000175000017500000000136712416763277020716 0ustar  osamuosamu00000000000000#!/bin/sh
set -e
### see: dh_installdeb(1)
###      http://www.debian.org/doc/manuals/maint-guide/dother.en.html#maintscripts
### summary of how this script can be called:
###        *  `install'
###        *  `install' 
###        *  `upgrade' 
###        *  `abort-upgrade' 
### for details, see http://www.debian.org/doc/debian-policy/ or
### the debian-policy package

case "$1" in
    install|upgrade)
    ;;

    abort-upgrade)
    ;;

    *)
        echo "preinst called with unknown argument \`$1'" >&2
        exit 1
    ;;
esac

### dh_installdeb will replace this with shell code automatically
### generated by other debhelper scripts.

#DEBHELPER#

exit 0
debmake-4.1.7/extra2multi/package.postinst0000664000175000017500000000201112416763277021100 0ustar  osamuosamu00000000000000#!/bin/sh
set -e
### see: dh_installdeb(1)
###      http://www.debian.org/doc/manuals/maint-guide/dother.en.html#maintscripts
### summary of how this script can be called:
###        *  `configure' 
###        *  `abort-upgrade' 
###        *  `abort-remove' `in-favour' 
###          
###        *  `abort-remove'
###        *  `abort-deconfigure' `in-favour'
###            `removing'
###           
### for details, see http://www.debian.org/doc/debian-policy/ or
### the debian-policy package

case "$1" in
    configure)
    ;;

    abort-upgrade|abort-remove|abort-deconfigure)
    ;;

    *)
        echo "postinst called with unknown argument \`$1'" >&2
        exit 1
    ;;
esac

### dh_installdeb will replace this with shell code automatically
### generated by other debhelper scripts.

#DEBHELPER#

exit 0
debmake-4.1.7/extra1/0000775000175000017500000000000012416770056014623 5ustar  osamuosamu00000000000000debmake-4.1.7/extra1/README.Debian0000664000175000017500000000031312416763277016670 0ustar  osamuosamu00000000000000@PACKAGE@ for Debian

Please edit this to provide information specific to 
this @PACKAGE@ Debian package.

    (Automatically generated by debmake Version @DEBMAKEVER@)

 -- @FULLNAME@ <@EMAIL@>  @DATE@
debmake-4.1.7/extra1/compat0000664000175000017500000000001112416763277016030 0ustar  osamuosamu00000000000000@COMPAT@
debmake-4.1.7/extra1/watch0000664000175000017500000000326712416763277015673 0ustar  osamuosamu00000000000000### watch control file for uscan
### See uscan(1) for how to set this file properly
###  * uupdate(1) for upgrade a source code package
###  * gbp-import-orig(1) with --uscan for upgrade GIT repo
###
### Uncomment to activate the configuration. Erase unused portions.
### Line continuations are performed with the tailing \\
###
### Many complications around package and version strings can be worked
### around using the "opts=" prefix.  See PER-SITE OPTIONS in uscan(1).
###
### Compulsory line, this is a version 3 file
version=3
###
### Uncomment to examine a Webpage
###  
###http://www.example.com/downloads.php @PACKAGE@-(.*)\.(?:tar.gz|tar.bz2|tar.xz)
###
### Uncomment to examine a Webserver directory
###http://www.example.com/pub/@PACKAGE@-(.*)\.(?:tar.gz|tar.bz2|tar.xz)
###
### Uncommment to examine a FTP server
###ftp://ftp.example.com/pub/@PACKAGE@-(.*)\.(?:tar.gz|tar.bz2|tar.xz) debian uupdate
###
### Uncomment to find new files on SourceForge (via qa.debian.org redirector)
###http://sf.net/@PACKAGE@/@PACKAGE@-src-(.+)\.(?:tar.gz|tar.bz2|tar.xz)
###
### Uncomment to find new files on Google Code
###http://code.google.com/p/@PACKAGE@/downloads/list?can=1 .*/@PACKAGE@-(\d[\d.]*)\.(?:tar.gz|tar.bz2|tar.xz)
###
### Uncomment to find new files on GitHub using the tags page:
###https://github.com//@PACKAGE@/tags .*/(\d[\d\.]*)\.(?:tar.gz|tar.bz2|tar.xz)
###
### Uncomment to use the cryptographic signature in a detached file with
### ".asc" suffix using the "pgpsigurlmangle" option.
### opts=  
###opts=pgpsigurlmangle=s/$/.asc/ http://ftp.example.org/@PACKAGE@/download.html pub/@PACKAGE@-([\d\.]*)\.(?:tar.gz|tar.bz2|tar.xz)
debmake-4.1.7/extra1patches/0000775000175000017500000000000012416770056016173 5ustar  osamuosamu00000000000000debmake-4.1.7/extra1patches/series0000664000175000017500000000044212416763277017417 0ustar  osamuosamu00000000000000### The patch files of the -p1 format included in the debian/patches directory 
### are applied to the upstream source in the order listed below.
### This is manually managed by users with dquilt (quilt(1) wrapper) etc.
### Also this may be updated by dpkg-source(1) when making a package.