GitLab

I have taken the liberty of rejigging the build system somewhat, so that
we can auto-generate the PDF/HTML version of the Language Report every
time a patch is checked into darcs.

Modified the syntax again to talk about "guards" (which are pattern guards,
boolean guards, and let expressions) .  Moved the "Pattern guards" section
I created before into the Case Expressions section.

This is a very rough draft in order to get some discussion going, and
does not touch the semantic explanations, which will still need to be
done.

See LineCommentSyntax on the wiki, ticket #42

intervals, not open intervals.

(Also tidy source to 80-column width.)

(12:10:13) Marvin--: SyntaxLaptop: the example Setup.lhs on page 3 is wrong, it should import defaultMain and set main = defaultMain
(12:10:46) Marvin--: SyntaxLaptop: and I think we call it sdist, not src-dist?
(12:20:38) Marvin--: SyntaxLaptop:  \"funky, path\\\\name\"   is really broken, it should be  "funky, path\\name"
(12:20:47) Marvin--: the escapes comes from being in a haskell string in the module! :)

(12:22:10) Marvin--: hmm, now I think I remember what the issue with the dashes was
(12:23:08) Marvin--: oh, and it should be documented exactly what paths look like
(12:23:43) Marvin--: page 18 says import Distribution.Make (setup), that damn well should be defaultMain too ;-)
(13:14:15) igloo: Oh, Marvin, am I being dopey or does the new spec not answer my questions about eh example at the start?
(13:14:37) igloo: e.g. how does it know which files are part of the package

* updated test case for package description file.
* Added note about chasing dependencies and "modules" field:
   Note that in the future, though the Modules field will be
   available, it will not be necessary to provide it for building
   executables and libraries.  Instead, the user will provide only the
   "Main-Is" field (for executables) and the "Exposed-Modules" field
   (for libraries).  The system will chase down dependencies from
   those modules and include them in the library or source
   distributions.

FIX/TODO: Provide BNF-type grammar, especially for field contents,
remove below checklist and questions, fix package filename.

Added example package description and more syntax.  Please
double-check.

** Peter Packager, as an umbrella for Rowland et al
** Isabella Installer, as someone who uses Peter's packages

* Added some notes on the personas to clarify against the perception
  that they are non-overlapping roles.

* Added a little "layered tools" section, just to get this on record.

* Some reformatting