From ecc382bf13068cc42d200ada520f4ca706c1cb87 Mon Sep 17 00:00:00 2001
From: Kai Sommerfeld <kso@openoffice.org>
Date: Mon, 15 Jan 2001 09:05:55 +0000
Subject: Reformatted documentation.

---
 offapi/com/sun/star/ucb/ContentResultSet.idl | 91 ++++++++++++++++------------
 1 file changed, 51 insertions(+), 40 deletions(-)

diff --git a/offapi/com/sun/star/ucb/ContentResultSet.idl b/offapi/com/sun/star/ucb/ContentResultSet.idl
index ede8bfbc8781..1cfd2c8421d5 100644
--- a/offapi/com/sun/star/ucb/ContentResultSet.idl
+++ b/offapi/com/sun/star/ucb/ContentResultSet.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: ContentResultSet.idl,v $
  *
- *  $Revision: 1.3 $
+ *  $Revision: 1.4 $
  *
- *  last change: $Author: mi $ $Date: 2000-11-08 12:44:52 $
+ *  last change: $Author: kso $ $Date: 2001-01-15 10:05:55 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -172,57 +172,68 @@ service ContentResultSet
 
     /** controls the travel mode of the resultset cursor.
 
+        <p>
         There are two possible travel modes:
-        <type>CursorTravelMode::BLOCKING</type> and
-        <type>CursorTravelMode::NONBLOCKING</type>.
+        </p>
+
+        <table border=1>
+        <tr><td><type>BLOCKING</type></td>
+            <td>Each travel method of the resultset will not return until the
+                data for the new position were retrieved.</td></tr>
+        <tr><td><type>NONBLOCKING</type></td>
+            <td>The implementation will throw a
+                <type>CursorWouldBlockException</type>, if the data for the new
+                position are not retrieved yet.</td></tr>
+        </table>
+
+        <p>
+        The following pseudo-code illustrates the usage of a non-blocking
+        cursor:
+        </p>
 
-        In blocking mode each travel method of the resultset will not return
-        until the data for the new position were retrieved.
+        <pre>
+    bProcessedAllRows = false
+    while ( !bProcessedAllRows )
+    {
+        cursor.setPropertyValue( "CursorTravelMode", BLOCKING )
 
-        In non-blocking mode the implementation will throw a
-        <type>CursorWouldBlockException</type>, if the data for the new
-        position are not retrieved yet.
+        cursor.travelSomeWhere()
+        collectRowData()
 
-        The following pseudo-code illustrates the usage of a non-blocking
-        cursor:
+        cursor.setPropertyValue( "CursorTravelMode", NONBLOCKING )
 
-            bProcessedAllRows = false
-            while ( !bProcessedAllRows )
+        bGoOn = true;
+        while ( bGoOn )
+        {
+                  try
             {
-                cursor.setPropertyValue( "CursorTravelMode", BLOCKING )
-
                 cursor.travelSomeWhere()
                 collectRowData()
-
-                cursor.setPropertyValue( "CursorTravelMode", NONBLOCKING )
-
-                bGoOn = true;
-                while ( bGoOn )
-                {
-                    try
-                    {
-                        cursor.travelSomeWhere()
-                        collectRowData()
-                    }
-                    catch ( CursorWouldBlockException )
-                    {
-                        // No more data at the moment.
-                        bGoOn = false
-                    }
-                }
-
-                doSomethingWithCollectedRowData()
-
-                bProcessedAllRows = ...
             }
+            catch ( CursorWouldBlockException )
+            {
+                // No more data at the moment.
+                bGoOn = false
+            }
+        }
+
+        doSomethingWithCollectedRowData()
+
+        bProcessedAllRows = ...
+    }
+        </pre>
 
-         If this property is not supported, the implementation must provide
+        <p>
+         If this property is not supported, the implementation needs to provide
         a blocking cursor.
+        </p>
 
-        The implementation initially must set the value of this property
-        to <type>CursorTravelMode::BLOCKING</type>.
+        <p>
+        The implementation initially needs to set the value of this property
+        to <type>BLOCKING</type>.
+        </p>
 
-        @see com::sun::star::ucb::CursorTravelMode;
+        @see com::sun::star::ucb::CursorTravelMode
      */
     [optional, property] long CursorTravelMode;
 
-- 
cgit