[FOLD]

include/beast/http/basic_headers.hpp

@@ -386,7 +386,7 @@ class basic_headers
     boost::string_ref
     operator[](boost::string_ref const& name) const;
 
-    /** Clear the contents of the basic_headers. */
+    /// Clear the contents of the basic_headers.
     void
     clear() noexcept;
 
@@ -409,6 +409,7 @@ class basic_headers
         is inserted into the container.
 
         @param name The name of the field.
+
         @param value A string holding the value of the field.
     */
     void
@@ -421,6 +422,7 @@ class basic_headers
         is inserted into the container.
 
         @param name The name of the field
+
         @param value The value of the field. The object will be
         converted to a string using `boost::lexical_cast`.
     */
@@ -434,21 +436,23 @@ class basic_headers
 
     /** Replace a field value.
 
-        The current field value, if any, is removed. Then the
-        specified value is inserted as if by `insert(field, value)`.
+        First removes any values with matching field names, then
+        inserts the new field value.
 
         @param name The name of the field.
+
         @param value A string holding the value of the field.
     */
     void
     replace(boost::string_ref const& name, boost::string_ref value);
 
     /** Replace a field value.
 
-        The current field value, if any, is removed. Then the
-        specified value is inserted as if by `insert(field, value)`.
+        First removes any values with matching field names, then
+        inserts the new field value.
 
         @param name The name of the field
+
         @param value The value of the field. The object will be
         converted to a string using `boost::lexical_cast`.
     */