Ticket #588 (closed defect: duplicate)
requiring '.' for blank lines is annoying
|Reported by:||Jake Wheat||Owned by:|
Description (last modified by guest) (diff)
The cabal documentation on this page:
contains this under the documentation for the description property: '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.'
But when I try to use e.g. paragraphs in this field, it appears as though the whitespace gets stripped out and so the paragraphs don't appear and all the text gets shoved together.
Example from my cabal file:
Description: Sql parser, pretty printer and type checker, targets PostGreSQL SQL and PL/pgSQL, uses Parsec and UUAGC.
'Parser' for converting text to asts;
'PrettyPrinter?' for converting asts to text;
this results in:
Sql parser, pretty printer and type checker, targets PostGreSQL SQL and PL/pgSQL, uses Parsec and UUAGC. Overview: see the module Database.HsSqlPpp?.TypeChecking?.Ast for the ast types; Parser for converting text to asts; PrettyPrinter? for converting asts to text;<snip>
coming out in the haddock docs and on hackagedb - all the newlines are missing. When I copy this text to a separate file an invoke haddock -p, the documentation comes out with the paragraphs correctly, so I'm guessing this is something cabal is doing to the description property before passing it to haddock.
full cabal file here: http://hackage.haskell.org/packages/archive/hssqlppp/0.0.6/hssqlppp.cabal scrunched text viewable here: http://hackage.haskell.org/package/hssqlppp