[haddock] #72: Wiki-like interface

haddock haddock at projects.haskell.org
Mon Jan 19 03:36:06 EST 2009

#72: Wiki-like interface
Reporter:  waern        |        Owner:       
    Type:  enhancement  |       Status:  new  
Priority:  minor        |    Milestone:  2.6.0
 Version:               |   Resolution:       
Keywords:               |  
Comment (by apfelmus):

 For reference, here the corresponding
 entry] in the Haskell Proposals reddit.

 Concerning the design, I'd use a classic Lens approach

     data Lens a b = Lens { focus :: a -> (b, b -> a) }

     instance Category Lens where ...

 The server side script uses a lens to cut the full source file down to
 haddock only. Changes to the haddock will be mapped to changes to the
 source file which can be recorded as patches. Using lenses to display a
 page can probably be integrated into the wiki engine while haddock is to
 provide the actual lens that maps .hs to documentation.

 For more on lenses, see also [http://www.sandr.dds.nl/FunctionalForms/
 Functional Forms]. They call it "functional references", though. The term
 "lens" comes from the paper [http://www.cis.upenn.edu/~bcpierce/papers
 /dblenses-pods.pdf Relational Lenses].

Ticket URL: <http://trac.haskell.org/haddock/ticket/72#comment:2>
haddock <http://www.haskell.org/haddock>
Haddock, The Haskell Documentation Tool

More information about the Haddock mailing list