Suggestion for GHC System User's Guide documentation change

[Howard B. Golden]

p.k.f.,

I like your less verbose suggestion better than my original.

I don't understand your comment about code examples: Are you supporting or opposing the inclusion of the LANGUAGE pragmas in the examples?

Howard

________________________________
From: "p.k.f.holzenspies at utwente.nl" <p.k.f.holzenspies at utwente.nl>
To: simonpj at microsoft.com; howard_b_golden at yahoo.com; ghc-devs at haskell.org 
Sent: Friday, August 22, 2014 5:38 AM
Subject: RE: Suggestion for GHC System User's Guide documentation change



Marginally less verbose; why not use the language extension *only* in running text? Preferably with a link to the documentation of that language extension. In your example:


| The language extension <ref>UnicodeSyntax</ref> enables Unicode characters to be
| used to stand for certain ASCII character sequences.​


With regards to code examples: Ideally any explicit code example could just be copy-pasted into a .hs-file and loaded into ghci / compiled with ghc without special switches.


Just my two cents ;)


Ph.