dams Wed May 9 00:48:07 2001 EDT Modified files: /phpdoc/en/functions fbsql.xml Log: Corrected some prototype description.One minor typo.
Index: phpdoc/en/functions/fbsql.xml diff -u phpdoc/en/functions/fbsql.xml:1.1 phpdoc/en/functions/fbsql.xml:1.2 --- phpdoc/en/functions/fbsql.xml:1.1 Tue May 1 11:12:13 2001 +++ phpdoc/en/functions/fbsql.xml Wed May 9 00:48:07 2001 @@ -8,7 +8,7 @@ with fbsql support by using the <option role="configure">--with-fbsql</option> option. If you use this option without specifying the path to fbsql, php will - search for the fbsql client libraries in the default instalation + search for the fbsql client libraries in the default installation location for the platform. Users who installed FrontBase in a non standard directory should always specify the path to fbsql: <option role="configure">--with-fbsql=/path/to/fbsql</option>. @@ -153,7 +153,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>fbsql_close</function></funcdef> + <funcdef>boolean <function>fbsql_close</function></funcdef> <paramdef>int <parameter> <optional>link_identifier</optional> @@ -162,7 +162,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on error. + Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. </para> <para> <function>fbsql_close</function> closes the connection to the FrontBase server that's associated with the specified link @@ -203,7 +203,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>fbsql_connect</function></funcdef> + <funcdef>resource <function>fbsql_connect</function></funcdef> <paramdef>string <parameter> <optional>hostname @@ -316,13 +316,13 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>fbsql_data_seek</function></funcdef> + <funcdef>boolean <function>fbsql_data_seek</function></funcdef> <paramdef>int <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>row_number</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on failure. + Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on failure. </para> <para> <function>fbsql_data_seek</function> moves the internal row @@ -378,7 +378,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>fbsql_db_query</function></funcdef> + <funcdef>resource <function>fbsql_db_query</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> <paramdef>int @@ -390,7 +390,7 @@ </funcsynopsis> <para> Returns: A positive FrontBase result identifier to the query result, - or false on error. + or <literal>FALSE</literal> on error. </para> <para> <function>fbsql_db_query</function> selects a database and @@ -415,7 +415,7 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>fbsql_drop_db</function></funcdef> + <funcdef>boolean <function>fbsql_drop_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>int <parameter> @@ -425,7 +425,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on failure. + Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on failure. </para> <para> <function>fbsql_drop_db</function> attempts to drop (remove) an @@ -557,7 +557,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array that corresponds to the fetched row, or false + Returns an array that corresponds to the fetched row, or <literal>FALSE</literal> if there are no more rows.</para> <para> <function>fbsql_fetch_array</function> is an extended version of @@ -628,7 +628,7 @@ </funcsynopsis> <para> Returns an associative array that corresponds to the fetched row, - or false if there are no more rows.</para> + or <literal>FALSE</literal> if there are no more rows.</para> <para> <function>fbsql_fetch_assoc</function> is equivalent to calling <function>fbsql_fetch_array</function> with FBSQL_ASSOC for the @@ -785,7 +785,7 @@ <para> Returns: An array that corresponds to the lengths of each field in the last row fetched by <function>fbsql_fetch_row</function>, - or false on error. + or <literal>FALSE</literal> on error. </para> <para> <function>fbsql_fetch_lengths</function> stores the lengths of @@ -821,7 +821,7 @@ </funcsynopsis> <para> Returns an object with properties that correspond to the fetched - row, or false if there are no more rows. + row, or <literal>FALSE</literal> if there are no more rows. </para> <para> <function>fbsql_fetch_object</function> is similar to @@ -876,7 +876,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or +<literal>FALSE</literal> if there are no more rows. </para> <para> @@ -887,7 +887,7 @@ </para> <para> Subsequent call to <function>fbsql_fetch_row</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or <literal>FALSE</literal> if there are +no more rows. </para> <para> @@ -1444,7 +1444,7 @@ </funcsynopsis> <para> Returns: A positive FrontBase persistent link identifier on success, - or false on error. + or <literal>FALSE</literal> on error. </para> <para> <function>fbsql_pconnect</function> establishes a connection @@ -1511,16 +1511,16 @@ </para> </note> <para> - <function>fbsql_query</function> returns TRUE (non-zero) or FALSE + <function>fbsql_query</function> returns <literal>TRUE</literal> (non-zero) or +<literal>FALSE</literal> to indicate whether or not the query succeeded. A return value - of TRUE means that the query was legal and could be executed by + of <literal>TRUE</literal> means that the query was legal and could be executed +by the server. It does not indicate anything about the number of rows affected or returned. It is perfectly possible for a query to succeed but affect no rows or return no rows. </para> <para> The following query is syntactically invalid, so - <function>fbsql_query</function> fails and returns FALSE: + <function>fbsql_query</function> fails and returns <literal>FALSE</literal>: <example> <title><function>fbsql_query</function></title> <programlisting role="php"> @@ -1535,7 +1535,7 @@ The following query is semantically invalid if <literal>my_col</literal> is not a column in the table <literal>my_tbl</literal>, so <function>fbsql_query</function> - fails and returns FALSE: + fails and returns <literal>FALSE</literal>: <example> <title><function>fbsql_query</function></title> <programlisting role="php"> @@ -1547,7 +1547,7 @@ </example> </para> <para> - <function>fbsql_query</function> will also fail and return FALSE + <function>fbsql_query</function> will also fail and return +<literal>FALSE</literal> if you don't have permission to access the table(s) referenced by the query. </para> @@ -1647,7 +1647,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on error. + Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. </para> <para> <function>fbsql_select_db</function> sets the current active @@ -1726,7 +1726,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true if warnings is turned on otherwise false. + Returns: <literal>TRUE</literal> if warnings is turned on otherwise +<literal>FALSE</literal>. </para> <para> <function>fbsql_warnings</function> enables or disables FrontBase