diff options
| -rw-r--r-- | Makefile | 12 | ||||
| -rw-r--r-- | doc/install.mdwn | 22 |
2 files changed, 30 insertions, 4 deletions
@@ -47,17 +47,21 @@ git-annex-shell.1: doc/git-annex-shell.mdwn git-union-merge.1: doc/git-union-merge.mdwn ./mdwn2man git-union-merge 1 doc/git-union-merge.mdwn > git-union-merge.1 -install: all - install -d $(DESTDIR)$(PREFIX)/bin - install $(bins) $(DESTDIR)$(PREFIX)/bin - ln -sf git-annex $(DESTDIR)$(PREFIX)/bin/git-annex-shell +install-mans: $(mans) install -d $(DESTDIR)$(PREFIX)/share/man/man1 install -m 0644 $(mans) $(DESTDIR)$(PREFIX)/share/man/man1 + +install-docs: docs install-mans install -d $(DESTDIR)$(PREFIX)/share/doc/git-annex if [ -d html ]; then \ rsync -a --delete html/ $(DESTDIR)$(PREFIX)/share/doc/git-annex/html/; \ fi +install: all install-docs + install -d $(DESTDIR)$(PREFIX)/bin + install $(bins) $(DESTDIR)$(PREFIX)/bin + ln -sf git-annex $(DESTDIR)$(PREFIX)/bin/git-annex-shell + test: @if ! $(GHCMAKE) -O0 test $(clibs); then \ echo "** failed to build the test suite" >&2; \ diff --git a/doc/install.mdwn b/doc/install.mdwn index fe0522aa0..1f4b54f54 100644 --- a/doc/install.mdwn +++ b/doc/install.mdwn @@ -20,6 +20,28 @@ As a haskell package, git-annex can be installed using cabal. For example: The above downloads the latest release. Alternatively, you can [[download]] it yourself and [[manually_build_with_cabal|install/cabal]]. +### Man pages + +Cabal does not install the man pages. Do: + + cd /tmp + cabal unpack git-annex + cd git-annex* + make install-mans PREFIX=~/.cabal + +to install man pages under ~/.cabal/share/man (or $PREFIX/share/man +generally). If ~/.cabal/bin is on your PATH, and you're on a Debian +derivative, you're probably set. + +On Debian systems, `manpath` will print the paths searched for manual +pages. The paths searched are inferred from your PATH. Experiments +indicate that, on Ubuntu, D/share/man will be searched for manual +pages whenever D/bin is on your PATH. So, having ~/.cabal/bin on your +PATH is enough to make the above example work. The `man manpath` does +not document this, but see +http://linux.derkeiler.com/Mailing-Lists/Debian/2003-08/0956.html for +some other special cases. + ## Installation by hand To build and use git-annex, you will need: |