[Build-common-hackers] cdbs and man pages

Russell Coker russell@coker.com.au
Wed, 4 Feb 2004 17:18:47 +1100


On Sat, 17 Jan 2004 01:50, Jeff Bailey <jbailey@nisa.net> wrote:
> On Thu, 2004-01-15 at 23:04, Russell Coker wrote:
> > With cdbs based packages how do I get a man page to have several aliases
> > (IE "man foo" and "man bar" both give the foo(3) man page)?
>
> manpage installation is handled with dh_installman (assuming you're
> using debhelper.  So far, everyone has been).  The trick is to use the
> .so hack in dh_installman to get it to generate the symlink for you.
>
> Let's say I have two programs, ls, and ll.  ll is just a mode on ls.  So
> I create two files like so:
>
> -rw-r--r--    1 jbailey  jbailey        18 2004-01-16 09:40 ll.1
> -rw-r--r--    1 jbailey  jbailey      6450 2004-01-16 09:32 ls.1
>
> $ cat ll.1
> ll.1.so man1/ls.1

Below is my debian/rules, a fairly default thing for cdbs.  It doesn't seem to 
work with files such as you suggest.

#!/usr/bin/make -f

binary/selinux-utils:: binary/libselinux1
binary/libselinux1:: binary/libselinux1-dev

include /usr/share/cdbs/1/rules/debhelper.mk
include /usr/share/cdbs/1/rules/simple-patchsys.mk
include /usr/share/cdbs/1/class/makefile.mk

DEB_MAKE_INSTALL_TARGET := install DESTDIR=$(DEB_DESTDIR)
DEB_MAKE_CHECK_TARGET :=

DEB_SHLIBDEPS_INCLUDE_selinux-utils := debian/libselinux1/usr/lib/
DEB_DH_MAKESHLIBS_ARGS_ALL := -V

Here's what I am attempting:

cat man/freeconary.3
freeconary.3.so man3/freecon.3

I get freeconary.3.gz which contains a compressed copy of the above text.

-- 
http://www.coker.com.au/selinux/   My NSA Security Enhanced Linux packages
http://www.coker.com.au/bonnie++/  Bonnie++ hard drive benchmark
http://www.coker.com.au/postal/    Postal SMTP/POP benchmark
http://www.coker.com.au/~russell/  My home page