man(8)

✨ man(8) — pkgos.make ✨

okay bestie, buckle up 💖 this is the man(8) page for pkgos.make, and it's literally the little helper script that carries Debian OpenStack maintainers on its back. no cap.

🎀 NAME 🎀

pkgos.make — a helper with useful functions for maintainers. that's it, that's the vibe. 💅

🦋 SYNOPSIS 🦋

pkgos.make

yes queen, no arguments. she just is. ✨

🌸 DESCRIPTION 🌸

so pkgos.make takes the existing .init.in file and uses it to generate the appropriate init script — and it'll spit out a systemd unit too, if those files aren't already there. and honestly? that's not even the whole serve. this make file also contains a bunch of common functions that are genuinely useful for maintainers, and here's every single one, no gatekeeping:

• -gen-init-configurations — this function is the one responsible for generating the init script and the systemd unit. the whole origin story. 👑
• -gen-author-list — generates a list of authors, taken straight from git log. credit where credit is due, periodt.
• -gen-upstream-changelog — generates the changelog file for the debian distribution, also from git log. receipts! 📜
• -get-orig-source — downloads the new upstream tarball by using uscan. fetch, but make it classy.
• -fetch-upstream-remote — downloads the package from the upstream, which lives at https://github.com/openstack/<package_name>. the package_name is determined by the package of the current directory. she knows where she is, iykyk.
• -gen-orig-(xz|gz|bz2) — creates the original tarball by using the (xz|gz|bz2) data compressor. pick your fighter 🫶
• -get-master-branch — creates the master branch. main character energy, literally.
• -get-vcs-source — this one is the pipeline of the functions fetch-upstream-remote, gen-orig-xz, and get-master-branch. a whole combo, a whole routine, she ate. 🔥
• -versioninfo — writes the package version to the versioninfo file. short, sweet, iconic.
• -display-po-stats — displays the number of translated messages for each .po file in debian/po. multilingual slay 🌈
• -call-for-po-trans — this function calls podebconf-report-po with specific parameters. summoning the translators 💜
• -regen-manifest-patch — generates a list of all the files of the package and writes it to the MANIFEST.in. inventory? tracked. 🎀

💫 EXAMPLES 💫

so to call any of the functions up there, you use this next syntax:

./debian/rules <function_name>

that's the whole ritual. go off. ✨

👀 SEE ALSO 👀

• pkgos-gen-systemd-unit(8)
• pkgos-gen-upstart-job(8)
• uscan(1)
• podebconf-report-po(1)
• quilt(1)

the friend group 💖 go read them too.

💀 BUGS 💀

No known bugs. not a single one. she's flawless fr fr (do not test this energy, bestie 😭).

🫶 AUTHOR 🫶

• The script is written by Thomas Goirand <zigo@debian.org>
• The man page is written by Andrii Kroshchenko <akroshchenko@mirantis.com>

version 45.0, dated 02 Jun 2016 — and this was the man(8) page for the pkgos.make package, and that's the whole tea. mwah 💅✨🎀