From 43d43ec1982ec5eeb009c289dc529a237df5a308 Mon Sep 17 00:00:00 2001 From: Anton Karpov Date: Thu, 13 Aug 2026 03:13:25 +0300 Subject: [PATCH] [doc] Drop the dangling \param from empty_formatter The argument of empty_formatter has no name, so \param has nothing to bind to and Doxygen drops the description. The dash currently standing in for the name is not a name either, and it is the only one in the library: 1 of 725 \param tags here, and none in the other Boost libraries. The explanation moves into the description, and the argument gets a commented name the way replace_storage.hpp already writes it. --- include/boost/algorithm/string/formatter.hpp | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/include/boost/algorithm/string/formatter.hpp b/include/boost/algorithm/string/formatter.hpp index ce590c778..7af726c97 100644 --- a/include/boost/algorithm/string/formatter.hpp +++ b/include/boost/algorithm/string/formatter.hpp @@ -75,14 +75,15 @@ namespace boost { Constructs an \c empty_formatter. Empty formatter always returns an empty sequence. - \param - container used to select a correct value_type for the - resulting empty_container<>. + The argument is not used, it only selects a correct value_type for + the resulting empty_container<>. + \return An instance of the \c empty_formatter object. */ template inline detail::empty_formatF< BOOST_STRING_TYPENAME range_value::type> - empty_formatter(const RangeT&) + empty_formatter(const RangeT& /*Input*/) { return detail::empty_formatF< BOOST_STRING_TYPENAME range_value::type>();