From 73ed503ed5ca76c5b05629a00ddc29d3549a48e8 Mon Sep 17 00:00:00 2001 From: Brad King Date: Tue, 29 Aug 2017 09:43:12 -0400 Subject: jsoncpp: Drop doxygen comments not recognized by Clang Some Clang versions warn with `-Wdocumentation-unknown-command` about the `\internal` and `\snippet` command tag names. --- Utilities/cmjsoncpp/include/json/reader.h | 4 ++-- Utilities/cmjsoncpp/include/json/value.h | 4 ++-- Utilities/cmjsoncpp/include/json/writer.h | 2 +- Utilities/cmjsoncpp/src/lib_json/json_value.cpp | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) (limited to 'Utilities/cmjsoncpp') diff --git a/Utilities/cmjsoncpp/include/json/reader.h b/Utilities/cmjsoncpp/include/json/reader.h index 01414e66db..667246a0bb 100644 --- a/Utilities/cmjsoncpp/include/json/reader.h +++ b/Utilities/cmjsoncpp/include/json/reader.h @@ -356,13 +356,13 @@ public: /** Called by ctor, but you can use this to reset settings_. * \pre 'settings' != NULL (but Json::null is fine) * \remark Defaults: - * \snippet src/lib_json/json_reader.cpp CharReaderBuilderDefaults + * snippet src/lib_json/json_reader.cpp CharReaderBuilderDefaults */ static void setDefaults(Json::Value* settings); /** Same as old Features::strictMode(). * \pre 'settings' != NULL (but Json::null is fine) * \remark Defaults: - * \snippet src/lib_json/json_reader.cpp CharReaderBuilderStrictMode + * snippet src/lib_json/json_reader.cpp CharReaderBuilderStrictMode */ static void strictMode(Json::Value* settings); }; diff --git a/Utilities/cmjsoncpp/include/json/value.h b/Utilities/cmjsoncpp/include/json/value.h index 752636035b..7b90c5a1a7 100644 --- a/Utilities/cmjsoncpp/include/json/value.h +++ b/Utilities/cmjsoncpp/include/json/value.h @@ -787,7 +787,7 @@ public: ValueConstIterator(ValueIterator const& other); private: -/*! \internal Use by Value to create an iterator. +/*! internal Use by Value to create an iterator. */ explicit ValueConstIterator(const Value::ObjectValues::iterator& current); public: @@ -838,7 +838,7 @@ public: ValueIterator(const ValueIterator& other); private: -/*! \internal Use by Value to create an iterator. +/*! internal Use by Value to create an iterator. */ explicit ValueIterator(const Value::ObjectValues::iterator& current); public: diff --git a/Utilities/cmjsoncpp/include/json/writer.h b/Utilities/cmjsoncpp/include/json/writer.h index ca08a6f933..d3ae62b285 100644 --- a/Utilities/cmjsoncpp/include/json/writer.h +++ b/Utilities/cmjsoncpp/include/json/writer.h @@ -135,7 +135,7 @@ public: /** Called by ctor, but you can use this to reset settings_. * \pre 'settings' != NULL (but Json::null is fine) * \remark Defaults: - * \snippet src/lib_json/json_writer.cpp StreamWriterBuilderDefaults + * snippet src/lib_json/json_writer.cpp StreamWriterBuilderDefaults */ static void setDefaults(Json::Value* settings); }; diff --git a/Utilities/cmjsoncpp/src/lib_json/json_value.cpp b/Utilities/cmjsoncpp/src/lib_json/json_value.cpp index c6ee5e9963..f271e5731f 100644 --- a/Utilities/cmjsoncpp/src/lib_json/json_value.cpp +++ b/Utilities/cmjsoncpp/src/lib_json/json_value.cpp @@ -348,7 +348,7 @@ bool Value::CZString::isStaticString() const { return storage_.policy_ == noDupl // ////////////////////////////////////////////////////////////////// // ////////////////////////////////////////////////////////////////// -/*! \internal Default constructor initialization must be equivalent to: +/*! internal Default constructor initialization must be equivalent to: * memset( this, 0, sizeof(Value) ) * This optimization is used in ValueInternalMap fast allocator. */ -- cgit v1.2.1