cvs: ZendAPI / Extending_Zend_Arguments.xml Extending_Zend_CallingUserFunctions.xml Extending_Zend_Creating.xml Extending_Zend_IniFileSupport.xml

hholzgra Mon Mar 25 03:27:13 2002 EDT Modified files: /ZendAPI Extending_Zend_Arguments.xml Extending_Zend_CallingUserFunctions.xml Extending_Zend_Creating.xml Extending_Zend_IniFileSupport.xml Log: no more magic numbers left Index: ZendAPI/Extending_Zend_Arguments.xml diff -u ZendAPI/Extending_Zend_Arguments.xml:1.8 ZendAPI/Extending_Zend_Arguments.xml:1.9 --- ZendAPI/Extending_Zend_Arguments.xml:1.8 Sun Mar 24 21:23:50 2002 +++ ZendAPI/Extending_Zend_Arguments.xml Mon Mar 25 03:27:13 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="ISO-8859-1" ?> - <!-- $Revision: 1.8 $ --> + <!-- $Revision: 1.9 $ --> <chapter id="zend.arguments"> <title>Accepting Arguments</title> <para> @@ -650,7 +650,7 @@ </para> <example id='example.zval-typedef'> - <title>Listing 9.8. PHP/Zend <envar>zval</envar> type definition.</title> + <title>PHP/Zend <envar>zval</envar> type definition.</title> <programlisting> <![CDATA[ typedef pval zval; @@ -689,11 +689,13 @@ the value structure, type, and reference information. The substructure <envar>zvalue_value</envar> is a union that contains the variable's contents. Depending on the variable's type, you'll have to access different members of - this union. For a description of both structures, see Tables 9.5, 9.6, and 9.7. + this union. For a description of both structures, see + <xref linkend='tab.struct-zval'/>, + <xref linkend='tab.struct-zvalue-value'/> and + <xref linkend='tab.ztype-constants'/>. </para> - <figure> - <title>Table 9.5. Zend <envar>zval</envar> Structure</title> - <informaltable> + <table id='tab.struct-zval'> + <title>Zend <envar>zval</envar> Structure</title> <tgroup cols="2"> <colspec colnum="1" colname="col1" colwidth="1.00*"/> <colspec colnum="2" colname="col2" colwidth="1.66*"/> @@ -705,15 +707,15 @@ <row> <entry colname="col1"><envar>value</envar></entry> <entry colname="col2"> - Union containing this variable's contents. See Table 9.6 for - a description. + Union containing this variable's contents. See + <xref linkend='tab.struct-zvalue-value'/> for a description. </entry> </row> <row> <entry colname="col1"><envar>type</envar></entry> <entry colname="col2"> Contains this variable's type. For a list of available - types, see Table 9.7. + types, see <xref linkend='tab.ztype-constants'/>. </entry> </row> <row> @@ -735,11 +737,9 @@ </row> </tbody> </tgroup> - </informaltable> - </figure> - <figure> - <title>Table 9.6. Zend <envar>zvalue_value</envar> Structure</title> - <informaltable> + </table> + <table id='tab.struct-zvalue-value'> + <title>Zend <envar>zvalue_value</envar> Structure</title> <tgroup cols="2"> <colspec colnum="1" colname="col1" colwidth="1.00*"/> <colspec colnum="2" colname="col2" colwidth="1.66*"/> @@ -779,12 +779,10 @@ </row> </tbody> </tgroup> - </informaltable> - </figure> + </table> - <figure> - <title>Table 9.7. Zend Variable Type Constants</title> - <informaltable> + <table id='tab.ztype-constants'> + <title>Zend Variable Type Constants</title> <tgroup cols="2"> <colspec colnum="1" colname="col1" colwidth="1.00*"/> <colspec colnum="2" colname="col2" colwidth="1.65*"/> @@ -832,8 +830,7 @@ </row> </tbody> </tgroup> - </informaltable> - </figure> + </table> <para> To access a long you access <envar>zval.value.lval</envar>, to access a double you use <envar>zval.value.dval</envar>, and so on. @@ -924,11 +921,10 @@ parameter being passed by reference, you can use the macro <literal>PZVAL_IS_REF</literal>. This macro accepts a <literal>zval*</literal> to check if it is a reference or not. Examples are given in - in Listing 9.6 and Figure 9.9 (see the - CD-ROM for the full source). + in <xref linkend='example.pass-by-ref'/>. </para> - <figure> - <title>Listing 9.6. Testing for referenced parameter passing.</title> + <example id='example.pass-by-ref'> + <title>Testing for referenced parameter passing.</title> <programlisting> <![CDATA[ zval *parameter; @@ -948,7 +944,7 @@ ]]> </programlisting> <graphic fileref="figures/Extending_Zend_5_reference_test.png"/> - </figure> + </example> </section> <section id="zend.arguments.write-safety"> <title>Assuring Write Safety for Other Parameters</title> Index: ZendAPI/Extending_Zend_CallingUserFunctions.xml diff -u ZendAPI/Extending_Zend_CallingUserFunctions.xml:1.9 ZendAPI/Extending_Zend_CallingUserFunctions.xml:1.10 --- ZendAPI/Extending_Zend_CallingUserFunctions.xml:1.9 Mon Mar 25 03:13:46 2002 +++ ZendAPI/Extending_Zend_CallingUserFunctions.xml Mon Mar 25 03:27:13 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="ISO-8859-1" ?> - <!-- $Revision: 1.9 $ --> + <!-- $Revision: 1.10 $ --> <chapter id="zend.calling-user-functions"> <title>Calling User Functions</title> <para> @@ -61,7 +61,7 @@ need separation. </para> <para> - <xref linkend='example.call-user-func'/> and Figure 9.11 show a small demonstration of + <xref linkend='example.call-user-func'/> shows a small demonstration of calling a user function. The code calls a function that's supplied to it as argument and directly passes this function's return value through as its own return value. Note the use of the constructor Index: ZendAPI/Extending_Zend_Creating.xml diff -u ZendAPI/Extending_Zend_Creating.xml:1.7 ZendAPI/Extending_Zend_Creating.xml:1.8 --- ZendAPI/Extending_Zend_Creating.xml:1.7 Mon Mar 25 03:13:46 2002 +++ ZendAPI/Extending_Zend_Creating.xml Mon Mar 25 03:27:13 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="ISO-8859-1" ?> - <!-- $Revision: 1.7 $ --> + <!-- $Revision: 1.8 $ --> <chapter id="zend.creating"> <title>Creating Extensions</title> <para> @@ -126,7 +126,8 @@ --enable-variable_creation BOOK: Enables variable-creation module </screen> <para> - The module shown earlier in Listing 9.3 can be enabled with + The module shown earlier in <xref linkend='example.simple'/> + can be enabled with <literal>--enable-first_module</literal> or <literal>--enable-first_module=yes</literal>. </para> Index: ZendAPI/Extending_Zend_IniFileSupport.xml diff -u ZendAPI/Extending_Zend_IniFileSupport.xml:1.5 ZendAPI/Extending_Zend_IniFileSupport.xml:1.6 --- ZendAPI/Extending_Zend_IniFileSupport.xml:1.5 Mon Feb 11 05:10:33 2002 +++ ZendAPI/Extending_Zend_IniFileSupport.xml Mon Mar 25 03:27:13 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="ISO-8859-1" ?> - <!-- $Revision: 1.5 $ --> + <!-- $Revision: 1.6 $ --> <chapter id="zend.ini-file-support"> <title>Initialization File Support</title> <para> @@ -80,11 +80,11 @@ automatically terminate the old connection and attempt a new one. </para> <para> - Access to initialization entries - can also be handled with the macros shown in Table 9.17.</para> - <figure> - <title>Table 9.17. Macros to Access Initialization Entries in PHP</title> - <informaltable> + Access to initialization entries can also be handled with the macros + shown in <xref linkend='table.ini-macros'/>. + </para> + <table id='table.ini-macros'> + <title>Macros to Access Initialization Entries in PHP</title> <tgroup cols="2"> <colspec colnum="1" colname="col1" colwidth="1.00*"/> <colspec colnum="2" colname="col2" colwidth="1.66*"/> @@ -141,8 +141,7 @@ </row> </tbody> </tgroup> - </informaltable> - </figure> + </table> <para> Finally, you have to introduce your initialization entries to PHP. This can be done in the module startup and shutdown functions, using the macros