[FOLD]

Author: vinniefalco

doc/modules/ROOT/pages/2.messages.adoc

@@ -66,8 +66,8 @@ All containers maintain the following invariants:
 * Any modification that would produce a malformed field or start line
   throws an exception, with strong exception safety guaranteed.
 
-To satisfy these invariants, a default-constructed container provides an
-initial start line:
+To satisfy these invariants, default-constructed containers
+initially consist of a start line:
 
 [source,cpp]
 ----
@@ -99,7 +99,11 @@ obs-fold       = CRLF 1*( SP / HTAB )
 Operations which create or modify fields throw exceptions when the name or
 value do not meet the syntactic requirements of the protocol.
 
-Here we build an
+Although fields can be identified by comparing their names, the library
+provides the field enumeration, which defines a large set of constants for
+well-known field names. Internally, containers maintain a lookup table so
+that specifying fields by enumeration replaces costly string comparisons
+with efficient integer comparisons. Here we build an
 https://tools.ietf.org/html/rfc7231#section-4.3.1[HTTP GET]
 request:
 
@@ -126,10 +130,5 @@ specifications to ensure correct behavior.
 
 
 
-Although fields can be identified by comparing their names, the library
-provides the field enumeration, which defines a large set of constants for
-well-known field names. Internally, containers maintain a lookup table so
-that specifying fields by enumeration replaces costly string comparisons
-with efficient integer comparisons.
 
 Header fields are accessed as a bidirectional range whose value type