[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