On 06/04/21 16:54 +0100, Jonathan Wakely wrote:
A change in Doxygen 1.8.16 means that "// @}" is no longer recognized by
Doxygen, so doesn't close a @{ group. A "///" comment needs to be used.
There are a few cases of /* @} */ which need a similar fix.
Tested powerpc64le-linux. Committed to trunk.
commit 014b6dbcaa80fc46c792c270244e7eeef7dce75f
Author: Jonathan Wakely <jwak...@redhat.com>
Date: Thu Apr 8 18:22:51 2021
libstdc++: Fix more doxygen markup for group close commands
Similar to r11-8009 but for /* @} */ comments this time, which should
be /** @} */ for Doxygen to recognize them.
libstdc++-v3/ChangeLog:
* include/bits/random.h: Fix doxygen group commands.
* include/bits/regex_constants.h: Likewise.
* include/tr1/random.h: Likewise.
diff --git a/libstdc++-v3/include/bits/random.h b/libstdc++-v3/include/bits/random.h
index 877ac3406b6..1b9cc5f16a9 100644
--- a/libstdc++-v3/include/bits/random.h
+++ b/libstdc++-v3/include/bits/random.h
@@ -1675,7 +1675,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
};
};
- /* @} */ // group random_generators
+ /// @} group random_generators
/**
* @addtogroup random_distributions Random Number Distributions
@@ -1951,7 +1951,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
operator>>(std::basic_istream<_CharT, _Traits>&,
std::uniform_real_distribution<_RealType>&);
- /* @} */ // group random_distributions_uniform
+ /// @} group random_distributions_uniform
/**
* @addtogroup random_distributions_normal Normal Distributions
@@ -3506,7 +3506,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
{ return !(__d1 == __d2); }
- /* @} */ // group random_distributions_normal
+ /// @} group random_distributions_normal
/**
* @addtogroup random_distributions_bernoulli Bernoulli Distributions
@@ -4402,7 +4402,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
{ return !(__d1 == __d2); }
- /* @} */ // group random_distributions_bernoulli
+ /// @} group random_distributions_bernoulli
/**
* @addtogroup random_distributions_poisson Poisson Distributions
@@ -6048,9 +6048,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
{ return !(__d1 == __d2); }
- /* @} */ // group random_distributions_poisson
+ /// @} group random_distributions_poisson
- /* @} */ // group random_distributions
+ /// @} *group random_distributions
/**
* @addtogroup random_utilities Random Number Utilities
@@ -6101,9 +6101,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
std::vector<result_type> _M_v;
};
- /* @} */ // group random_utilities
+ /// @} group random_utilities
- /* @} */ // group random
+ /// @} group random
_GLIBCXX_END_NAMESPACE_VERSION
} // namespace std
diff --git a/libstdc++-v3/include/bits/regex_constants.h b/libstdc++-v3/include/bits/regex_constants.h
index 340421a5abd..1c3dd36d57c 100644
--- a/libstdc++-v3/include/bits/regex_constants.h
+++ b/libstdc++-v3/include/bits/regex_constants.h
@@ -409,7 +409,7 @@ namespace regex_constants
///@}
} // namespace regex_constants
-/* @} */ // group regex
+/// @} group regex
_GLIBCXX_END_NAMESPACE_VERSION
} // namespace std
diff --git a/libstdc++-v3/include/tr1/random.h b/libstdc++-v3/include/tr1/random.h
index 57c434f6966..9c79cfd8035 100644
--- a/libstdc++-v3/include/tr1/random.h
+++ b/libstdc++-v3/include/tr1/random.h
@@ -1543,7 +1543,7 @@ namespace tr1
#endif
};
- /* @} */ // group tr1_random_generators
+ /// @} group tr1_random_generators
/**
* @addtogroup tr1_random_distributions Random Number Distributions
@@ -2046,7 +2046,7 @@ namespace tr1
bool _M_easy;
};
- /* @} */ // group tr1_random_distributions_discrete
+ /// @} group tr1_random_distributions_discrete
/**
* @addtogroup tr1_random_distributions_continuous Continuous Distributions
@@ -2403,9 +2403,9 @@ namespace tr1
result_type _M_l_d;
};
- /* @} */ // group tr1_random_distributions_continuous
- /* @} */ // group tr1_random_distributions
- /* @} */ // group tr1_random
+ /// @} group tr1_random_distributions_continuous
+ /// @} group tr1_random_distributions
+ /// @} group tr1_random
}
_GLIBCXX_END_NAMESPACE_VERSION
