Re: [Refdb-devel] Docs in split packages

[Markus H. <mar...@mh...>]

Hi David,

David Nebauer writes:
 > I've just built a version of refdb using 'disable-server' and 
 > 'disable-clients' to see if I could produce a document-only install that 
 > might form the basis of a debian package.  I note one major and one 
 > minor problem.  The minor first: the install includes the file 
 > 'refdb-manual.fo'.  It is over 3 MB in size and not needed as the pdf 
 > version installs also.
 > 

That's a bummer. I guess this was a backfiring attempt to force the
.fo file into the package to silence make. I've fixed that.

 > The major problem is the man pages build as part of the documentation 
 > and not alongside the client or server.  I quite understand why you 
 > designed it this way.  Unfortunately, it violates an inflexible Debian 
 > rule that any executable installing to one of the recognised bin 
 > directories MUST have an accompanying man page.  If you could alter the 
 > man page build such that their inclusion depends on the 
 > 'disable-[clients|server]' flags (and ditch 'refdb-manual.fo') it would 
 > be quite simple to build a 'refdb-doc' package alongside 'refdb-clients' 
 > and 'refdb-server'.
 > 

I tried to implement this suggestion. You should now be able to build
three packages:

--disable-clients --disable-docs (server package)
--disable-server --disable-docs (client package)
--disable-server --disable-clients (doc package)

Both the client and the server builds should be accompanied by their
respective man pages. Let me know if I got something wrong here.

regards,
Markus

-- 
Markus Hoenicka
mar...@ca...
(Spam-protected email: replace the quadrupeds with "mhoenicka")
http://www.mhoenicka.de