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.
