diff --git a/CMakeLists.txt b/CMakeLists.txt index 2b5e356c..74bc1516 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -218,6 +218,8 @@ IF (DOXYGEN_FOUND) COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_c COMMAND ${CMAKE_COMMAND} -E echo "FILE_PATTERNS = *.h" >> ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_c COMMAND ${CMAKE_COMMAND} -E echo "OUTPUT_DIRECTORY = doc_c" >> ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_c + COMMAND ${CMAKE_COMMAND} -E echo "INPUT = ${CMAKE_CURRENT_SOURCE_DIR}/include" >> ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_c + COMMAND ${CMAKE_COMMAND} -E echo "EXTRACT_ALL = YES" >> ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_c COMMAND ${CMAKE_COMMAND} -E echo "PROJECT_NAME = \"MessagePack for C\"" >> ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_c COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_c VERBATIM @@ -227,6 +229,8 @@ IF (DOXYGEN_FOUND) COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_cpp COMMAND ${CMAKE_COMMAND} -E echo "FILE_PATTERNS = *.hpp" >> ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_cpp COMMAND ${CMAKE_COMMAND} -E echo "OUTPUT_DIRECTORY = doc_cpp" >> ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_cpp + COMMAND ${CMAKE_COMMAND} -E echo "INPUT = ${CMAKE_CURRENT_SOURCE_DIR}/include" >> ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_cpp + COMMAND ${CMAKE_COMMAND} -E echo "EXTRACT_ALL = YES" >> ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_cpp COMMAND ${CMAKE_COMMAND} -E echo "PROJECT_NAME = \"MessagePack for C++\"" >> ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_cpp COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile_cpp VERBATIM diff --git a/erb/cpp03_define.hpp.erb b/erb/cpp03_define.hpp.erb index 65463156..fb9ebe30 100644 --- a/erb/cpp03_define.hpp.erb +++ b/erb/cpp03_define.hpp.erb @@ -42,7 +42,9 @@ // MSGPACK_ADD_ENUM must be used in the global namespace. #define MSGPACK_ADD_ENUM(enum_name) \ namespace msgpack { \ + /** @cond */ \ MSGPACK_API_VERSION_NAMESPACE(v1) { \ + /** @endcond */ \ namespace adaptor { \ template<> \ struct convert { \ @@ -73,18 +75,22 @@ } \ }; \ } \ + /** @cond */ \ } \ + /** @endcond */ \ } namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { - +/// @cond <% GENERATION_LIMIT = 31 %> template , typename A<%=i%> = void<%}%>> struct define; - +/// @endcond template <> struct define<> { @@ -106,6 +112,8 @@ struct define<> { o->via.array.size = 0; } }; + +/// @cond <%0.upto(GENERATION_LIMIT) {|i|%> template , typename A<%=j%><%}%>> struct define, A<%=j%><%}%>> { @@ -144,11 +152,14 @@ struct define, A<%=j%><%}%>> { A<%=j%>& a<%=j%>;<%}%> }; <%}%> +/// @endcond inline define<> make_define() { return define<>(); } + +/// @cond <%0.upto(GENERATION_LIMIT) {|i|%> template , typename A<%=j%><%}%>> define, A<%=j%><%}%>> make_define(A0& a0<%1.upto(i) {|j|%>, A<%=j%>& a<%=j%><%}%>) @@ -156,9 +167,12 @@ define, A<%=j%><%}%>> make_define(A0& a0<%1.upto(i) {|j|%>, return define, A<%=j%><%}%>>(a0<%1.upto(i) {|j|%>, a<%=j%><%}%>); } <%}%> +/// @endcond } // namespace type +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/erb/cpp03_msgpack_tuple.hpp.erb b/erb/cpp03_msgpack_tuple.hpp.erb index 6f5ef501..a094deef 100644 --- a/erb/cpp03_msgpack_tuple.hpp.erb +++ b/erb/cpp03_msgpack_tuple.hpp.erb @@ -24,7 +24,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { @@ -32,8 +34,10 @@ namespace type { // FIXME operator!= <% GENERATION_LIMIT = 31 %> +/// @cond template , typename A<%=i%> = void<%}%>> struct tuple; +/// @endcond template struct tuple_element; @@ -68,6 +72,7 @@ struct tuple_type { typedef const T& transparent_reference; }; +/// @cond <%0.upto(GENERATION_LIMIT) {|i|%> <%0.upto(i) {|j|%> template , typename A<%=k%><%}%>> @@ -92,6 +97,7 @@ private: }; <%}%> <%}%> +/// @endcond template <> struct tuple<> { @@ -99,6 +105,8 @@ struct tuple<> { tuple(msgpack::object const& o) { o.convert(*this); } typedef tuple<> value_type; }; + +/// @cond <%0.upto(GENERATION_LIMIT) {|i|%> template , typename A<%=j%><%}%>> struct tuple, A<%=j%><%}%>> { @@ -122,11 +130,14 @@ template , typename A<%=j%><%}%>> inline typename type::const_tuple_element, A<%=j%><%}%>>, N>::const_reference get(type::tuple, A<%=j%><%}%>> const& t) { return t.template get(); } <%}%> +/// @endcond inline tuple<> make_tuple() { return tuple<>(); } + +/// @cond <%0.upto(GENERATION_LIMIT) {|i|%> template , typename A<%=j%><%}%>> inline tuple, A<%=j%><%}%>> make_tuple(typename tuple_type::transparent_reference a0<%1.upto(i) {|j|%>, typename tuple_type>::transparent_reference a<%=j%><%}%>) @@ -134,6 +145,7 @@ inline tuple, A<%=j%><%}%>> make_tuple(typename tuple_type< return tuple, A<%=j%><%}%>>(a0<%1.upto(i) {|j|%>, a<%=j%><%}%>); } <%}%> +/// @endcond } // namespace type @@ -149,6 +161,7 @@ struct convert > { } }; +/// @cond <%0.upto(GENERATION_LIMIT) {|i|%> template , typename A<%=j%><%}%>> struct convert, A<%=j%><%}%>> > { @@ -164,6 +177,7 @@ struct convert, A<%=j%><%}%>> > { } }; <%}%> +/// @endcond template <> struct pack > { @@ -176,6 +190,7 @@ struct pack > { } }; +/// @cond <%0.upto(GENERATION_LIMIT) {|i|%> template , typename A<%=j%><%}%>> struct pack, A<%=j%><%}%>> > { @@ -190,6 +205,7 @@ struct pack, A<%=j%><%}%>> > { } }; <%}%> +/// @endcond template <> struct object_with_zone > { @@ -202,6 +218,7 @@ struct object_with_zone > { } }; +/// @cond <%0.upto(GENERATION_LIMIT) {|i|%> template , typename A<%=j%><%}%>> struct object_with_zone, A<%=j%><%}%>> > { @@ -216,10 +233,13 @@ struct object_with_zone, A<%=j%><%}%>> > { } }; <%}%> +/// @endcond } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/erb/cpp03_zone.hpp.erb b/erb/cpp03_zone.hpp.erb index d1a4a5d9..963c4486 100644 --- a/erb/cpp03_zone.hpp.erb +++ b/erb/cpp03_zone.hpp.erb @@ -35,7 +35,9 @@ <% GENERATION_LIMIT = 15 %> namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond class zone { struct finalizer { @@ -179,10 +181,12 @@ public: { ::operator delete(p, place); } + /// @cond <%0.upto(GENERATION_LIMIT) {|i|%> template , typename A<%=j%><%}%>> T* allocate(<%=(1..i).map{|j|"A#{j} a#{j}"}.join(', ')%>); <%}%> + /// @endcond private: void undo_allocate(size_t size); @@ -304,6 +308,7 @@ inline void zone::undo_allocate(size_t size) m_chunk_list.m_free += size; } +/// @cond <%0.upto(GENERATION_LIMIT) {|i|%> template , typename A<%=j%><%}%>> T* zone::allocate(<%=(1..i).map{|j|"A#{j} a#{j}"}.join(', ')%>) @@ -324,8 +329,11 @@ T* zone::allocate(<%=(1..i).map{|j|"A#{j} a#{j}"}.join(', ')%>) } } <%}%> +/// @endcond +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/adaptor_base.hpp b/include/msgpack/adaptor/adaptor_base.hpp index e64d4e93..e5f1560c 100644 --- a/include/msgpack/adaptor/adaptor_base.hpp +++ b/include/msgpack/adaptor/adaptor_base.hpp @@ -22,7 +22,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond template class packer; @@ -80,7 +82,10 @@ void operator<< (msgpack::object::with_zone& o, T const& v) { adaptor::object_with_zone()(o, v); } +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond + } // namespace msgpack diff --git a/include/msgpack/adaptor/bool.hpp b/include/msgpack/adaptor/bool.hpp index a12e4780..abd914ed 100644 --- a/include/msgpack/adaptor/bool.hpp +++ b/include/msgpack/adaptor/bool.hpp @@ -23,7 +23,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -63,7 +65,9 @@ struct object_with_zone { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/char_ptr.hpp b/include/msgpack/adaptor/char_ptr.hpp index ff4b4e20..14f82ea7 100644 --- a/include/msgpack/adaptor/char_ptr.hpp +++ b/include/msgpack/adaptor/char_ptr.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -154,7 +156,9 @@ struct object { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/check_container_size.hpp b/include/msgpack/adaptor/check_container_size.hpp index 41fc898f..5fcc1289 100644 --- a/include/msgpack/adaptor/check_container_size.hpp +++ b/include/msgpack/adaptor/check_container_size.hpp @@ -23,7 +23,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond struct container_size_overflow : public std::runtime_error { explicit container_size_overflow(const std::string& msg) @@ -54,7 +56,9 @@ inline uint32_t checked_get_container_size(T size) { } +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/cpp11/array.hpp b/include/msgpack/adaptor/cpp11/array.hpp index e26c53ce..d1bc7ca5 100644 --- a/include/msgpack/adaptor/cpp11/array.hpp +++ b/include/msgpack/adaptor/cpp11/array.hpp @@ -27,7 +27,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -80,7 +82,9 @@ struct object_with_zone> { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/cpp11/array_char.hpp b/include/msgpack/adaptor/cpp11/array_char.hpp index 260c4dc9..206a3f68 100644 --- a/include/msgpack/adaptor/cpp11/array_char.hpp +++ b/include/msgpack/adaptor/cpp11/array_char.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -86,7 +88,9 @@ struct object_with_zone> { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/cpp11/forward_list.hpp b/include/msgpack/adaptor/cpp11/forward_list.hpp index 5eb934bc..337fc20a 100644 --- a/include/msgpack/adaptor/cpp11/forward_list.hpp +++ b/include/msgpack/adaptor/cpp11/forward_list.hpp @@ -27,7 +27,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -76,7 +78,9 @@ struct object_with_zone> { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/cpp11/tuple.hpp b/include/msgpack/adaptor/cpp11/tuple.hpp index 69a5ef6a..f7a7ea37 100644 --- a/include/msgpack/adaptor/cpp11/tuple.hpp +++ b/include/msgpack/adaptor/cpp11/tuple.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond // --- Pack from tuple to packer stream --- template @@ -163,7 +165,9 @@ struct object_with_zone> { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/cpp11/unordered_map.hpp b/include/msgpack/adaptor/cpp11/unordered_map.hpp index dbb10845..d90ab0f4 100644 --- a/include/msgpack/adaptor/cpp11/unordered_map.hpp +++ b/include/msgpack/adaptor/cpp11/unordered_map.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -146,7 +148,9 @@ struct object_with_zone> { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/cpp11/unordered_set.hpp b/include/msgpack/adaptor/cpp11/unordered_set.hpp index b4e4dd81..386e1100 100644 --- a/include/msgpack/adaptor/cpp11/unordered_set.hpp +++ b/include/msgpack/adaptor/cpp11/unordered_set.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -139,7 +141,9 @@ struct object_with_zone> { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/deque.hpp b/include/msgpack/adaptor/deque.hpp index 3d4b8ceb..42a5740b 100644 --- a/include/msgpack/adaptor/deque.hpp +++ b/include/msgpack/adaptor/deque.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -84,7 +86,9 @@ struct object_with_zone > { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/detail/cpp03_define.hpp b/include/msgpack/adaptor/detail/cpp03_define.hpp index fe018058..7635b936 100644 --- a/include/msgpack/adaptor/detail/cpp03_define.hpp +++ b/include/msgpack/adaptor/detail/cpp03_define.hpp @@ -42,7 +42,9 @@ // MSGPACK_ADD_ENUM must be used in the global namespace. #define MSGPACK_ADD_ENUM(enum_name) \ namespace msgpack { \ + /** @cond */ \ MSGPACK_API_VERSION_NAMESPACE(v1) { \ + /** @endcond */ \ namespace adaptor { \ template<> \ struct convert { \ @@ -73,18 +75,22 @@ } \ }; \ } \ + /** @cond */ \ } \ + /** @endcond */ \ } namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { - +/// @cond template struct define; - +/// @endcond template <> struct define<> { @@ -107,6 +113,8 @@ struct define<> { } }; +/// @cond + template struct define { typedef define value_type; @@ -3275,12 +3283,15 @@ struct define make_define() { return define<>(); } +/// @cond + template define make_define(A0& a0) { @@ -3473,9 +3484,12 @@ define(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20, a21, a22, a23, a24, a25, a26, a27, a28, a29, a30, a31); } +/// @endcond } // namespace type +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/detail/cpp03_msgpack_tuple.hpp b/include/msgpack/adaptor/detail/cpp03_msgpack_tuple.hpp index 8607b599..f84b43ca 100644 --- a/include/msgpack/adaptor/detail/cpp03_msgpack_tuple.hpp +++ b/include/msgpack/adaptor/detail/cpp03_msgpack_tuple.hpp @@ -24,7 +24,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { @@ -32,8 +34,10 @@ namespace type { // FIXME operator!= +/// @cond template struct tuple; +/// @endcond template struct tuple_element; @@ -68,6 +72,7 @@ struct tuple_type { typedef const T& transparent_reference; }; +/// @cond template @@ -9175,6 +9180,7 @@ private: }; +/// @endcond template <> struct tuple<> { @@ -9183,6 +9189,8 @@ struct tuple<> { typedef tuple<> value_type; }; +/// @cond + template struct tuple { typedef tuple value_type; @@ -10383,12 +10391,15 @@ template , N>::const_reference get(type::tuple const& t) { return t.template get(); } +/// @endcond inline tuple<> make_tuple() { return tuple<>(); } +/// @cond + template inline tuple make_tuple(typename tuple_type::transparent_reference a0) { @@ -10581,6 +10592,7 @@ inline tuple(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20, a21, a22, a23, a24, a25, a26, a27, a28, a29, a30, a31); } +/// @endcond } // namespace type @@ -10596,6 +10608,7 @@ struct convert > { } }; +/// @cond template struct convert > { @@ -12037,6 +12050,7 @@ struct convert struct pack > { @@ -12049,6 +12063,7 @@ struct pack > { } }; +/// @cond template struct pack > { @@ -12962,6 +12977,7 @@ struct pack struct object_with_zone > { @@ -12974,6 +12990,7 @@ struct object_with_zone > { } }; +/// @cond template struct object_with_zone > { @@ -13887,10 +13904,13 @@ struct object_with_zone \ struct convert { \ @@ -79,11 +81,15 @@ } \ }; \ } \ + /** @cond */ \ } \ + /** @endcond */ \ } namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { template @@ -185,7 +191,9 @@ define make_define(Args&... args) } } // namespace type +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack #endif // MSGPACK_CPP11_DEFINE_HPP diff --git a/include/msgpack/adaptor/detail/cpp11_msgpack_tuple.hpp b/include/msgpack/adaptor/detail/cpp11_msgpack_tuple.hpp index 24393329..88e57c08 100644 --- a/include/msgpack/adaptor/detail/cpp11_msgpack_tuple.hpp +++ b/include/msgpack/adaptor/detail/cpp11_msgpack_tuple.hpp @@ -25,7 +25,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { // tuple @@ -224,7 +226,9 @@ template } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +///@endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/fixint.hpp b/include/msgpack/adaptor/fixint.hpp index b6abe6b1..31bd0cdb 100644 --- a/include/msgpack/adaptor/fixint.hpp +++ b/include/msgpack/adaptor/fixint.hpp @@ -24,7 +24,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { @@ -295,7 +297,9 @@ struct object_with_zone { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/float.hpp b/include/msgpack/adaptor/float.hpp index a31487c1..c48a2146 100644 --- a/include/msgpack/adaptor/float.hpp +++ b/include/msgpack/adaptor/float.hpp @@ -24,7 +24,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond // FIXME check overflow, underflow @@ -120,7 +122,9 @@ struct object_with_zone { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/int.hpp b/include/msgpack/adaptor/int.hpp index 59fe1cf3..c605b249 100644 --- a/include/msgpack/adaptor/int.hpp +++ b/include/msgpack/adaptor/int.hpp @@ -24,7 +24,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1){ +/// @endcond namespace type { namespace detail { @@ -425,7 +427,9 @@ struct object_with_zone { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/list.hpp b/include/msgpack/adaptor/list.hpp index 49980d63..2df460c6 100644 --- a/include/msgpack/adaptor/list.hpp +++ b/include/msgpack/adaptor/list.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -84,7 +86,9 @@ struct object_with_zone > { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/map.hpp b/include/msgpack/adaptor/map.hpp index 97cb4e3c..4cf78219 100644 --- a/include/msgpack/adaptor/map.hpp +++ b/include/msgpack/adaptor/map.hpp @@ -28,7 +28,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { @@ -226,7 +228,9 @@ struct object_with_zone > { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/nil.hpp b/include/msgpack/adaptor/nil.hpp index f6d2bfa7..2f99f1ad 100644 --- a/include/msgpack/adaptor/nil.hpp +++ b/include/msgpack/adaptor/nil.hpp @@ -23,7 +23,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { @@ -73,8 +75,9 @@ inline void msgpack::object::as() const convert(v); } - +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/pair.hpp b/include/msgpack/adaptor/pair.hpp index f6556060..f7a6784d 100644 --- a/include/msgpack/adaptor/pair.hpp +++ b/include/msgpack/adaptor/pair.hpp @@ -24,7 +24,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -64,7 +66,9 @@ struct object_with_zone > { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/raw.hpp b/include/msgpack/adaptor/raw.hpp index db96ccaf..6e07275c 100644 --- a/include/msgpack/adaptor/raw.hpp +++ b/include/msgpack/adaptor/raw.hpp @@ -25,7 +25,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { @@ -103,7 +105,9 @@ struct object_with_zone { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/set.hpp b/include/msgpack/adaptor/set.hpp index a1b41e2f..c44b0b82 100644 --- a/include/msgpack/adaptor/set.hpp +++ b/include/msgpack/adaptor/set.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -138,7 +140,9 @@ struct object_with_zone > { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/string.hpp b/include/msgpack/adaptor/string.hpp index 4472137b..4fc5fdd7 100644 --- a/include/msgpack/adaptor/string.hpp +++ b/include/msgpack/adaptor/string.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -83,7 +85,9 @@ struct object_with_zone { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/tr1/unordered_map.hpp b/include/msgpack/adaptor/tr1/unordered_map.hpp index 9d07430a..793f4cc2 100644 --- a/include/msgpack/adaptor/tr1/unordered_map.hpp +++ b/include/msgpack/adaptor/tr1/unordered_map.hpp @@ -45,7 +45,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -164,7 +166,9 @@ struct object_with_zone > { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/tr1/unordered_set.hpp b/include/msgpack/adaptor/tr1/unordered_set.hpp index 25582da7..6512ac37 100644 --- a/include/msgpack/adaptor/tr1/unordered_set.hpp +++ b/include/msgpack/adaptor/tr1/unordered_set.hpp @@ -45,7 +45,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -158,7 +160,9 @@ struct object_with_zone > { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/vector.hpp b/include/msgpack/adaptor/vector.hpp index 1ae30197..98103040 100644 --- a/include/msgpack/adaptor/vector.hpp +++ b/include/msgpack/adaptor/vector.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -88,7 +90,9 @@ struct object_with_zone > { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/vector_bool.hpp b/include/msgpack/adaptor/vector_bool.hpp index 80e21b4b..516c552c 100644 --- a/include/msgpack/adaptor/vector_bool.hpp +++ b/include/msgpack/adaptor/vector_bool.hpp @@ -24,7 +24,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -85,7 +87,9 @@ struct object_with_zone > { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/adaptor/vector_char.hpp b/include/msgpack/adaptor/vector_char.hpp index c4226591..f59a0ef4 100644 --- a/include/msgpack/adaptor/vector_char.hpp +++ b/include/msgpack/adaptor/vector_char.hpp @@ -26,7 +26,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace adaptor { @@ -86,7 +88,9 @@ struct object_with_zone > { } // namespace adaptor +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/cpp_config.hpp b/include/msgpack/cpp_config.hpp index 26ac86ec..f9cf3f3f 100644 --- a/include/msgpack/cpp_config.hpp +++ b/include/msgpack/cpp_config.hpp @@ -44,7 +44,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond template struct unique_ptr : std::auto_ptr { @@ -75,7 +77,9 @@ template struct enable_if { }; +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack @@ -86,7 +90,9 @@ struct enable_if { #include namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond // unique_ptr using std::unique_ptr; @@ -98,7 +104,9 @@ MSGPACK_API_VERSION_NAMESPACE(v1) { using std::swap; using std::enable_if; +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/detail/cpp03_zone.hpp b/include/msgpack/detail/cpp03_zone.hpp index b2ace027..08a29144 100644 --- a/include/msgpack/detail/cpp03_zone.hpp +++ b/include/msgpack/detail/cpp03_zone.hpp @@ -35,7 +35,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond class zone { struct finalizer { @@ -179,6 +181,7 @@ public: { ::operator delete(p, place); } + /// @cond template T* allocate(); @@ -228,6 +231,7 @@ public: template T* allocate(A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6, A7 a7, A8 a8, A9 a9, A10 a10, A11 a11, A12 a12, A13 a13, A14 a14, A15 a15); + /// @endcond private: void undo_allocate(size_t size); @@ -349,6 +353,7 @@ inline void zone::undo_allocate(size_t size) m_chunk_list.m_free += size; } +/// @cond template T* zone::allocate() @@ -654,8 +659,11 @@ T* zone::allocate(A1 a1, A2 a2, A3 a3, A4 a4, A5 a5, A6 a6, A7 a7, A8 a8, A9 a9, } } +/// @endcond +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/detail/cpp11_zone.hpp b/include/msgpack/detail/cpp11_zone.hpp index 632dd10a..4edd8434 100644 --- a/include/msgpack/detail/cpp11_zone.hpp +++ b/include/msgpack/detail/cpp11_zone.hpp @@ -36,7 +36,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond class zone { private: @@ -361,7 +363,9 @@ T* zone::allocate(Args... args) } } +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/fbuffer.hpp b/include/msgpack/fbuffer.hpp index f95b71ff..8ff0b44f 100644 --- a/include/msgpack/fbuffer.hpp +++ b/include/msgpack/fbuffer.hpp @@ -25,7 +25,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond class fbuffer { public: @@ -57,7 +59,9 @@ private: FILE* m_file; }; +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/iterator.hpp b/include/msgpack/iterator.hpp index 8ccd94e8..f7c7c75c 100644 --- a/include/msgpack/iterator.hpp +++ b/include/msgpack/iterator.hpp @@ -24,8 +24,10 @@ namespace msgpack { + /// @cond MSGPACK_API_VERSION_NAMESPACE(MSGPACK_DEFAULT_API_NS) { + /// @endcond inline object_kv* begin(object_map &map) { return map.ptr; } inline const object_kv* begin(const object_map &map) { return map.ptr; } inline object_kv* end(object_map &map) { return map.ptr + map.size; } @@ -35,7 +37,9 @@ namespace msgpack inline const object* begin(const object_array &array) { return array.ptr; } inline object* end(object_array &array) { return array.ptr + array.size; } inline const object* end(const object_array &array) { return array.ptr + array.size; } + /// @cond } + /// @endcond } #endif // !defined(MSGPACK_USE_CPP03) diff --git a/include/msgpack/object.hpp b/include/msgpack/object.hpp index ba95b55a..2bcccc22 100644 --- a/include/msgpack/object.hpp +++ b/include/msgpack/object.hpp @@ -32,7 +32,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond struct object::implicit_type { implicit_type(object const& o) : obj(o) { } @@ -627,7 +629,9 @@ inline std::ostream& operator<< (std::ostream& s, const msgpack::object& o) return s; } +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/object_fwd.hpp b/include/msgpack/object_fwd.hpp index c84b5730..21483bc4 100644 --- a/include/msgpack/object_fwd.hpp +++ b/include/msgpack/object_fwd.hpp @@ -27,7 +27,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace type { @@ -150,7 +152,9 @@ private: with_zone(); }; +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/pack.hpp b/include/msgpack/pack.hpp index dc81271a..3f4c12db 100644 --- a/include/msgpack/pack.hpp +++ b/include/msgpack/pack.hpp @@ -30,7 +30,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond template class packer { @@ -1050,7 +1052,9 @@ inline void packer::pack_imp_int64(T d) } } +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/sbuffer.hpp b/include/msgpack/sbuffer.hpp index 1ac45e84..2db671a0 100644 --- a/include/msgpack/sbuffer.hpp +++ b/include/msgpack/sbuffer.hpp @@ -28,7 +28,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond class sbuffer { public: @@ -127,7 +129,9 @@ private: size_t m_alloc; }; +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/unpack.hpp b/include/msgpack/unpack.hpp index aaa4d05c..af55f28d 100644 --- a/include/msgpack/unpack.hpp +++ b/include/msgpack/unpack.hpp @@ -64,7 +64,9 @@ const size_t COUNTER_SIZE = sizeof(_msgpack_atomic_counter_t); namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond typedef bool (*unpack_reference_func)(msgpack::type::object_type, std::size_t, void*); @@ -1727,7 +1729,9 @@ inline bool unpacker::default_reference_func(msgpack::type::object_type /*type*/ return true; } +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/vrefbuffer.hpp b/include/msgpack/vrefbuffer.hpp index 8eeaa22a..5ea953df 100644 --- a/include/msgpack/vrefbuffer.hpp +++ b/include/msgpack/vrefbuffer.hpp @@ -41,7 +41,9 @@ struct iovec { namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond namespace detail { // int64, uint64, double @@ -289,7 +291,9 @@ private: }; +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/include/msgpack/zbuffer.hpp b/include/msgpack/zbuffer.hpp index 3e1d75d0..688a70b5 100644 --- a/include/msgpack/zbuffer.hpp +++ b/include/msgpack/zbuffer.hpp @@ -33,7 +33,9 @@ namespace msgpack { +/// @cond MSGPACK_API_VERSION_NAMESPACE(v1) { +/// @endcond class zbuffer { public: @@ -164,7 +166,9 @@ private: size_t m_init_size; }; +/// @cond } // MSGPACK_API_VERSION_NAMESPACE(v1) +/// @endcond } // namespace msgpack diff --git a/src/Makefile.am b/src/Makefile.am index a960ea95..7b3f2ea0 100644 --- a/src/Makefile.am +++ b/src/Makefile.am @@ -114,6 +114,8 @@ doxygen_c: cat ../Doxyfile > Doxyfile_c echo "FILE_PATTERNS = *.h" >> Doxyfile_c echo "OUTPUT_DIRECTORY = doc_c" >> Doxyfile_c + echo "INPUT = ../include" >> Doxyfile_c + echo "EXTRACT_ALL = YES" >> Doxyfile_c echo "PROJECT_NAME = \"MessagePack for C\"" >> Doxyfile_c doxygen Doxyfile_c @@ -121,6 +123,8 @@ doxygen_cpp: cat ../Doxyfile > Doxyfile_cpp echo "FILE_PATTERNS = *.hpp" >> Doxyfile_cpp echo "OUTPUT_DIRECTORY = doc_cpp" >> Doxyfile_cpp + echo "INPUT = ../include" >> Doxyfile_cpp + echo "EXTRACT_ALL = YES" >> Doxyfile_cpp echo "PROJECT_NAME = \"MessagePack for C++\"" >> Doxyfile_cpp doxygen Doxyfile_cpp