docs: 8.0.6 updates

Author: rsomla1

README.txt

@@ -47,7 +47,7 @@ You can find the documentation on the MySQL website at
 <http://dev.mysql.com/doc/dev/connector-cpp/>
 
 For the new features/bugfix history, see release notes at
-<https://dev.mysql.com/doc/relnotes/connector-cpp/en/news-8-0-5.html>.
+<https://dev.mysql.com/doc/relnotes/connector-cpp/en/news-8-0.html>.
 Note that the initial releases used major version 2.0.
 
 CONTACT

include/devapi/collection_crud.h

@@ -112,7 +112,7 @@ struct Collection_add_base
   Each document must have a unique identifier which is stored in `_id`
   field of the document. Document identifiers are character strings no longer
   than 32 characters. If added document does not have `_id` field, a unique
-  identifier will be generated for it. Document identifier generated by given
+  identifier is generated for it. Document identifier generated by given
   collection add operation can be examined using `Result::getDocumentIds()`
   method. Generated document identifiers are string of 32 hexadecimal digits,
   like this one `0512020981044082E6119DFA0E4C0584`.

include/devapi/common.h

@@ -369,7 +369,7 @@ namespace internal {
   class is_range
   {
     /*
-      Note: This overload will be taken into account only if std::begin(X) and
+      Note: This overload is taken into account only if std::begin(X) and
       std::end(X) expressions are valid.
     */
     template <class X>

include/devapi/crud.h

@@ -43,7 +43,7 @@
 
      Limit< Offset< Executable<...> > >
 
-  will represent operation for which first .limit() can be called, followed by
+  represents an operation for which first .limit() can be called, followed by
   .offset() and then finally .execute(). See classes like
   Collection_find_base in collection_crud.h for more examples.
 

include/devapi/document.h

@@ -388,8 +388,7 @@ class PUBLIC_API Value : public internal::Printable
   /**
     @name Conversion to C++ Types
 
-    Attempt to convert value of non-compatible type will
-    throw an error.
+    Attempt to convert value of non-compatible type throws an error.
   */
   //@{
 
@@ -585,16 +584,16 @@ class ExprValue
   as expression.
 
   If `s` is a string value, then in contexts where values are
-  expected, `expr(s)` will treat `s` as a DevAPI expression. For
+  expected, `expr(s)` treats `s` as a DevAPI expression. For
   example statement
 
   table.select("foo > 1").execute();
 
-  will return string `"foo > 1"` for each row in the table while
+  returns the string `"foo  1"` for each row in the table while
 
   table.select(expr("foo > 1")).execute();
 
-  will return true/false, depending on the value of the expression.
+  returns true/false, depending on the value of the expression.
 
   @ingroup devapi
 */

include/devapi/result.h

@@ -185,7 +185,7 @@ namespace internal {
   Result res = operation.execute();
   ~~~~~~
 
-  Storing another result in `Result` instance will overwrite
+  Storing another result in `Result` instance overwrites
   previous result.
 
   @todo Implement other methods for getting information about
@@ -371,7 +371,7 @@ class PUBLIC_API Column
         it could be confusing with the multi-byte charsets.
         For instance with UTF8MB4 the length of VARCHAR(100)
         column is returned as 400 because each character is
-        4 bytes long.       
+        4 bytes long.
 */
 
   unsigned long getLength() const;
@@ -481,8 +481,8 @@ class PUBLIC_API RowResult
     Return all remaining rows
 
     %Result of this method can be stored in an STL container such as
-    `std::list<Row>`. Rows that have been fetched using fetchOne() will not
-    be available when calling fetchAll()
+    `std::list<Row>`. Rows that have already been fetched using fetchOne() are
+    not available when calling fetchAll()
    */
 
   RowList fetchAll()
@@ -499,7 +499,7 @@ class PUBLIC_API RowResult
   /*
    Iterate over rows (range-for support).
 
-   Rows that have been fetched using iterator will not be available when
+   Rows that have been fetched using iterator are not available when
    calling fetchOne() or fetchAll()
   */
 
@@ -663,8 +663,8 @@ class PUBLIC_API DocResult
     Return all remaining documents.
 
     %Result of this method can be stored in an STL container such as
-    `std::list<DbDoc>`. Documents that have been fetched using fetchOne() will
-    not be available when calling fetchAll()
+    `std::list<DbDoc>`. Documents that have been fetched using fetchOne() are
+    not available when calling fetchAll()
    */
 
   DocList fetchAll()
@@ -684,7 +684,7 @@ class PUBLIC_API DocResult
   /*
    Iterate over documents (range-for support).
 
-   Documents that have been fetched using iterator will not be available when
+   Documents that have been fetched using iterator are not available when
    calling fetchOne() or fetchAll()
   */
 

include/mysql_common.h

@@ -158,7 +158,7 @@
   use standard C++ library classes as components. For example, we use
   std::shared_ptr<> a lot. We can not modify standard library headers to export
   these classes. As is the common practice, we ignore this issue assuming that
-  the code that uses our connector will be built with the same C++ runtime
+  the code that uses our connector is built with the same C++ runtime
   implementation as the one used to build the connector. To silence the warnings,
   uses of standard library classes in our public API classes should be surrounded
   with DLL_WARNINGS_PUSH/POP macros.

include/mysql_devapi.h

@@ -120,7 +120,7 @@ namespace mysqlx {
 
   When creating Schema object, by default no checks are made that
   it actually exists in the database. Operation that is executed
-  on the server and involves such non-existent schema will throw
+  on the server and involves such non-existent schema throws
   an error at execution time.
 
   @ingroup devapi
@@ -170,9 +170,9 @@ class PUBLIC_API Schema
   /**
     Return `Collection` object representing named collection in
     the schema. If `check_exists` is true and named collection
-    does not exist, an error will be thrown. Otherwise, if named
-    collection does not exist, the returned object will refer
-    to non-existent collection.
+    does not exist, an error is thrown. Otherwise, if named
+    collection does not exist, the returned object refers
+    to a non-existent collection.
 
     @note Checking existence of the collection involves
     communication with the server. If `check_exists` is false,
@@ -184,8 +184,8 @@ class PUBLIC_API Schema
 
   /**
     Return `Table` object representing table or view in the schema.
-    If `check_exists` is true and table does not exist, an error will be thrown.
-    Otherwise, if table does not exists, the returned object will refer
+    If `check_exists` is true and table does not exist, an error is thrown.
+    Otherwise, if table does not exists, the returned object refers
     to non-existent table.
 
     @note Checking existence of the table involves
@@ -254,9 +254,9 @@ class PUBLIC_API Schema
   /**
     Drop given collection from the schema.
 
-    This method will silently succeed if given collection does not exist.
+    This method silently succeeds if given collection does not exist.
 
-    @note If table name is passed to the method, it will behave like
+    @note If table name is passed to the method, it behaves like
     dropTable().
   */
 
@@ -265,11 +265,11 @@ class PUBLIC_API Schema
   /**
     Drop given table from the schema.
 
-    This method will silently succeed if given table does not exist. If given
-    table is a view (isView() returns true) then it will not be dropped (and no
+    This method silently succeeds if given table does not exist. If given
+    table is a view (isView() returns true) then it is not dropped (and no
     error is reported) - use dropView() instead.
 
-    @note If collection name is passed to the method, it will behave like
+    @note If collection name is passed to the method, it behaves like
     dropCollection().
   */
 
@@ -278,7 +278,7 @@ class PUBLIC_API Schema
   /**
     Drop given view from the schema.
 
-    This method will silently succeed if given view does not exist. This is
+    This method silently succeeds if given view does not exist. This is
     also the case when a name of non-view object, such as table or collection
     was given (as a view with the given name does not exist).
   */
@@ -660,9 +660,9 @@ DLL_WARNINGS_PUSH
   are thrown from session constructor.
 
   It is possible to specify several hosts when creating a session. In that
-  case failed connection to one of the hosts will trigger fail-over attempt
+  case failed connection to one of the hosts triggers fail-over attempt
   to connect to a different host in the list. Only if none of the hosts could
-  be contacted, session creation will fail. It is also possible to specify
+  be contacted, session creation fails. It is also possible to specify
   priorities for the hosts in the list which determine the order in which
   hosts are tried (see `SessionOption::PRIORITY`).
 
@@ -734,7 +734,7 @@ class PUBLIC_API Session
     Get named schema object in a given session.
 
     The object does not have to exist in the database.
-    Errors will be thrown if one tries to use non-existing
+    Error is thrown if one tries to use a non-existing
     schema.
   */
 
@@ -743,7 +743,7 @@ class PUBLIC_API Session
   /**
     Get named schema object in a given session.
 
-    Errors will be thrown if one tries to use non-existing
+    Error is thrown if one tries to use a non-existing
     schema with check_existence = true.
   */
 
@@ -770,7 +770,7 @@ class PUBLIC_API Session
   /**
     Drop the schema.
 
-    Errors will be thrown if schema doesn't exist,
+    Error is thrown if the schema doesn't exist,
   */
 
   void   dropSchema(const string &name);
@@ -818,7 +818,7 @@ class PUBLIC_API Session
   /**
     Closes current session.
 
-    After a session is closed, any call to other method will throw Error.
+    After a session is closed, any call to other method throws Error.
   */
 
   void close()