]> git.madduck.net Git - code/vcsh.git/blobdiff - PACKAGING.md

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

Introduce static manpage as part of normal repo
[code/vcsh.git] / PACKAGING.md
index b93b17cd351536ee710eff0867c575a3dd667c61..ecbfa55163f10d982b546b21c4484ecf4083fb88 100644 (file)
@@ -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.