Updated concept documentation.

Author: glynos

boost/network/message.hpp

@@ -24,6 +24,8 @@
 // include wrappers base
 #include <boost/network/detail/wrapper_base.hpp>
 
+#include <boost/network/message/message_concept.hpp>
+
 /** message.hpp
  *
  * This header file implements the common message type which
@@ -98,8 +100,10 @@ namespace boost { namespace network {
         left.swap(right);
     }
 
-} // namespace network
+BOOST_CONCEPT_ASSERT((Message<basic_message<boost::network::tags::default_string> >));
+BOOST_CONCEPT_ASSERT((Message<basic_message<boost::network::tags::default_wstring> >));
 
+} // namespace network
 } // namespace boost
 
 #include <boost/network/message/directives.hpp>

boost/network/message/message_concept.hpp

@@ -0,0 +1,49 @@
+//            Copyright (c) Glyn Matthews 2010.
+// Distributed under the Boost Software License, Version 1.0.
+//    (See accompanying file LICENSE_1_0.txt or copy at
+//          http://www.boost.org/LICENSE_1_0.txt)
+
+
+#ifndef __BOOST_NETWORK_MESSAGE_MESSAGE_CONCEPT_INC__
+# define __BOOST_NETWORK_MESSAGE_MESSAGE_CONCEPT_INC__
+
+
+# include <boost/concept_check.hpp>
+
+
+namespace boost {
+namespace network {
+template <
+    class M
+    >
+struct Message
+    : DefaultConstructible<M>,
+      CopyConstructible<M>,
+      Assignable<M> {
+    typedef typename M::string_type string_type;
+    typedef typename M::headers_container_type headers_container_type;
+
+    BOOST_CONCEPT_USAGE(Message) {
+        M message_;
+        swap(message, message_);
+        
+        headers_container_type &headers_ = message.headers();
+        string_type &body_ = message.body();
+        string_type &source_ = message.source();
+        string_type &destination_ = message.destination();
+
+        (void)headers_;
+        (void)body_;
+        (void)source_;
+        (void)destination_;
+    }
+
+private:
+
+    M message;
+};
+} // namespace network
+} // namespace boost
+
+
+#endif // __BOOST_NETWORK_MESSAGE_MESSAGE_CONCEPT_INC__

libs/network/doc/message_concept.qbk

@@ -8,17 +8,9 @@
 
 [section:message_concept Message Concept]
 
-__message__ is
-[@http://www.boost.org/doc/html/DefaultConstructible.html
-DefaultConstructible],
-[@http://www.boost.org/doc/html/CopyConstructible.html
-CopyConstructible] and [@http://www.boost.org/doc/html/Assignable.html
-Assignable].
-
-[heading Description]
-
 A type models the Message Concept if the type adheres to the following
-usage semantics, and is DefaultConstructible and EqualityComparable.
+usage semantics, and is __default_constructible__,
+__copy_constructible__ and __assignable__.
 
 [variablelist Notation
     [[`M`] [A Message Type.]]

libs/network/doc/network.qbk

@@ -35,6 +35,10 @@
 [def __mozilla_netlib__ [@http://www.mozilla.org/projects/netlib/ mozilla-netlib]]
 [def __sf_cpp_netlib__ [@http://sourceforge.net/projects/cpp-netlib/ sourceforge]]
 [def __github__ [@http://github.com/mikhailberis/cpp-netlib github]]
+[def __default_constructible__ [@http://www.boost.org/doc/html/DefaultConstructible.html DefaultConstructible]]
+[def __copy_constructible__ [@http://www.boost.org/doc/html/CopyConstructible.html CopyConstructible]]
+[def __assignable__ [@http://www.boost.org/doc/html/Assignable.html Assignable]]
+[def __equality_comparable__ [@http://www.boost.org/doc/html/Assignable.html Assignable]]
 
 
 [def __quick_start__ quick start]

libs/network/doc/uri_concept.qbk

@@ -8,18 +8,9 @@
 
 [section:uri_concept URI Concepts]
 
-This page describes the URI Concepts implemented within cpp-netlib.
-The following concepts are also implemented as Boost.Concept_check
-types enforced by the URI library.
-
-URI Concepts are organized into a hierarchy of conepts.
-
-[heading Description]
-
 A type models the URI Concept if the type adheres to the following
-usage semantics, and is [@http://www.boost.org/doc/html/DefaultConstructible.html
-DefaultConstructible] and [@http://www.boost.org/doc/html/EqualityComparable.html
-EqualityComparable].
+usage semantics, and is __default_constructible__ and
+__equality_comparable__.
 
 [variablelist Notation
     [[`U`] [A URI Type.]]