feat docs: fix issues noted by doxygen

Tests: протестировано локальноб на прод не влияет
commit_hash:364ea8c9ac89ed522a40ea570cccfc3da4f5db18

Author: apolukhin

core/include/userver/clients/http/response.hpp

@@ -57,7 +57,7 @@ class Response final {
     enum class RaiseIncludeBody : std::uint8_t { kNo = 0, kYes = 1 };
 
     /// @brief Raise an exception depending on the response status.
-    ///        The body of the response may be included in the exception depending on the @param include_body.
+    ///        The body of the response may be included in the exception depending on the \c include_body.
     ///
     /// @throws HttpClientException for statuses [400; 500)
     /// @throws HttpServerException for statuses [500; 600)

core/include/userver/components/component_base.hpp

@@ -60,7 +60,7 @@ class ComponentBase : public RawComponentBase {
     /// active requests until this deadline (unless those requests finish earlier).
     /// And it might completely shutdown requests processing when the deadline is reached
     /// (or when no active requests left).
-    void OnGracefulShutdown(engine::Deadline /*serving_shutdown_deadline*/) override;
+    void OnGracefulShutdown(engine::Deadline serving_shutdown_deadline) override;
 
     /// Component may use this function to stop doing work before the stop of the
     /// components that depend on it.

core/include/userver/engine/io/multicast_membership.hpp

@@ -48,7 +48,6 @@ class IpMreq final {
     int GetLeaveSocketOption() const noexcept { return (family_ == AF_INET ? IP_DROP_MEMBERSHIP : IPV6_LEAVE_GROUP); }
 
     /// Returns appropriate size for setsockopt based on address family.
-    /// @param domain Socket domain (AF_INET or AF_INET6)
     size_t Size() const noexcept { return (family_ == AF_INET ? sizeof(struct ip_mreqn) : sizeof(struct ipv6_mreq)); }
 
 private:

core/include/userver/websocket/connection.hpp

@@ -1,7 +1,7 @@
 #pragma once
 
 /// @file userver/websocket/connection.hpp
-/// @brief @copybrief server::websocket::WebSocketConnection
+/// @brief @copybrief websocket::WebSocketConnection
 
 #include <memory>
 

grpc/include/userver/ugrpc/client/completion_status.hpp

@@ -14,7 +14,7 @@ USERVER_NAMESPACE_BEGIN
 
 namespace ugrpc::client {
 
-/// @ingroup userver_ugrpc
+/// @ingroup userver_clients
 ///
 /// @brief Special completion types for gRPC client calls that don't result in a normal `grpc::Status`.
 ///
@@ -56,7 +56,7 @@ std::string_view ToString(SpecialCaseCompletionType type);
 /// @brief Convert SpecialCaseCompletionType to human-readable description.
 std::string_view GetSpecialCaseCompletionTypeDescription(SpecialCaseCompletionType type);
 
-/// @ingroup userver_ugrpc
+/// @ingroup userver_clients
 ///
 /// @brief Result type for gRPC client call completion.
 ///

grpc/include/userver/ugrpc/tests/simple_client_middleware_pipeline.hpp

@@ -11,6 +11,7 @@ USERVER_NAMESPACE_BEGIN
 
 namespace ugrpc::tests {
 
+/// @brief RPC client middleware pipeline for tests
 using SimpleClientMiddlewarePipeline = USERVER_NAMESPACE::middlewares::impl::SimpleMiddlewarePipeline<
     ugrpc::client::MiddlewareBase,
     ugrpc::client::ClientInfo>;

kafka/include/userver/kafka/exceptions.hpp

@@ -165,7 +165,6 @@ class SeekInvalidArgumentException final : public std::invalid_argument {
 };
 
 /// @brief Fatal librdkafka consumer error; polling stops and consumer is recreated.
-/// @ref ConsumerImpl::ThrowIfRestartRequired
 class ConsumerRestartRequiredException final : public std::runtime_error {
 public:
     explicit ConsumerRestartRequiredException(const std::string& message);

libraries/grpc-protovalidate/include/userver/grpc-protovalidate/client/exceptions.hpp

@@ -1,6 +1,6 @@
 #pragma once
 
-/// @file
+/// @file userver/grpc-protovalidate/client/exceptions.hpp
 /// @brief Exceptions thrown by gRPC client validator middleware
 
 #include <userver/grpc-protovalidate/buf_validate.hpp>
@@ -16,7 +16,7 @@ class BaseError : public ugrpc::client::RpcError {
     using ugrpc::client::RpcError::RpcError;
 };
 
-/// @brief Base grpc_protovalidate error with @ref buf::validate::ValidationResult.
+/// @brief Base grpc_protovalidate error with `buf::validate::ValidationResult`.
 class MessageError : public BaseError {
 public:
     MessageError(

libraries/proto-structs/include/userver/proto-structs/io/std/chrono/time_point.hpp

@@ -1,6 +1,6 @@
 #pragma once
 
-/// @file userver/proto-structs/io/std/chrono/time_point_fwd.hpp
+/// @file userver/proto-structs/io/std/chrono/time_point.hpp
 /// @brief Provides `std::chrono::time_point` proto struct field support.
 
 #include <chrono>

libraries/proto-structs/include/userver/proto-structs/io/userver/decimal64/decimal.hpp

@@ -1,6 +1,6 @@
 #pragma once
 
-/// @file userver/proto-structs/io/userver/decimal64/decimal64.hpp
+/// @file userver/proto-structs/io/userver/decimal64/decimal.hpp
 /// @brief Provides `userver::decimal64::Decimal` proto struct field support.
 
 #include <userver/decimal64/decimal64.hpp>