Dear Howard,
Yes, emphatically so! Any examples should be copy-paste-runnable if reasonably possible without any further switches, so that means the pragmas *should* be included!
Regards,
Philip
________________________________________
From: Howard B. Golden
Sent: 22 August 2014 18:47
To: Holzenspies, P.K.F. (EWI); simonpj@microsoft.com; ghc-devs@haskell.org
Subject: Re: Suggestion for GHC System User's Guide documentation change
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@utwente.nl"
To: simonpj@microsoft.com; howard_b_golden@yahoo.com; ghc-devs@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.
