[Haskell] Cabal, Haddock, and the location of documentation

2007-07-08 Thread Matthias Kilian
Hi,

probably a PEBCAK, but working on updating all our Haskell-related
OpenBSD ports, I've currently the problem, that, e.g. for Crypto
the Haddock-generated documentation doesn't gets installed where I
want it installed ;-)

The default obviously is something like $prefix/share/Crypto-$VERSION/doc/html,
but I want $prefix/share/doc/Crypto-$VERSION, or, even preferrable, just
$prefix/share/doc/Crypto. That's:

- $prefix/share/doc as base directory for all documentation, since
  that's the default on OpenBSD.

- no html subdirectory if not strictly necessary, because I don't like a
  doc directory containing nothing but a html directory.

- no version number in the directory name, because typically we don't
  have different versions of the same software installed at the
  same time -- there are exceptions from this rule, but I really
  don't plan to start maintaining several versions of one ore more
  Haskell packages ;-)

Is this configurable at Cabal/Haddock runtime? I'd try to play
with --datadir, but this appears a little bit dangerous as a general
approach, since some packages my actually come with real data, which
should *not* go into $prefix/share/doc, of course.

Or do I have to patch Cabal? If so, what about adding just another
FilePath like docdir to Distribution.SimpleLocalBuildInfo and use
it for the documentation?

Ciao,
Kili
___
Haskell mailing list
Haskell@haskell.org
http://www.haskell.org/mailman/listinfo/haskell


Re: [Haskell] Cabal, Haddock, and the location of documentation

2007-07-08 Thread Duncan Coutts
Moving discussion to the [EMAIL PROTECTED] list...

On Sun, 2007-07-08 at 19:08 +0200, Matthias Kilian wrote:
 Hi,
 
 probably a PEBCAK, but working on updating all our Haskell-related
 OpenBSD ports, I've currently the problem, that, e.g. for Crypto
 the Haddock-generated documentation doesn't gets installed where I
 want it installed ;-)

[...]

 Is this configurable at Cabal/Haddock runtime? I'd try to play
 with --datadir, but this appears a little bit dangerous as a general
 approach, since some packages my actually come with real data, which
 should *not* go into $prefix/share/doc, of course.

Currently the docs do just use --datadir= and --datasubdir= .

 Or do I have to patch Cabal? If so, what about adding just another
 FilePath like docdir to Distribution.SimpleLocalBuildInfo and use
 it for the documentation?

I think it'd be perfectly reasonable to follow the lead of autoconf here
and have slightly finer grained control with respect to the kinds of
files we're installing. Autoconf distinguishes docs (and various kinds
of docs, html, ps, pdf, man etc) from the generic datadir.

So yes, if you want to extend cabal in this direction I'm happy to
review patches.

Duncan

___
Haskell mailing list
Haskell@haskell.org
http://www.haskell.org/mailman/listinfo/haskell


Re: [Haskell] Cabal, Haddock, and the location of documentation

2007-07-08 Thread Ian Lynagh
On Sun, Jul 08, 2007 at 06:22:43PM +0100, Duncan Coutts wrote:
 
 On Sun, 2007-07-08 at 19:08 +0200, Matthias Kilian wrote:
  
  Or do I have to patch Cabal? If so, what about adding just another
  FilePath like docdir to Distribution.SimpleLocalBuildInfo and use
  it for the documentation?
 
 I think it'd be perfectly reasonable to follow the lead of autoconf here
 and have slightly finer grained control with respect to the kinds of
 files we're installing. Autoconf distinguishes docs (and various kinds
 of docs, html, ps, pdf, man etc) from the generic datadir.

See also:
http://hackage.haskell.org/trac/hackage/ticket/140

It would be great for this to get fixed, as I currently have to jump
through some hoops to get the docs where I want them in the Debian
packages.


Thanks
Ian

___
Haskell mailing list
Haskell@haskell.org
http://www.haskell.org/mailman/listinfo/haskell