[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