[[project @ 2005-10-25 12:56:50 by simonmar]
simonmar**20051025125650
 doc LANGUAGE pragma
] {
hunk ./ghc/docs/users_guide/glasgow_exts.xml 4641
+    <sect2 id="language-pragma">
+      <title>LANGUAGE pragma</title>
+
+      <indexterm><primary>LANGUAGE</primary><secondary>pragma</secondary></indexterm>
+      <indexterm><primary>pragma</primary><secondary>LANGUAGE</secondary></indexterm>
+
+      <para>This allows language extensions to be enabled in a portable way.
+	It is the intention that all Haskell compilers support the
+	<literal>LANGUAGE</literal> pragma with the same syntax, although not
+	all extensions are supported by all compilers, of
+	course.  The <literal>LANGUAGE</literal> pragma should be used instead
+	of <literal>OPTIONS_GHC</literal>, if possible.</para>
+
+      <para>For example, to enable the FFI and preprocessing with CPP:</para>
+
+<programlisting>{-# LANGUAGE ForeignFunctionInterface, CPP #-}</programlisting>
+
+      <para>Any extension from the <literal>Extension</literal> type defined in
+	<ulink
+	  url="../libraries/Cabal/Language-Haskell-Extension.html"><literal>Language.Haskell.Extension</literal></ulink> may be used.  GHC will report an error if any of the requested extensions are not supported.</para>
+    </sect2>
+
+
hunk ./ghc/docs/users_guide/glasgow_exts.xml 4674
-<programlisting>
-{-# LINE 42 "Foo.vhs" #-}
-</programlisting>
+<programlisting>{-# LINE 42 "Foo.vhs" #-}</programlisting>
}