re-organized headings and links for better semantic organization and use
Adding more packaging types / formats
|Deletions are marked like this.||Additions are marked like this.|
|Line 57:||Line 57:|
| * [[Python/Packaging|Python]] - applications
* [[Fonts/PackagingPolicy|Font]] - packages
* [[RPM]] - converting a .RPM into .DEB
| * [[AndroidTools]] - android tools
* [[Fonts/PackagingPolicy|Fonts]] - packages
* [[http://pkg-go.alioth.debian.org/packaging.html|Go]] - libraries and applications
* [[http://pkg-haskell.alioth.debian.org/haskell-policy/|Haskell]] - libraries (outdated, updating is listed as TODO item on [[Haskell]])
* [[Java/Packaging|Java]] - libraries and applications
* [[http://pkg-lua.alioth.debian.org/policy.html|Lua]] - modules
* [[Teams/DebianMonoGroup/NewPackage|Mono]] - libraries and applications
* [[Teams/DebianMozExtTeam#Common_practices|Mozilla Extensions]] - XUL extensions
* [[http://pkg-ocaml-maint.alioth.debian.org/ocaml_packaging_policy.html/index.html|OCaml]] - libraries
* [[Python/Packaging|Python]] - modules and applications
* [[Teams/Ruby/Packaging|Ruby]] - modules and applications
* [[RPM]] - repackaging RPM packages as .deb packages
When you seriously think about packaging as a newcomer to Debian, please read the official documentation:
Whether you want
- to install some programs or data on several computers
- to have consistent and deterministic versioning
- the packaging system to take care of updates
to help the Debian project. (see Work-Needing and Prospective Packages)
What is a "package"?
There are two kinds of packages: "binary" (.deb) and "source" (.dsc) packages. There are tools (e.g. cpack) that are able to generate "binary" packages but such packaging is ad-hoc (build-system specific) and fragile. Such packages are more likely to fail to operate when the target system diverges from the original environment they were built in.
"source" packages in turn can be built to produce "binary" packages on any other machine and architecture. In a standardized, language and underlying build-system (make vs cmake) agnostic form they provide all the necessary information about build and run-time dependencies and conflicts, a standardized description of copyright and license information, an initial configuration, etc. That is why "binary" packages alone, without the "source" packages originating them, can not be submitted for inclusion into an official Debian distribution.
Therefore Packaging in the Debian world is primarily concerned with "source" packages. "binary" packages are just a product of such work.
Introduction to Debian Packaging
To get a good grounding in Debian packaging:
first read the excellent introduction to Debian Packaging to build a package from scratch,
you can also look at the building tutorial to apply changes to an existing package.
Now that you have seen the basics, it is highly recommended that you read some real stuff:
the Debian New Maintainers' Guide describes the building of a Debian package to ordinary Debian users.
the Debian Policy includes technical requirements that each package must satisfy.
Then, if you are looking for answers, you can come back here or read:
the interesting pdf file included in the package packaging-tutorial.
The Developers Reference provides an overview of the recommended procedures and the available resources for Debian developers.
What not to do:
There are no shortcuts to learning good packaging practices. Avoid equivs which is only useful for building trivial metapackages and does not teach you anything about packaging.
Types / Formats
AndroidTools - android tools
Fonts - packages
Go - libraries and applications
Java - libraries and applications
Lua - modules
Mono - libraries and applications
Mozilla Extensions - XUL extensions
OCaml - libraries
Python - modules and applications
Ruby - modules and applications
RPM - repackaging RPM packages as .deb packages
Quilt - patch management
Darcs - version control
Git - version control
Pbuilder - build tool
Secure Pbuilder - builder tool
?Adding and removing diversions
?How to split a package into smaller packages
Repackage_srcrpm - creating a proper Debian source package while referencing the src.rpm package
Creating package without some particular architectures - for easy porting
DEX - improving Debian and its derivatives through cross-community teamwork
From Debian Women
External useful links
http://www.debian.org/doc/manuals/apt-howto/ and package apt-howto
http://www.debian.org/devel/wnpp/prospective - requested packages, and packages being worked on.
What's in a debian/ directory - detailed worked example
http://www-128.ibm.com/developerworks/linux/library/l-debpkg.html : creating debian packages - high-level description of debian packaging .
http://www.debian-administration.org/articles/336 Rolling your own debian packages.
Autobuilding non-free packages: http://article.gmane.org/gmane.linux.debian.devel.announce/997
PackageConfigUpgrade : propose a new way to smoothly handle configuration upgrades during package upgrades