wip

Author: jll63

doc/basic_policy.adoc

@@ -46,7 +46,7 @@ Defined in <boost/openmethod/policies/basic_policy.hpp>. Also available via
 ### Description
 
 `basic_policy` implements a policy, which consists of a a collection of methods,
-classes, dispatch data, and facets, which specify how to obtain a pointer to a
+classes, dispatch data, and policys, which specify how to obtain a pointer to a
 v-table from an object, how to report errors, whether to perform runtime sanity
 checks, etc.
 
@@ -75,7 +75,7 @@ Creates a new policy from an existing one. _NewPolicy_ does not share static
 variables with the original _Policy_. The new policy does not retain any
 knowledge of the classes and methods registered in the original.
 
-`fork` forks the facets in the policy as well: any facet instantiated from a
+`fork` forks the policys in the policy as well: any policy instantiated from a
 class template is assumed to take a policy as its first template argument. The
 template is re-instantiated with the new policy as the first arguments, while
 the other arguments remain the same.
@@ -87,9 +87,9 @@ template<class... Facets>
 using with;
 ```
 
-Requires:: _Facets_ is a list of classes that derive from `facet`.
+Requires:: _Facets_ is a list of classes that derive from `policy`.
 
-Returns:: A new policy containing _Facets_, and the facets from the original
+Returns:: A new policy containing _Facets_, and the policys from the original
 that do not have the same category as _Facets_.
 
 Examples::
@@ -111,9 +111,9 @@ template<class... Facets>
 using without;
 ```
 
-Requires:: _Facets_ is a list of facet categories.
+Requires:: _Facets_ is a list of policy categories.
 
-Returns:: A new policy containing the facets from the original that do not have
+Returns:: A new policy containing the policys from the original that do not have
 the same category as _Facets_.
 
 Examples::
@@ -130,7 +130,7 @@ Examples::
 struct release;
 ```
 
-A policy that contains facets `std_rtti`, `fast_perfect_hash`, `vptr_vector` and
+A policy that contains policys `std_rtti`, `fast_perfect_hash`, `vptr_vector` and
 `default_error_handler`.
 
 #### debug
@@ -139,7 +139,7 @@ A policy that contains facets `std_rtti`, `fast_perfect_hash`, `vptr_vector` and
 struct debug;
 ```
 
-The `release` policy with additional facet implementations `runtime_checks`,
+The `release` policy with additional policy implementations `runtime_checks`,
 `basic_error_output` and basic_trace_output.
 
 NOTE: `debug` extends `release` but it does not a fork it. Both policies use the

doc/default_error_handler.adoc

@@ -40,7 +40,7 @@ static auto error(const Error& error) -> void;
 ```
 
 Calls the function last set via `set_error_handler` or, if it was never called,
-and if _Policy_ contains an `output` facet, use it to print a description
+and if _Policy_ contains an `output` policy, use it to print a description
 of `error`.
 
 #### error

doc/deferred_static_rtti.adoc

@@ -15,11 +15,11 @@ struct deferred_static_rtti : rtti {};
 
 ### Description
 
-`deferred_static_rtti` is a facet that defers collection of static type ids.
+`deferred_static_rtti` is a policy that defers collection of static type ids.
 
 Some custom RTTI systems rely on static constructors to assign type ids.
 OpenMethod itself relies on static constructors to register classes, methods and
-overriders, calling the `static_type` function from the `rtti` facet in the
+overriders, calling the `static_type` function from the `rtti` policy in the
 process. This can result in collecting the type ids _before_ they have been
-initialized. Adding this facet to a policy moves the collection of type ids to
+initialized. Adding this policy to a policy moves the collection of type ids to
 `initialize`.

doc/error_handler.adoc

@@ -42,10 +42,10 @@ struct type_mismatch_error : openmethod_error {
 
 ### Description
 
-`error_handler` is a facet that handles errors.
+`error_handler` is a policy that handles errors.
 
 When an error is encountered, either during `initialize` or method dispatch, the
-program is terminated via a call to `abort`. If this facet is present in the
+program is terminated via a call to `abort`. If this policy is present in the
 policy, its `error` function is called with an error object. It can prevent
 termination by throwing an exception.
 

doc/error_output.adoc

@@ -8,14 +8,14 @@ Defined in <boost/openmethod/policies/basic_policy.hpp>.
 ```c++
 namespace boost::openmethod::policies {
 
-struct output : facet {};
+struct output : policy {};
 
 } // boost::openmethod::policies
 ```
 
 ### Description
 
-`output` is a facet that provides a stream for writing error messages.
+`output` is a policy that provides a stream for writing error messages.
 
 ### Requirements
 

doc/facet.adoc

@@ -1,5 +1,5 @@
 
-## facet
+## policy
 
 ### Synopsis
 
@@ -8,7 +8,7 @@ Defined in <boost/openmethod/policies/basic_policy.hpp>.
 ```c++
 namespace boost::openmethod::policies {
 
-struct facet {
+struct policy {
     static auto finalize() -> void;
 };
 
@@ -17,7 +17,7 @@ struct facet {
 
 ### Description
 
-`facet` is the base class of all facets. It provides an empty `finalize` static
+`policy` is the base class of all policys. It provides an empty `finalize` static
 function which can be overriden (via shadowing) by derived classes.
 
 ### Members