[commit: ghc] master: Document the -fwarn-unsupported-calling-conventions flag (80a9f2f)

[Ian Lynagh]

Repository : ssh://darcs.haskell.org//srv/darcs/ghc

On branch  : master

http://hackage.haskell.org/trac/ghc/changeset/80a9f2f5a540efc045f8f352ec19329e5ecc8cfd

>---------------------------------------------------------------

commit 80a9f2f5a540efc045f8f352ec19329e5ecc8cfd
Author: Ian Lynagh <igloo at earth.li>
Date:   Thu Apr 26 21:49:46 2012 +0100

    Document the -fwarn-unsupported-calling-conventions flag

>---------------------------------------------------------------

 docs/users_guide/using.xml |   16 +++++++++++++++-
 1 files changed, 15 insertions(+), 1 deletions(-)

diff --git a/docs/users_guide/using.xml b/docs/users_guide/using.xml
index f9cbeb1..b01fa7e 100644
--- a/docs/users_guide/using.xml
+++ b/docs/users_guide/using.xml
@@ -954,7 +954,8 @@ test.hs:(5,4)-(6,7):
     <option>-fwarn-missing-fields</option>,
     <option>-fwarn-missing-methods</option>,
     <option>-fwarn-lazy-unlifted-bindings</option>,
-    <option>-fwarn-wrong-do-bind</option>, and
+    <option>-fwarn-wrong-do-bind</option>,
+    <option>-fwarn-unsupported-calling-conventions</option>, and
     <option>-fwarn-dodgy-foreign-imports</option>.  The following
     flags are
     simple ways to select standard &ldquo;packages&rdquo; of warnings:
@@ -1103,6 +1104,19 @@ test.hs:(5,4)-(6,7):
       </varlistentry>
 
       <varlistentry>
+        <term><option>-fwarn-unsupported-calling-conventions</option>:</term>
+        <listitem>
+          <indexterm><primary><option>-fwarn-unsupported-calling-conventions</option></primary>
+          </indexterm>
+          <para>Causes a warning to be emitted for foreign declarations
+          that use unsupported calling conventions. In particular,
+          if the <literal>stdcall</literal> calling convention is used
+          on an architecture other than i386 then it will be treated
+          as <literal>ccall</literal>.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
         <term><option>-fwarn-dodgy-foreign-imports</option>:</term>
         <listitem>
           <indexterm><primary><option>-fwarn-dodgy-foreign-imports</option></primary>