more doc work, with some changes prompted by the doc

Author: jll63

doc/modules/ROOT/nav.adoc

@@ -11,5 +11,6 @@
 ** xref:error_handling.adoc[Error Handling]
 ** xref:custom_rtti.adoc[Custom RTTI]
 ** xref:dynamic_loading.adoc[Dynamic Loading]
-* xref:reference:boost/openmethod.adoc[Reference (generated)]
-* xref:reference.adoc[Reference (manual)]
+* Reference
+** xref:macros.adoc[Macros]
+** xref:reference:boost/openmethod.adoc[boost::openmethod]

doc/modules/ROOT/pages/BOOST_OPENMETHOD_DEFAULT_REGISTRY.adoc

@@ -1,11 +1,18 @@
+= xref:macros.adoc[Macro] BOOST_OPENMETHOD_DEFAULT_REGISTRY
 
-[#BOOST_OPENMETHOD_DEFAULT_REGISTRY]
+Default value for Registry
 
-## BOOST_OPENMETHOD_DEFAULT_REGISTRY
+== Synopsis
 
-### Description
+Defined in `<https://www.github.com/boostorg/openmethod/blob/develop/include/boost/openmethod/core.hpp#L27[boost/openmethod/core.hpp]>`
 
-The name of the default policy.
+```cpp
+#define BOOST_OPENMETHOD_DEFAULT_REGISTRY ::boost::openmethod::default_registry
+```
+
+== Description
+
+The name of the default registry.
 
 `BOOST_OPENMETHOD_DEFAULT_REGISTRY` is the default value for the `Policy` template
 parameter of `method`, `use_classes`, and other constructs defined in

doc/modules/ROOT/pages/error_processing.adoc

@@ -0,0 +1,31 @@
+[#macros]
+= xref:macros.adoc[Macros]
+:mrdocs:
+
+[cols=2]
+|===
+| Name
+| Description
+| xref:BOOST_OPENMETHOD.adoc[BOOST_OPENMETHOD]
+| Declare a method
+| xref:BOOST_OPENMETHOD_CLASSES.adoc[BOOST_OPENMETHOD_CLASSES]
+| registers classes
+| xref:BOOST_OPENMETHOD_DECLARE_OVERRIDER.adoc[BOOST_OPENMETHOD_DECLARE_OVERRIDER]
+| Declare a method overrider
+| xref:BOOST_OPENMETHOD_DEFAULT_REGISTRY.adoc[BOOST_OPENMETHOD_DEFAULT_REGISTRY]
+| Default registry
+| xref:BOOST_OPENMETHOD_DEFINE_OVERRIDER.adoc[BOOST_OPENMETHOD_DEFINE_OVERRIDER]
+| Define the body of a method overrider
+| xref:BOOST_OPENMETHOD_ID.adoc[BOOST_OPENMETHOD_ID]
+| Generate a method id
+| xref:BOOST_OPENMETHOD_INLINE_OVERRIDE.adoc[BOOST_OPENMETHOD_INLINE_OVERRIDE]
+| Add an overrider to a method as an inline function
+| xref:BOOST_OPENMETHOD_OVERRIDE.adoc[BOOST_OPENMETHOD_OVERRIDE]
+| Add an overrider to a method
+| xref:BOOST_OPENMETHOD_OVERRIDER.adoc[BOOST_OPENMETHOD_OVERRIDER]
+| Return the class template specialization containing an overrider
+| xref:BOOST_OPENMETHOD_OVERRIDERS.adoc[BOOST_OPENMETHOD_OVERRIDERS]
+| Return the class template containing the overriders for all the methods with a given name
+| xref:BOOST_OPENMETHOD_REGISTER.adoc[BOOST_OPENMETHOD_REGISTER]
+| Create a registrar object
+|===

doc/modules/ROOT/pages/macros.adoc

@@ -13,22 +13,24 @@ file-patterns:
 # Filters
 include-symbols:
   - 'boost::openmethod::**'
+implementation-defined:
+  - 'boost::openmethod::detail'
 # see-below:
 #   - 'boost::urls::format_arg'
 # implementation-defined:
 #   - 'boost::openmethod::detail::**'
 exclude-symbols:
-  - 'boost::openmethod::detail::**'
   - 'boost::openmethod::boost_openmethod_bases'
   - 'boost::openmethod::boost_openmethod_registry'
 
 sort-members: false
+# sort-namespace-members-by: location
 extract-friends: false
-implementation-detail: impl
 inherit-base-members: never
 
 # Metadata Extraction
 private-bases: false
+auto-function-metadata: false
 
 # Generator
 generate: adoc