[FOLD]

Author: vinniefalco

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

@@ -99,10 +99,32 @@ 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.
 
-NOTE: Individual header fields may have their own additional syntactic
-requirements, many of which are not checked by the library. For example,
-fields whose values represent dates may have particular requirements.
-Consult the relevant specifications document to ensure program correctness.
+Here we build an
+https://tools.ietf.org/html/rfc7231#section-4.3.1[HTTP GET]
+request:
+
+[cols="1a,1a"]
+|Code|Serialized Result
+
+|
+[source,cpp]
+request req( method::get, "/index.htm", version::http_1_1 );
+req.append( field::accept, "text/html" );
+req.append( "User-Agent", "Boost" );
+|
+[literal]
+GET /index.htm HTTP/1.1\r\n
+Accept: text/html\r\n
+User-Agent: Boost\r\n
+\r\n
+
+|===
+
+NOTE: Field-specific syntax (e.g., for date values) is not fully validated by
+this library. It is the application’s responsibility to follow the relevant
+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