#493: counterintuitive syntax of .cabal/config file ---------------------------------+------------------------------------------ Reporter: guest | Owner: Type: defect | Status: new Priority: normal | Milestone: Component: cabal-install tool | Version: 1.6.0.1 Severity: normal | Resolution: Keywords: | Difficulty: unknown Ghcversion: | Platform: ---------------------------------+------------------------------------------ Comment (by duncan): Right, `--` is a comment, but like `.cabal` files, the syntax uses layout, so indentation is significant. Indentation is used to indicate nested sections. Would having an explanation at the top be enough? We can say that `--` lines are comments, that indentation is significant and that the commented out fields give default values, if any. We may also be able to get the parser to produce more helpful messages in some cases. However in general there can be fields that have multi-line nested content. -- Ticket URL: http://hackage.haskell.org/trac/hackage/ticket/493#comment:1 Hackage http://haskell.org/cabal/ Hackage: Cabal and related projects