cvs commit: fptools/haddock TODO fptools/haddock/src HaddockDevHelp.hs HaddockHH.hs HaddockHH2.hs HaddockHtml.hs HaddockRename.hs HaddockTypes.hs HaddockUtil.hs Main.hs Map.hs

simonmar    2005/02/02 08:23:04 PST

  Modified files:
    haddock              TODO 
    haddock/src          HaddockDevHelp.hs HaddockHH.hs 
                         HaddockHH2.hs HaddockHtml.hs 
                         HaddockRename.hs HaddockTypes.hs 
                         HaddockUtil.hs Main.hs Map.hs 
  Log:
  Revamp the linking strategy in Haddock.
  
  Now name resolution is done in two phases:
  
   - first resolve everything to original names, like a Haskell compiler
     would.
  
   - then, figure out the "home" location for every entity, and point
     all the links to there.  The home location is the lowest non-hidden
     module in the import hierarchy that documents the entity.  If there
     are multiple candidates, one is chosen at random.
  
  Also:
  
   - Haddock should not generate any HTML with dangling links any more.
     Unlinked references are just rendered as plain text.
  
   - Error reporting is better: if we can't find a link destination for
     an entity reference, we now emit a warning.
  
  Revision  Changes    Path
  1.41      +0 -13     fptools/haddock/TODO
  1.9       +8 -5      fptools/haddock/src/HaddockDevHelp.hs
  1.16      +8 -5      fptools/haddock/src/HaddockHH.hs
  1.16      +8 -5      fptools/haddock/src/HaddockHH2.hs
  1.93      +18 -13    fptools/haddock/src/HaddockHtml.hs
  1.23      +25 -9     fptools/haddock/src/HaddockRename.hs
  1.21      +10 -5     fptools/haddock/src/HaddockTypes.hs
  1.31      +5 -1      fptools/haddock/src/HaddockUtil.hs
  1.81      +293 -203  fptools/haddock/src/Main.hs
  1.6       +2 -2      fptools/haddock/src/Map.hs