doc improvements

Author: jll63

doc/custom_rtti.adoc

@@ -116,14 +116,15 @@ CRTP template:
 include::{examplesdir}/custom_rtti.cpp[tag=policy]
 ----
 
-Now we can include the "core" header and write the example:
+Next, we include the main header. Because `BOOST_OPENMETHOD_DEFAULT_POLICY` is
+defined, its value is used for the default policy. Then comes the usual example.
 
 [source,c++]
 ----
 include::{examplesdir}/custom_rtti.cpp[tag=example]
 ----
 
-This programs compiles even if standard RTTI is disabled.
+This programs works even if standard RTTI is disabled.
 
 ## Deferred RTTI
 

doc/initialize.adoc

@@ -20,6 +20,19 @@ Initializes dispatch data for the methods registered in `Policy`. This function
 must be called before any calls to those methods, and after loading or unloading
 a dynamic library that adds classes, methods or overriders to `Policy`.
 
+The return value is an object that contains a member variable, `report`, that
+contains the following information:
+
+* `std::size_t cells`: the number of cells used by the v-tables and the multiple
+dispatch tables.
+
+* `std::size_t not_implemented`: the number of methods that don't have an
+overrider for at least one combination of virtual arguments.
+
+* `std::size_t ambiguous`: the number of methods that have more than one
+overrider, none of which is more specific than the others, for at least one
+combination of virtual arguments.
+
 ## finalize
 
 ### Synopsis