[Hackage] #588: requiring '.' for blank lines is annoying

Hackage trac at galois.com
Sat Sep 19 18:27:10 EDT 2009


#588: requiring '.' for blank lines is annoying
----------------------------+-----------------------------------------------
  Reporter:  Jake Wheat     |        Owner:           
      Type:  defect         |       Status:  closed   
  Priority:  low            |    Milestone:           
 Component:  Cabal library  |      Version:  1.6.0.2  
  Severity:  minor          |   Resolution:  duplicate
  Keywords:                 |   Difficulty:  unknown  
Ghcversion:                 |     Platform:           
----------------------------+-----------------------------------------------
Comment (by guest):

 Yes I missed that text, my mistake.

 I did check a few packages on hackage db before reporting and somehow
 managed to only find ones where the package author had made the same
 mistake as me, looking again I can see most uploaders got this right.

 Since a few others have also made this mistake, could I suggest adding a
 sentence to description property, something like:

 For library packages, this field is used as prologue text by setup haddock
 (see the section called “setup haddock”), and thus may contain the same
 markup as haddock documentation comments (you need to use an indented '.'
 to get a blank line in the markup passed to haddock, as noted above).

-- 
Ticket URL: <http://hackage.haskell.org/trac/hackage/ticket/588#comment:3>
Hackage <http://haskell.org/cabal/>
Hackage: Cabal and related projects


More information about the cabal-devel mailing list