PACKAGING.md: Major rewrite

diff --git a/PACKAGING.md b/PACKAGING.md
index b93b17cd351536ee710eff0867c575a3dd667c61..ecbfa55163f10d982b546b21c4484ecf4083fb88 100644 (file)
--- a/PACKAGING.md
+++ b/PACKAGING.md
@@ -1,37 +1,44 @@
-# Archlinux
+# Distributions with readily available packages
+
+## Archlinux

 
 AUR does not require any packaging information within this repository.
 
 
 AUR does not require any packaging information within this repository.
 

-# Debian
+## Debian

 
 Debian packages are provided by the author in separate branches, maintained in
 the upstream repository
 
 
 Debian packages are provided by the author in separate branches, maintained in
 the upstream repository
 

-## Ubuntu
+### Ubuntu

 
 Ubuntu imports Debian's package automagically.
 
 
 
 Ubuntu imports Debian's package automagically.
 
 

-# Mac OS X
+## Mac OS X / Homebrew

 
 Homebrew does not require any packaging information within this repository.
 A separate branch with a statically compiled manpage and release tags is
 
 Homebrew does not require any packaging information within this repository.
 A separate branch with a statically compiled manpage and release tags is

-provided to ease packaging. The static manpage because Homebrew lacks ronn;
-the tag so github generates tarballs Homebrew can be pointed at.
-
+provided to ease the work of Homebrew packagers:

 
 

-# Additional notes
+* The static manpage because Homebrew lacks ronn
+* The tag so GitHub generates tarballs Homebrew can be pointed at

 
 

-## Static manpage

 
 

-In case you can not build the manpage because you are missing ronn please
-contact the author. The "debian-squeeze" branch carries a quilt patchset with
-a pre-compiled manpage and the "homebrew" one carries a static manpage. If you
-need, or want, to build your packages against a static version in your own
-branch this can be done.
+# Supporting new distributions

 
 

-## Other systems
+## Your own work

 
 If you are maintaining a package for a different distribution, please get
 
 If you are maintaining a package for a different distribution, please get

-in touch so your work can be included in another branch, thus allowing others
-to adapt it to their needs or to improve upon it.
+in touch so your work can be included in a packaging branch in the upstream
+repository.
+This allows others to adapt your work for their own distributions or
+packaging needs.
+
+## Static manpage
+
+The "debian-squeeze" branch carries a quilt patchset with a pre-compiled
+manpage and the "homebrew" one carries a static manpage.
+
+In case you can not build the manpage because you are missing ronn or you
+prefer a precompiled manpage for another reason, please contact us; we will
+gladly provide up-to-date packages with every release.