~ubuntu-branches/ubuntu/oneiric/swig1.3/oneiric

<li><a href="#Warnings_nn4">Enabling extra warnings</a>

<li><a href="#Warnings_symbolic_symbols">Symbolic symbols</a>

<tt>%rename</tt>, <tt>%ignore</tt> and <tt>%feature</tt>, see the 

<a href="Customization.html#features">%feature directive</a> section.  For example, if you wanted to

 

<H2><a name="Warnings_nn4"></a>14.3 Enabling extra warnings</H2>

to provide additional diagnostics.  These warnings can be turned on using the

<tt>-Wextra</tt> option. For example:

% swig -Wextra -python example.i

or in your interface file use either

<p>

You can of course also enable all warnings and suppress a select few, for example:

</p>

 

<div class="shell">

<pre>

% swig -Wextra -w309,452 example.i

</pre>

</div>

 

<p>

The warnings on the right take precedence over the warnings on the left, so in the above example <tt>-Wextra</tt> adds numerous warnings including 452, but then <tt>-w309,452</tt> overrides this and so 452 is suppressesed.

</p>

 

<p>

If you would like all warnings to appear, regardless of the warning filters used, then use the <tt>-Wall</tt> option.

The <tt>-Wall</tt> option also turns on the extra warnings that <tt>-Wextra</tt> adds, however, it is subtely different. 

When <tt>-Wall</tt> is used, it also disables all other warning filters, 

that is, any warnings suppressed or added in <tt>%warnfilter</tt>, <tt>#pragma SWIG nowarn</tt> 

or the <tt>-w</tt> option.

</p>

 

%warn "900:This is your last warning!"

%typemap(in, warning="901:You are really going to regret this") blah * {

<H2><a name="Warnings_symbolic_symbols"></a>14.5 Symbolic symbols</H2>

 

 

<p>

The <tt>swigwarn.swg</tt> file that is installed with SWIG contains symbol constants that could also be

used in <tt>%warnfilter</tt> and <tt>#pragma SWIG nowarn</tt>.

For example this file contains the following line:

</p>

 

<div class="code">

<pre>

%define SWIGWARN_TYPE_UNDEFINED_CLASS 401 %enddef

</pre>

</div>

 

<p>

so <tt>SWIGWARN_TYPE_UNDEFINED_CLASS</tt> could be used instead of 401, for example:

</p>

 

<div class="code">

<pre>

#pragma SWIG nowarn=SWIGWARN_TYPE_UNDEFINED_CLASS

</pre>

</div>

 

<p>

or 

</p>

 

<div class="code">

<pre>

%warnfilter(SWIGWARN_TYPE_UNDEFINED_CLASS) Foo;

</pre>

</div>

 

<H2><a name="Warnings_nn6"></a>14.6 Commentary</H2>

advanced users and is not recommended in normal use.  You are advised

to modify your interface to fix the problems highlighted by the warnings

wherever possible instead of suppressing warnings.

<H2><a name="Warnings_nn7"></a>14.7 Warnings as errors</H2>

<H2><a name="Warnings_nn8"></a>14.8 Message output format</H2>

<H2><a name="Warnings_nn9"></a>14.9 Warning number reference</H2>

 

 

<H3><a name="Warnings_nn10"></a>14.9.1 Deprecated features (100-199)</H3>

<H3><a name="Warnings_nn11"></a>14.9.2 Preprocessor (200-299)</H3>

<H3><a name="Warnings_nn12"></a>14.9.3 C/C++ Parser (300-399)</H3>

<H3><a name="Warnings_nn13"></a>14.9.4 Types and typemaps (400-499) </H3>

<H3><a name="Warnings_nn14"></a>14.9.5 Code generation (500-599)</H3>

<li>519. %template() contains no name. Template method ignored: <em>declaration</em>

<H3><a name="Warnings_nn15"></a>14.9.6 Language module specific (800-899) </H3>

<H3><a name="Warnings_nn16"></a>14.9.7 User defined (900-999)</H3>

<H2><a name="Warnings_nn17"></a>14.10 History</H2>