Bladeren bron

[DOCUMENTATION] English:

- manual fixes

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@16564 44c647ce-9c0f-0410-b52a-842ac1e357ba
thomas 16 jaren geleden
bovenliggende
commit
82a727c5df

+ 25 - 25
documentation/manual/en/module_specs/Zend_Db_Select.xml

@@ -956,13 +956,13 @@ $select = $db->select()
 
             <para>
                 In <classname>Zend_Db_Select</classname>, you can specify conditions for restricting
-                groups using the <code>having()</code> method. Its usage is similar to that of the
-                <code>where()</code> method. The first argument is a string containing a SQL
+                groups using the <methodname>having()</methodname> method. Its usage is similar to that of the
+                <methodname>where()</methodname> method. The first argument is a string containing a SQL
                 expression. The optional second argument is a value that is used to replace a
                 positional parameter placeholder in the SQL expression. Expressions given in
-                multiple invocations of the <code>having()</code> method are combined using the
+                multiple invocations of the <methodname>having()</methodname> method are combined using the
                 Boolean <code>AND</code> operator, or the <code>OR</code> operator if you use the
-                <code>orHaving()</code> method.
+                <methodname>orHaving()</methodname> method.
             </para>
 
             <example id="zend.db.select.building.having.example">
@@ -992,9 +992,9 @@ $select = $db->select()
             <note>
 
                 <para>
-                    No quoting is applied to expressions given to the <code>having()</code> or
-                    <code>orHaving()</code> methods. If you have column names that need to be
-                    quoted, you must use <code>quoteIdentifier()</code> as you form the string for
+                    No quoting is applied to expressions given to the <methodname>having()</methodname> or
+                    <methodname>orHaving()</methodname> methods. If you have column names that need to be
+                    quoted, you must use <methodname>quoteIdentifier()</methodname> as you form the string for
                     the condition.
                 </para>
 
@@ -1017,14 +1017,14 @@ $select = $db->select()
             </para>
 
             <para>
-                In <classname>Zend_Db_Select</classname>, you can use the <code>order()</code>
+                In <classname>Zend_Db_Select</classname>, you can use the <methodname>order()</methodname>
                 method to specify a column or an array of columns by which to sort. Each element of
                 the array is a string naming a column. Optionally with the <code>ASC</code>
                 <code>DESC</code> keyword following it, separated by a space.
             </para>
 
             <para>
-                Like in the <code>from()</code> and <code>group()</code> methods, column names are
+                Like in the <methodname>from()</methodname> and <methodname>group()</methodname> methods, column names are
                 quoted as identifiers, unless they contain parentheses or are an object of
                 type <classname>Zend_Db_Expr</classname>.
             </para>
@@ -1069,7 +1069,7 @@ $select = $db->select()
             </para>
 
             <para>
-                In <classname>Zend_Db_Select</classname>, you can use the <code>limit()</code>
+                In <classname>Zend_Db_Select</classname>, you can use the <methodname>limit()</methodname>
                 method to specify the count of rows and the number of rows to skip. The first
                 argument to this method is the desired count of rows. The second argument is the
                 number of rows to skip.
@@ -1105,12 +1105,12 @@ $select = $db->select()
             </note>
 
             <para>
-                Use the <code>limitPage()</code> method for an alternative way to specify row count
+                Use the <methodname>limitPage()</methodname> method for an alternative way to specify row count
                 and offset. This method allows you to limit the result set to one of a series of
                 fixed-length subsets of rows from the query's total result set. In other words, you
                 specify the length of a "page" of results, and the ordinal number of the single
                 page of results you want the query to return. The page number is the first argument
-                of the <code>limitPage()</code> method, and the page length is the second argument.
+                of the <methodname>limitPage()</methodname> method, and the page length is the second argument.
                 Both arguments are required; they have no default values.
             </para>
 
@@ -1139,7 +1139,7 @@ $select = $db->select()
             <title>Adding the DISTINCT Query Modifier</title>
 
             <para>
-                The <code>distinct()</code> method enables you to add the <code>DISTINCT</code>
+                The <methodname>distinct()</methodname> method enables you to add the <code>DISTINCT</code>
                 keyword to your SQL query.
             </para>
 
@@ -1166,7 +1166,7 @@ $select = $db->select()
             <title>Adding the FOR UPDATE Query Modifier</title>
 
             <para>
-                The <code>forUpdate()</code> method enables you to add the <code>FOR UPDATE</code>
+                The <methodname>forUpdate()</methodname> method enables you to add the <code>FOR UPDATE</code>
                 modifier to your SQL query.
             </para>
 
@@ -1205,13 +1205,13 @@ $select = $db->select()
 
             <para>
                 You can execute the query represented by the <classname>Zend_Db_Select</classname>
-                object by passing it as the first argument to the <code>query()</code> method of a
+                object by passing it as the first argument to the <methodname>query()</methodname> method of a
                 <classname>Zend_Db_Adapter_Abstract</classname> object. Use the
                 <classname>Zend_Db_Select</classname> objects instead of a string query.
             </para>
 
             <para>
-                The <code>query()</code> method returns an object of type
+                The <methodname>query()</methodname> method returns an object of type
                 <classname>Zend_Db_Statement</classname> or PDOStatement, depending on the adapter
                 type.
             </para>
@@ -1237,8 +1237,8 @@ $result = $stmt->fetchAll();
             <title>Executing Select Queries from the Object</title>
 
             <para>
-                As an alternative to using the <code>query()</code> method of the adapter object,
-                you can use the <code>query()</code> method of the
+                As an alternative to using the <methodname>query()</methodname> method of the adapter object,
+                you can use the <methodname>query()</methodname> method of the
                 <classname>Zend_Db_Select</classname> object. Both methods return an object of type
                 <classname>Zend_Db_Statement</classname> or PDOStatement, depending on the adapter
                 type.
@@ -1266,7 +1266,7 @@ $result = $stmt->fetchAll();
 
             <para>
                 If you need access to a string representation of the SQL query corresponding to the
-                <classname>Zend_Db_Select</classname> object, use the <code>__toString()</code>
+                <classname>Zend_Db_Select</classname> object, use the <methodname>__toString()</methodname>
                 method.
             </para>
 
@@ -1297,7 +1297,7 @@ echo "$sql\n";
 
         <para>
             This section describes other methods of the <classname>Zend_Db_Select</classname> class
-            that are not covered above: <code>getPart()</code> and <code>reset()</code>.
+            that are not covered above: <methodname>getPart()</methodname> and <methodname>reset()</methodname>.
         </para>
 
         <sect3 id="zend.db.select.other.get-part">
@@ -1305,7 +1305,7 @@ echo "$sql\n";
             <title>Retrieving Parts of the Select Object</title>
 
             <para>
-                The <code>getPart()</code> method returns a representation of one part of your SQL
+                The <methodname>getPart()</methodname> method returns a representation of one part of your SQL
                 query. For example, you can use this method to return the array of expressions for
                 the <code>WHERE</code> clause, or the array of columns (or column expressions) that
                 are in the <code>SELECT</code> list, or the values of the count and offset for the
@@ -1320,7 +1320,7 @@ echo "$sql\n";
             </para>
 
             <para>
-                The single argument to the <code>getPart()</code> method is a string that
+                The single argument to the <methodname>getPart()</methodname> method is a string that
                 identifies which part of the Select query to return. For example, the string
                 <code>'from'</code> identifies the part of the Select object that stores
                 information about the tables in the <code>FROM</code> clause, including joined
@@ -1428,18 +1428,18 @@ print_r( $orderData );
             <title>Resetting Parts of the Select Object</title>
 
             <para>
-                The <code>reset()</code> method enables you to clear one specified part of the SQL
+                The <methodname>reset()</methodname> method enables you to clear one specified part of the SQL
                 query, or else clear all parts of the SQL query if you omit the argument.
             </para>
 
             <para>
                 The single argument is optional. You can specify the part of the query to clear,
-                using the same strings you used in the argument to the <code>getPart()</code>
+                using the same strings you used in the argument to the <methodname>getPart()</methodname>
                 method. The part of the query you specify is reset to a default state.
             </para>
 
             <para>
-                If you omit the parameter, <code>reset()</code> changes all parts of the query to
+                If you omit the parameter, <methodname>reset()</methodname> changes all parts of the query to
                 their default state. This makes the <classname>Zend_Db_Select</classname> object
                 equivalent to a new object, as though you had just instantiated it.
             </para>

+ 19 - 19
documentation/manual/en/module_specs/Zend_Db_Statement.xml

@@ -5,8 +5,8 @@
     <title>Zend_Db_Statement</title>
 
     <para>
-        In addition to convenient methods such as <code>fetchAll()</code> and
-        <code>insert()</code> documented in <xref linkend="zend.db.adapter" />,
+        In addition to convenient methods such as <methodname>fetchAll()</methodname> and
+        <methodname>insert()</methodname> documented in <xref linkend="zend.db.adapter" />,
         you can use a statement object to gain more options for running
         queries and fetching result sets. This section describes how to get an
         instance of a statement object, and how to use its methods.
@@ -23,7 +23,7 @@
 
         <para>
             Typically, a statement object is returned by the
-            <code>query()</code> method of the database Adapter class.
+            <methodname>query()</methodname> method of the database Adapter class.
             This method is a general way to prepare any SQL statement.
             The first argument is a string containing an SQL statement.
             The optional second argument is an array of values to bind
@@ -74,7 +74,7 @@ $stmt = new Zend_Db_Statement_Mysqli($db, $sql);
         <para>
             You need to execute a statement object if you create it using its
             constructor, or if you want to execute the same statement multiple
-            times. Use the <code>execute()</code> method of the statement
+            times. Use the <methodname>execute()</methodname> method of the statement
             object. The single argument is an array of value to bind to
             parameter placeholders in the statement.
         </para>
@@ -144,7 +144,7 @@ $stmt->execute(array(':reporter' => 'goofy', ':status' => 'FIXED'));
 
             <para>
                 To retrieve one row from the result set, use the
-                <code>fetch()</code> method of the statement object.
+                <methodname>fetch()</methodname> method of the statement object.
                 All three arguments of this method are optional:
             </para>
 
@@ -164,7 +164,7 @@ $stmt->execute(array(':reporter' => 'goofy', ':status' => 'FIXED'));
                         <emphasis>Cursor orientation</emphasis>
                         is the second argument. The default is
                         Zend_Db::FETCH_ORI_NEXT, which simply means that each
-                        call to <code>fetch()</code> returns the next row in
+                        call to <methodname>fetch()</methodname> returns the next row in
                         the result set, in the order returned by the RDBMS.
                     </para>
                 </listitem>
@@ -177,13 +177,13 @@ $stmt->execute(array(':reporter' => 'goofy', ':status' => 'FIXED'));
                         to return.
                         If the cursor orientation is Zend_Db::FETCH_ORI_REL,
                         then the offset number is relative to the cursor
-                        position before <code>fetch()</code> was called.
+                        position before <methodname>fetch()</methodname> was called.
                     </para>
                 </listitem>
             </itemizedlist>
 
             <para>
-                <code>fetch()</code> returns <constant>FALSE</constant> if all rows of
+                <methodname>fetch()</methodname> returns <constant>FALSE</constant> if all rows of
                 the result set have been fetched.
             </para>
 
@@ -211,9 +211,9 @@ while ($row = $stmt->fetch()) {
 
             <para>
                 To retrieve all the rows of the result set in one step, use the
-                <code>fetchAll()</code> method. This is equivalent to calling
-                the <code>fetch()</code> method in a loop and returning all
-                the rows in an array. The <code>fetchAll()</code> method accepts
+                <methodname>fetchAll()</methodname> method. This is equivalent to calling
+                the <methodname>fetch()</methodname> method in a loop and returning all
+                the rows in an array. The <methodname>fetchAll()</methodname> method accepts
                 two arguments. The first is the fetch style, as described above,
                 and the second indicates the number of the column to return,
                 when the fetch style is Zend_Db::FETCH_COLUMN.
@@ -246,14 +246,14 @@ echo $rows[0]['bug_description'];
                 as associative arrays, mapping column names to column values.
                 You can specify a different format for the statement class to
                 return rows, just as you can in the Adapter class. You can use
-                the <code>setFetchMode()</code> method of the statement object
+                the <methodname>setFetchMode()</methodname> method of the statement object
                 to specify the fetch mode. Specify the fetch mode using
                 Zend_Db class constants FETCH_ASSOC, FETCH_NUM, FETCH_BOTH,
                 FETCH_COLUMN, and FETCH_OBJ.
                 See <xref linkend="zend.db.adapter.select.fetch-mode" />
                 for more information on these modes.
-                Subsequent calls to the statement methods <code>fetch()</code>
-                or <code>fetchAll()</code> use the fetch mode that you specify.
+                Subsequent calls to the statement methods <methodname>fetch()</methodname>
+                or <methodname>fetchAll()</methodname> use the fetch mode that you specify.
             </para>
 
             <example id="zend.db.statement.fetching.fetch-mode.example">
@@ -282,7 +282,7 @@ echo $rows[0][0];
 
             <para>
                 To return a single column from the next row of the result set,
-                use <code>fetchColumn()</code>. The optional argument is the
+                use <methodname>fetchColumn()</methodname>. The optional argument is the
                 integer index of the column, and it defaults to 0. This method
                 returns a scalar value, or <constant>FALSE</constant> if all rows of
                 the result set have been fetched.
@@ -290,10 +290,10 @@ echo $rows[0][0];
 
             <para>
                 Note this method operates differently than the
-                <code>fetchCol()</code> method of the Adapter class.
-                The <code>fetchColumn()</code> method of a statement returns a
+                <methodname>fetchCol()</methodname> method of the Adapter class.
+                The <methodname>fetchColumn()</methodname> method of a statement returns a
                 single value from one row.
-                The <code>fetchCol()</code> method of an adapter returns an
+                The <methodname>fetchCol()</methodname> method of an adapter returns an
                 array of values, taken from the first column of all rows of the
                 result set.
             </para>
@@ -320,7 +320,7 @@ $bug_status = $stmt->fetchColumn(2);
 
             <para>
                 To retrieve a row from the result set structured as an object,
-                use the <code>fetchObject()</code>. This method takes two
+                use the <methodname>fetchObject()</methodname>. This method takes two
                 optional arguments. The first argument is a string that names
                 the class name of the object to return; the default is
                 'stdClass'. The second argument is an array of values that