diff options
author | William S Fulton <wsf@fultondesigns.co.uk> | 2013-01-19 00:58:56 +0000 |
---|---|---|
committer | William S Fulton <wsf@fultondesigns.co.uk> | 2013-01-19 00:58:56 +0000 |
commit | bd3e93ae61fb74d5a338eac884c1e61eb64d6234 (patch) | |
tree | b16243deb2fb99a926f7e437d73fa27aef7f3c68 /Doc/Manual | |
parent | 36ce54da8d46b340947940c202dd87a343153b63 (diff) | |
download | swig-bd3e93ae61fb74d5a338eac884c1e61eb64d6234.tar.gz |
Tidy up last few commits for Java new jniclasspackage pragma
Diffstat (limited to 'Doc/Manual')
-rw-r--r-- | Doc/Manual/Java.html | 16 | ||||
-rw-r--r-- | Doc/Manual/Warnings.html | 2 |
2 files changed, 17 insertions, 1 deletions
diff --git a/Doc/Manual/Java.html b/Doc/Manual/Java.html index e8777fbe3..8245d46eb 100644 --- a/Doc/Manual/Java.html +++ b/Doc/Manual/Java.html @@ -1924,7 +1924,21 @@ Note that it only works for classes, structs, unions and enums declared within a When the nspace feature is used, the C++ namespaces are converted into Java packages of the same name. Proxy classes are thus declared within a package and this proxy makes numerous calls to the JNI intermediary class which is declared in the unnamed package by default. As Java does not support types declared in a named package accessing types declared in an unnamed package, the <tt>-package</tt> commandline option described earlier generally should be used to provide a parent package. -So if SWIG is run using the <tt>-package com.myco</tt> option, a wrapped class, <tt>MyWorld::Material::Color</tt>, can then be accessed as <tt>com.myco.MyWorld.Material.Color</tt>. If you don't specify a package, you will get a warning 186. If it is undesirable to have a single top level package, the nspace feature may be used without the <tt>-package<tt> commandline option (and the resulting warning ignored) if all of the types exposed using Swig are placed in a package using the nspace feature and the jniclasspackage pragma is used to specify a package for the JNI intermediate class. +So if SWIG is run using the <tt>-package com.myco</tt> option, a wrapped class, <tt>MyWorld::Material::Color</tt>, can then be accessed as <tt>com.myco.MyWorld.Material.Color</tt>. +If you don't specify a package, you will get the following warning: +</p> + +<div class="shell"> +<pre> +example.i:16: Warning 826: The nspace feature is used on 'MyWorld::Material::Color' without -package. The generated code +may not compile as Java does not support types declared in a named package accessing types declared in an unnamed package. +</pre> +</div> + +<p> +If it is undesirable to have a single top level package, the nspace feature may be used without the <tt>-package</tt> commandline option +(and the resulting warning ignored) if all of the types exposed using SWIG are placed in a package using the nspace feature and the +'jniclasspackage' pragma is used to specify a package for the JNI intermediary class. </p> <p> diff --git a/Doc/Manual/Warnings.html b/Doc/Manual/Warnings.html index 2a3ce560d..1571146f1 100644 --- a/Doc/Manual/Warnings.html +++ b/Doc/Manual/Warnings.html @@ -551,6 +551,8 @@ example.i(4) : Syntax error in input. <li>822. Covariant return types not supported in Java. Proxy method will return <em>basetype</em> (Java). <li>823. No javaconstruct typemap defined for <em>type</em> (Java). <li>824. Missing JNI descriptor in directorin typemap defined for <em>type</em> (Java). +<li>825. "directorconnect" attribute missing in <em>type</em> "javaconstruct" typemap. (Java). +<li>826. The nspace feature is used on '<em>type</em>' without -package. The generated code may not compile as Java does not support types declared in a named package accessing types declared in an unnamed package. (Java). </ul> <ul> |