diff options
author | Olly Betts <olly@survex.com> | 2022-11-13 15:23:42 +1300 |
---|---|---|
committer | William S Fulton <wsf@fultondesigns.co.uk> | 2022-11-26 15:17:53 +0000 |
commit | c8fd30bde2740417d611a47cee782bc947fb2a9f (patch) | |
tree | 4488d2a7aaee46fc56fe84663c9cf6eda521e5a1 | |
parent | 7b19a6d6964d39ed8ad3eac80991fb32db303497 (diff) | |
download | swig-c8fd30bde2740417d611a47cee782bc947fb2a9f.tar.gz |
[PHP] Update docs for removal of -noproxy in SWIG 4.1.0
Closes #2419
Conflicts:
CHANGES.current
-rw-r--r-- | CHANGES.current | 4 | ||||
-rw-r--r-- | Doc/Manual/Php.html | 33 | ||||
-rw-r--r-- | Doc/Manual/SWIGPlus.html | 2 |
3 files changed, 10 insertions, 29 deletions
diff --git a/CHANGES.current b/CHANGES.current index eb56fd371..37d8d90e9 100644 --- a/CHANGES.current +++ b/CHANGES.current @@ -14,6 +14,10 @@ Version 4.1.1 (in progress) #2447 Fix undefined behaviour in swig's parser when handling default parameter expressions containing method calls. +2022-11-13: olly + [PHP] #2419 Update the documentation to reflect that SWIG 4.1.0 + dropped support for -noproxy when generating PHP wrappers. + 2022-11-05: wsfulton #2417 Fix -swiglib for Windows when building with CMake. diff --git a/Doc/Manual/Php.html b/Doc/Manual/Php.html index 97a48b707..fad7f6a2f 100644 --- a/Doc/Manual/Php.html +++ b/Doc/Manual/Php.html @@ -635,19 +635,13 @@ variable, or assigning <tt>NULL</tt> to a variable. <p> -SWIG defaults to wrapping C++ structs and classes with PHP classes. +SWIG wraps C++ structs and classes with PHP classes. Since SWIG 4.1.0, this is done entirely via PHP's C API - earlier SWIG versions generated a PHP wrapper script which defined proxy classes which called a set of flat functions which actually wrapped the C++ class. </p> <p> -If you don't want the class wrappers, you can pass the command-line option -"-noproxy" in which case you'll get C++ classes wrapped as flat functions -as described below. -</p> - -<p> This interface file </p> @@ -699,33 +693,16 @@ Member variables and methods are accessed using the <tt>-></tt> operator. <p> -The <tt>-noproxy</tt> option flattens the object structure and -generates collections of named functions. The above example results -in the following PHP functions: +SWIG/PHP used to support a <tt>-noproxy</tt> option to flatten the class +structure and generate collections of named flat functions. This is no +longer supported as of SWIG 4.1.0. </p> -<div class="code"><pre> -new_Vector(); -Vector_x_set($obj, $d); -Vector_x_get($obj); -Vector_y_set($obj, $d); -Vector_y_get($obj); -Vector_z_set($obj, $d); -Vector_z_get($obj); -Vector_magnitude($obj); -new_Complex(); -Complex_re_set($obj, $d); -Complex_re_get($obj); -Complex_im_set($obj, $d); -Complex_im_get($obj); -</pre></div> - <H4><a name="Php_nn2_6_2">32.2.6.2 Constructors and Destructors</a></H4> <p> -The constructor is called when <tt>new Object()</tt> (or -<tt>new_Object()</tt> if using <tt>-noproxy</tt>) is used to create an +The constructor is called when <tt>new Object()</tt> is used to create an instance of the object. If multiple constructors are defined for an object, function overloading will be used to determine which constructor to execute. diff --git a/Doc/Manual/SWIGPlus.html b/Doc/Manual/SWIGPlus.html index b4b9acb17..a3f600b40 100644 --- a/Doc/Manual/SWIGPlus.html +++ b/Doc/Manual/SWIGPlus.html @@ -254,7 +254,7 @@ details. The SWIG Wiki also has further details. </p> <b>Compatibility Note:</b> Early versions of SWIG generated just a flattened low-level C style API to C++ classes by default. -The <tt>-noproxy</tt> commandline option is recognised by many target languages and will generate just this +The <tt>-noproxy</tt> commandline option is recognised by some target languages and will generate just this interface as in earlier versions. <H2><a name="SWIGPlus_nn38">6.5 Proxy classes</a></H2> |