[Hackage] #283: install command doesn't install
dist/doc/users-guide/
Hackage
trac at galois.com
Tue May 27 12:45:57 EDT 2008
#283: install command doesn't install dist/doc/users-guide/
----------------------------------------------+-----------------------------
Reporter: Misha Aizatulin <avatar at hot.ee> | Owner:
Type: defect | Status: new
Priority: normal | Milestone:
Component: Cabal library | Version: HEAD
Severity: normal | Resolution:
Keywords: | Difficulty: very hard (<1 week)
Ghcversion: 6.8.2 | Platform:
----------------------------------------------+-----------------------------
Changes (by duncan):
* difficulty: normal => very hard (<1 week)
Comment:
This is part of the wider issue that Cabal does not handle general docs,
just haddock docs. This is mostly because documentation is almost
completely non-standardised. We know what to do with haddock. For other
kinds of documentation it always seems to need custom scripts.
The Cabal manual is a case in point, it needs docbook. How do we identify
that doc/Cabal.xml is a docbook file? Perhaps we should rename it to
doc/Cabal.docbook. If we can identify that it is docbook how do we process
it portably? Are there any standard processing tools? Currently we have to
use a raw XSLT processor and guess the location of the xslt stylesheet.
Similar issues come up for latex, man pages, raw html, plain text files
etc. We need to be able to identify them and apply standard build rules.
This all works nicely for source files because we use standard
conventions. We'll have to do something similar with documentation.
--
Ticket URL: <http://hackage.haskell.org/trac/hackage/ticket/283#comment:2>
Hackage <http://haskell.org/cabal/>
Hackage: Cabal and related projects
More information about the cabal-devel
mailing list