I realize that the state of the VFP8 documentation supplied with the beta is also in beta. However, based on prior documentation content, I don't expect this item to change unless it is brought to attention specifically.

The sum total of the words describing the new CursorAdapter Class is extracted below:
"Provides a class of extended cursors that offers support for handling a wide range of local or remote data sources as native Visual FoxPro Cursors. These data source types include the following:
o Native
o Open Database Connectivity (ODBC)
o ActiveX Data Object (ADO)
o Extensible Markup Language (XML)

CursorAdapter" <---- this is the 'syntax' line.

That paltry description is basically unhelpful and desperately needs significant expansion of content to properly communicate the general operation, capabilities and limitations of this important class.

It could be argued that the entry included under "Data features enhancement" in the "What's new in VFP8 section" adequately fulfills this role. I will acknowledge that it comes close in that it describes the capabilities well (I assume) but it still does nothing much regarding operation or limitations. Based on prior history (specifically the "Session Class" of VFP6SP3 and VFP7 enhancements) it is clear that subsequent version documentation will not include this significant detail. I have reproduced the write-up for the CursorAdapter class below:
"Remote Data Connectivity Using CursorAdapter Class
Visual FoxPro offers you more choice, flexibility, and support for dealing with a wider range of data sources by providing a new class called CursorAdapter. The CursorAdapter class offer the following capabilities:

o Open Database Connectivity (ODBC), Extensible Markup Language (XML), ActiveX Data Object (ADO), or native data source types
o The capability to use different data sources dynamically
o The use of a data source belonging to the CursorAdapter object or the data environment
o The capability to share data sources within the limits of the data source technology
o The use of CursorAdapter as a standalone class without requiring an associated data environment
o The capability to optionally define the structure of a cursor associated with a CursorAdapter object
o The capability to render data from the data source into a Visual FoxPro cursor automatically and properly
o A way to control the loading of data into its associated cursor
o A way to control how data is added, updated, and deleted using methods and properties in the cursor class
o A way to be included in containers other than the data environment, such as forms

To support the new CursorAdapter functionality, Visual FoxPro includes the following enhancements:
o Adds definition and subclassing capabilities by including the CursorAdapter class in the Class Designer and providing the CursorAdapter class for the cBaseClassName parameter in the CREATE CLASS and MODIFY CLASS commands.
o Includes the new CursorAdapter Builder. You can add a CusorAdapter in a DataEnvironment by right-clicking in the Data Environment designer and selecting Add CursorAdapter from the shortcut menu. You can then open the CursorAdapter Builder by right-clicking in the CursorAdapter and selecting Builder from the shortcut menu.
o Updates the TABLEUPDATE() function so that it recognizes and handles CursorAdapter objects.
o Opens internal cursors as buffered cursors and sets the buffering default to Optimistic Row Buffering.

For syntax, parameters, and descriptions of properties, methods and events, see CursorAdapter Class.".

In fact this is a long-standing deficiency of the VFP documentation regarding all class descriptions. The importance and complexity of the CursorAdapter class serves as an excellent basis to highlight this problem.

It would be most beneficial if this could be addressed in time for the release of VFP8.

thanks