summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKevin Ruland <kruland@sunflower.com>2005-10-05 15:11:02 +0000
committerKevin Ruland <kruland@sunflower.com>2005-10-05 15:11:02 +0000
commit71d989b3a99c020a60b42a14d28d42b0ddda559f (patch)
treed445ae00bca404de7826c50c397e482c8893a1f7
parentada2b47e886771b9e8c8b86be9090b726c1e70f0 (diff)
downloadswig-71d989b3a99c020a60b42a14d28d42b0ddda559f.tar.gz
Typo correction curtesy of Olly Betts.
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/trunk@7594 626c5289-ae23-0410-ae9c-e8d60b6d4f22
-rw-r--r--SWIG/Doc/Manual/Php.html90
1 files changed, 45 insertions, 45 deletions
diff --git a/SWIG/Doc/Manual/Php.html b/SWIG/Doc/Manual/Php.html
index bb598e413..40f8bbf0d 100644
--- a/SWIG/Doc/Manual/Php.html
+++ b/SWIG/Doc/Manual/Php.html
@@ -27,7 +27,7 @@
<li><a href="#Php_nn2_6">Structures and C++ classes</a>
<ul>
<li><a href="#Php_nn2_6_1">Using <tt>-noproxy</tt></a>
-<li><a href="#Php_nn2_6_2">Constructors and Destructers</a>
+<li><a href="#Php_nn2_6_2">Constructors and Destructors</a>
<li><a href="#Php_nn2_6_3">Static Member Variables</a>
<li><a href="#Php_nn2_6_4">Static Member Functions</a>
</ul>
@@ -92,12 +92,12 @@ in the interface file.
<p>
Swig can generate PHP4 extensions from C++ libraries as well when
given the <tt>-c++</tt> option. The support for C++ is discussed in
-more detail in a following section.
+more detail in <a href="#Php_nn2_6">section 24.2.6</a>.
</p>
<p>
To finish building the extension, you have two choices. You can either build
-the extension as a seperate object file which will then have to be explicitly
+the extension as a separate shared object file which will then have to be explicitly
loaded by each script. Or you can rebuild the entire php source tree and build
the extension into the php executable/library so it will be available in every
script. The first choice is the default, however it can be changed by passing
@@ -125,7 +125,7 @@ OS):
<p>
The <tt>-make</tt> command line argument to swig will generate an
additional file Makefile. This Makefile can usually build the
-extension iteself (on unix platforms).
+extension itself (on unix platforms).
</p>
<p>
@@ -165,8 +165,8 @@ libraries and header files for you.
</pre></div>
<p>
-If you depend on source files not generated by SWIG, before generated
-configure file, you may need to edit the <tt> Makefile.in</tt>
+If you depend on source files not generated by SWIG, before generating
+the configure file, you may need to edit the <tt>Makefile.in</tt>
file. This contains the names of the source files to compile (just the
wrapper file by default) and any additional libraries needed to be
linked in. If there are extra C files to compile, you will need to add
@@ -187,11 +187,11 @@ Both the <tt>-make</tt> and <tt>-phpfull</tt> arguments accept
additional optional arguments:
</p>
<ul>
-<li><tt>-withincs "&lt;files>"</tt> Adds include files to the config.m4 file.
-<li><tt>-withlibs "&lt;files>"</tt> Links the libraries into the shared object.
-<li><tt>-withc "&lt;files>"</tt> Compiles and links the named C files into the shared object.
-<li><tt>-withcxx "&lt;files>"</tt> Compiles and links the named C++ files into the shared object,
-<li><tt>-dlname "&lt;name>"</tt> Changes the name of the generated shared object.
+<li><tt>-withincs "&lt;files&gt;"</tt> Adds include files to the config.m4 file.
+<li><tt>-withlibs "&lt;files&gt;"</tt> Links the libraries into the shared object.
+<li><tt>-withc "&lt;files&gt;"</tt> Compiles and links the named C files into the shared object.
+<li><tt>-withcxx "&lt;files&gt;"</tt> Compiles and links the named C++ files into the shared object,
+<li><tt>-dlname "&lt;name&gt;"</tt> Changes the name of the generated shared object.
</ul>
<H3><a name="Php_nn1_2"></a>24.1.2 Building extensions into PHP</H3>
@@ -206,7 +206,7 @@ in each script.
<p>
After running swig with the -phpfull switch, you will be left with a shockingly
-similiar set of files to the previous build process. However you will then need
+similar set of files to the previous build process. However you will then need
to move these files to a subdirectory within the php source tree, this subdirectory you will need to create under the ext directory, with the name of the extension ( e.g mkdir php-4.0.6/ext/modulename .)
</p>
@@ -220,7 +220,7 @@ and includes the extra command line arguments from the module you have added.
Before running the generated configure file, you may need to edit the <tt>
Makefile.in</tt>. This contains the names of the source files to compile (
just the wrapper file by default) and any additional libraries needed to
-link in. If their are extra C files to compile you will need to add them
+link in. If there are extra C files to compile you will need to add them
to the Makefile, or add the names of libraries if they are needed.
In most cases <tt>Makefile.in</tt> will be complete, especially if you
make use of <tt>-withlibs</tt> and <tt>-withincs</tt>
@@ -292,7 +292,7 @@ other symbols unless care is taken to <tt>%rename</tt> them.
These work in much the same way as in C/C++, constants can be defined
by using either the normal C pre-processor declarations, or the
<tt>%constant</tt> SWIG directive. These will then be available from
-your PHP script as a PHP constant, (e.g. no dollar sign is needed to
+your PHP script as a PHP constant, (i.e. no dollar sign is needed to
access them. ) For example, with a swig file like this,
</p>
@@ -306,7 +306,7 @@ access them. ) For example, with a swig file like this,
</div>
<p>
-you can access from in your php script like this,
+you can access the constants in your php script like this,
</p>
<div class="code"><pre>
@@ -321,8 +321,8 @@ echo "E = " . E . "\n";
<p>
There are two peculiarities with using constants in PHP4. The first is that
-if you try to use an undeclared constant, it will evaulate to a string
-set to the constants name. For example,
+if you try to use an undeclared constant, it will evaluate to a string
+set to the constant's name. For example,
</p>
<div class="code"><pre>
@@ -351,7 +351,7 @@ if(EASY_TO_MISPEL) {
<p>
will issue a warning about the undeclared constant, but will then
-evalute it and turn it into a string ('EASY_TO_MISPEL'), which
+evaluate it and turn it into a string ('EASY_TO_MISPEL'), which
evaluates to true, rather than the value of the constant which would
be false. This is a feature.
</p>
@@ -399,7 +399,7 @@ also map to the same hash element 'test', but will not overwrite
it. When called from the script, the TEST constant will again be
mapped to the hash element 'test' so the constant will be
retrieved. The case will then be checked, and will match up, so the
-value ('Hello') will be returned. When 'Test' is evaulated, it will
+value ('Hello') will be returned. When 'Test' is evaluated, it will
also map to the same hash element 'test'. The same constant will be
retrieved, this time though the case check will fail as 'Test' !=
'TEST'. So PHP will assume that Test is a undeclared constant, and as
@@ -407,7 +407,7 @@ explained above, will return it as a string set to the constant name
('Test'). Hence the script above will print 'Hello Test'. If they were
declared non-case sensitive, the output would be 'Hello Hello', as
both point to the same value, without the case test taking place. (
-Apologies, this paragraph needs rewritting to make some sense. )
+Apologies, this paragraph needs rewriting to make some sense. )
</p>
<H3><a name="Php_nn2_2"></a>24.2.2 Global Variables</H3>
@@ -431,7 +431,7 @@ the use of automatically generated accessor functions.
</pre></div>
<p>
-is accessed as follow :
+is accessed as follows:
</p>
<div class="code"><pre>
@@ -498,10 +498,10 @@ $a = foo(2.0);
</pre></div>
<p>
-Functions are envoked using pass by value semantics like all of PHP.
+Functions are invoked using pass by value semantics like all of PHP.
This means the conversion which automatically takes place when
-envoking a swig wrapped method does not change the native type of the
-arugment variable.
+invoking a swig wrapped method does not change the native type of the
+argument variable.
</p>
<div class="code"><pre>
$s = "2 A string representing two";
@@ -536,7 +536,7 @@ void doit( double i );
</pre></div>
<p>
-it is questionable which to envoke when <tt>doit("2");</tt> is used in
+it is questionable which to invoke when <tt>doit("2");</tt> is used in
PHP. The string <tt>"2"</tt> simultaneously represents the integer
<tt>2</tt> and the double <tt>2.0</tt>.
</p>
@@ -560,7 +560,7 @@ void doit( int i );
</pre></div>
<p>
-Cause less confusion and <tt>doit("2");</tt> will envoke the function
+Cause less confusion and <tt>doit("2");</tt> will invoke the function
taking the integer argument.
</p>
@@ -568,8 +568,8 @@ taking the integer argument.
<p>
-Pointers to C/C++ objects <b>no longer</b> represented as character
-strings such as:<tt>_523d3f4_Circle_p</tt>, instead they are represented
+Pointers to C/C++ objects are <b>no longer</b> represented as character
+strings such as: <tt>_523d3f4_Circle_p</tt>, instead they are represented
as PHP resources, rather like MySQL connection handles.
</p>
@@ -610,8 +610,8 @@ $result=new_intp();
add( $in1, $in2, $result );
-echo "The sum " . intp_value($in1) . " + " . intp_value($in2) . " = " . inpt_value( $result) . "\n";
-?>
+echo "The sum " . intp_value($in1) . " + " . intp_value($in2) . " = " . intp_value( $result) . "\n";
+?&gt;
</pre></div>
<p>
@@ -643,11 +643,11 @@ $in2 = 5;
$result= add($in1,$in2); # Note using variables for the input is unnecessary.
echo "The sum $in1 + $in2 = $result\n";
-?>
+?&gt;
</pre></div>
<p>
-Because PHP has a native concept of reference, it may seem more natual
+Because PHP has a native concept of reference, it may seem more natural
to the PHP developer to use references to pass pointers. To enable
this, one needs to include <b>phppointers.i</b> which defines the
named typemap REFERENCE.
@@ -676,7 +676,7 @@ $result = 0;
add(&amp;$in1,&amp;$in2,&amp;$result);
echo "The sum $in1 + $in2 = $result\n";
-?>
+?&gt;
</pre></div>
<p>
@@ -691,7 +691,7 @@ may or may not be a good thing.
<p>
We chose to allow passing NULL pointers into functions because that is
-sometimes required in C libraries.. A NULL pointer can be created in
+sometimes required in C libraries. A NULL pointer can be created in
PHP in a number of ways: by using <tt>unset</tt> on an existing
variable, or assigning <tt>NULL</tt> to a variable.
</p>
@@ -734,25 +734,25 @@ Would be used in the following way:
require "vector.php";
$v = new Vector();
- $v->x = 3;
- $v->y = 4;
- $v->z = 5;
+ $v-&gt;x = 3;
+ $v-&gt;y = 4;
+ $v-&gt;z = 5;
- echo "Magnitude of ($v->x,$v->y,$v->z) = " . $v->magnitude() . "\n";
+ echo "Magnitude of ($v-&gt;x,$v-&gt;y,$v-&gt;z) = " . $v-&gt;magnitude() . "\n";
$v = NULL; # destructor called.
$c = new Complex();
- $c->re = 0;
- $c->im = 0;
+ $c-&gt;re = 0;
+ $c-&gt;im = 0;
# $c destructor called when $c goes out of scope.
-?>
+?&gt;
</pre></div>
<p>
-Member variables and methods are accessed using the <tt>-></tt> operator.
+Member variables and methods are accessed using the <tt>-&gt;</tt> operator.
</p>
<H4><a name="Php_nn2_6_1"></a>24.2.6.1 Using <tt>-noproxy</tt></H4>
@@ -761,7 +761,7 @@ 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 follwoing PHP functions:
+in the following PHP functions:
</p>
<div class="code"><pre>
@@ -780,7 +780,7 @@ Complex_im_set($obj,$d);
Complex_im_get($obj);
</pre></div>
-<H4><a name="Php_nn2_6_2"></a>24.2.6.2 Constructors and Destructers</H4>
+<H4><a name="Php_nn2_6_2"></a>24.2.6.2 Constructors and Destructors</H4>
<p>
@@ -788,7 +788,7 @@ The constructor is called when <tt>new Object()</tt> (or
<tt>new_Object()</tt> if using <tt>-noproxy</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
-contructor to execute.
+constructor to execute.
</p>
<p>