]> git.madduck.net Git - code/vcsh.git/blobdiff - doc/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:

Move docs to doc/
[code/vcsh.git] / doc / PACKAGING.md
diff --git a/doc/PACKAGING.md b/doc/PACKAGING.md
new file mode 100644 (file)
index 0000000..ecbfa55
--- /dev/null
@@ -0,0 +1,44 @@
+# Distributions with readily available packages
+
+## Archlinux
+
+AUR does not require any packaging information within this repository.
+
+## Debian
+
+Debian packages are provided by the author in separate branches, maintained in
+the upstream repository
+
+### Ubuntu
+
+Ubuntu imports Debian's package automagically.
+
+
+## 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
+provided to ease the work of Homebrew packagers:
+
+* The static manpage because Homebrew lacks ronn
+* The tag so GitHub generates tarballs Homebrew can be pointed at
+
+
+# Supporting new distributions
+
+## Your own work
+
+If you are maintaining a package for a different distribution, please get
+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.