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 <howard_b_golden@yahoo.com> 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" <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.