aboutsummaryrefslogtreecommitdiff
path: root/Doc
diff options
context:
space:
mode:
authorWilliam S Fulton <wsf@fultondesigns.co.uk>2019-02-03 21:59:48 +0000
committerWilliam S Fulton <wsf@fultondesigns.co.uk>2019-02-04 18:46:16 +0000
commit9defd8e0330ebd491b2102bb7dc6d6b43715c712 (patch)
treec96b550569834ec297dd91ac17869cb45ed17e3f /Doc
parentb50e5fac8e1d76e8810c552f533a43f67ff57837 (diff)
downloadswig-9defd8e0330ebd491b2102bb7dc6d6b43715c712.tar.gz
Add support for differentiating target language statuses
Three status: Disabled, Experimental and Supported. Any target language classified as 'Experimental' will issue new warning 524 SWIGWARN_LANG_EXPERIMENTAL. Any target language classified as 'Disabled' will error out. Languages will be classified in forthcoming commits. Issue #1437
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Manual/Introduction.html4
-rw-r--r--Doc/Manual/Warnings.html1
2 files changed, 5 insertions, 0 deletions
diff --git a/Doc/Manual/Introduction.html b/Doc/Manual/Introduction.html
index b7e12aada..17514d021 100644
--- a/Doc/Manual/Introduction.html
+++ b/Doc/Manual/Introduction.html
@@ -212,6 +212,10 @@ A target language is given the 'Experimental' status when
<p>
Anyone using an experimental target language is strongly urged to assist with development of the target language module if they wish to use it.
</p>
+<p>
+SWIG displays a warning when an experimental target language is used in order to set expectations and emphasize the experimental status of the target language.
+The usual <a href="Warnings.html#Warnings_suppression">warning suppression</a> techniques can be used if required.
+</p>
<p>
The above is a short summary and further details are outlined in the <a href="Extending.html#Extending_experimental_status">Experimental status</a> section in the Extending chapter.
diff --git a/Doc/Manual/Warnings.html b/Doc/Manual/Warnings.html
index 140090140..968bdbac8 100644
--- a/Doc/Manual/Warnings.html
+++ b/Doc/Manual/Warnings.html
@@ -534,6 +534,7 @@ example.i(4) : Syntax error in input(1).
<li>521. Illegal destructor name <em>name</em>. Ignored.
<li>522. Use of an illegal constructor name '<em>name</em>' in %extend is deprecated, the constructor name should be '<em>name</em>'.
<li>523. Use of an illegal destructor name '<em>name</em>' in %extend is deprecated, the destructor name should be '<em>name</em>'.
+<li>524. Experimental target language. Target language <em>language</em> specified by <em>lang</em> is an experimental language. Please read about SWIG experimental languages, <em>htmllink</em>.
</ul>
<H3><a name="Warnings_doxygen">17.9.6 Doxygen comments (560-599)</a></H3>