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 <[email protected]> Sent: 22 August 2014 18:47 To: Holzenspies, P.K.F. (EWI); [email protected]; [email protected] 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: "[email protected]" <[email protected]> To: [email protected]; [email protected]; [email protected] 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. _______________________________________________ ghc-devs mailing list [email protected] http://www.haskell.org/mailman/listinfo/ghc-devs
