#283: install command doesn't install dist/doc/users-guide/ ----------------------------------------------+----------------------------- Reporter: Misha Aizatulin <avatar@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