Commit 63dc5615 authored by Curtis Li's avatar Curtis Li Committed by Facebook GitHub Bot

Fix some -Wdocumentation errors

Summary:
Fixes a few documentation errors that get surfaced when compiling with the -Wdocumentation flag.

Full explanation of errors with examples here:
https://clang.llvm.org/docs/DiagnosticsReference.html#wdocumentation

Reviewed By: yfeldblum

Differential Revision: D23119100

fbshipit-source-id: 4e84f624e4d81914b78211af4860540498f8110c
parent 49b1f90b
......@@ -118,7 +118,6 @@ FOLLY_ERASE auto fold(Fn&& fn, A&& a, B&& b, Bs&&... bs) {
//! little overhead.
//!
//! \par Example usage:
//! \par
//! \code
//! exception_wrapper globalExceptionWrapper;
//!
......@@ -540,7 +539,7 @@ class exception_wrapper final {
//! Throws the wrapped expression nested into another exception.
//! \pre `bool(*this)`
//! \tparam ex Exception in *this will be thrown nested into ex;
//! \param ex Exception in *this will be thrown nested into ex;
// see std::throw_with_nested() for details on this semantic.
template <class Ex>
[[noreturn]] void throw_with_nested(Ex&& ex) const;
......@@ -601,7 +600,7 @@ class exception_wrapper final {
//! ew.handle(/*...* /, [](...) { /* handle unknown exception */ } )
//! \endcode
//! \pre `!*this`
//! \tparam CatchFns... A pack of unary monomorphic function object types.
//! \tparam CatchFns A pack of unary monomorphic function object types.
//! \param fns A pack of unary monomorphic function objects to be treated as
//! an ordered list of potential exception handlers.
//! \note The handlers may or may not be invoked with an active exception.
......
......@@ -238,11 +238,11 @@ Container&& as_sorted_unique(Container&& container, Compare const& comp) {
* A sorted_vector_set is a container similar to std::set<>, but
* implemented as a sorted array with std::vector<>.
*
* @param class T Data type to store
* @param class Compare Comparison function that imposes a
* @tparam T Data type to store
* @tparam Compare Comparison function that imposes a
* strict weak ordering over instances of T
* @param class Allocator allocation policy
* @param class GrowthPolicy policy object to control growth
* @tparam Allocator allocation policy
* @tparam GrowthPolicy policy object to control growth
*
* @author Aditya Agarwal <aditya@fb.com>
* @author Akhil Wable <akhil@fb.com>
......@@ -758,12 +758,12 @@ using sorted_vector_set = folly::sorted_vector_set<
* A sorted_vector_map is similar to a sorted_vector_set but stores
* <key,value> pairs instead of single elements.
*
* @param class Key Key type
* @param class Value Value type
* @param class Compare Function that can compare key types and impose
* @tparam Key Key type
* @tparam Value Value type
* @tparam Compare Function that can compare key types and impose
* a strict weak ordering over them.
* @param class Allocator allocation policy
* @param class GrowthPolicy policy object to control growth
* @tparam Allocator allocation policy
* @tparam GrowthPolicy policy object to control growth
*
* @author Aditya Agarwal <aditya@fb.com>
* @author Akhil Wable <akhil@fb.com>
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment