]> git.ipfire.org Git - thirdparty/kea.git/commitdiff
[#1210] Fixed some doxygen issues
authorFrancis Dupont <fdupont@isc.org>
Thu, 30 Apr 2020 13:22:35 +0000 (15:22 +0200)
committerFrancis Dupont <fdupont@isc.org>
Thu, 14 May 2020 21:38:33 +0000 (23:38 +0200)
12 files changed:
src/bin/d2/dns_client.h
src/bin/dhcp4/dhcp4_srv.h
src/bin/perfdhcp/stats_mgr.h
src/bin/perfdhcp/test_control.h
src/hooks/dhcp/high_availability/ha_service.h
src/hooks/dhcp/lease_cmds/lease_cmds.cc
src/lib/dhcpsrv/cql_lease_mgr.cc
src/lib/dhcpsrv/network.h
src/lib/dhcpsrv/parsers/dhcp_parsers.h
src/lib/dhcpsrv/parsers/shared_network_parser.h
src/lib/hooks/library_handle.h
src/lib/stats/stats_mgr.h

index 2f3b55f2609658975c4485e8d8e48dd6abc2fa59..41423be88946fb9955c86af6182a9a54b03e41ee 100644 (file)
@@ -1,4 +1,4 @@
-// Copyright (C) 2013-2015,2017 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2013-2020 Internet Systems Consortium, Inc. ("ISC")
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
@@ -102,8 +102,8 @@ public:
     /// @name Copy constructor and assignment operator
     ///
     /// Copy constructor and assignment operator are private because there are
-    /// no use cases when @DNSClient instance will need to be copied. Also, it
-    /// is desired to avoid copying @DNSClient::impl_ pointer and external
+    /// no use cases when DNSClient instance will need to be copied. Also, it
+    /// is desired to avoid copying DNSClient::impl_ pointer and external
     /// callbacks.
     ///
     //@{
index 28778e1fbed07b405feb6e357012d018f75a1aca..b8ae7787578ad4128d77dc523addf61a4c4062a2 100644 (file)
@@ -153,6 +153,7 @@ public:
 
 private:
 
+    /// @public
     /// @brief Assign class using vendor-class-identifier option
     ///
     /// @note This is the first part of @ref classifyPacket
@@ -1027,6 +1028,7 @@ protected:
 
 private:
 
+    /// @public
     /// @brief Assign class using vendor-class-identifier option
     ///
     /// @note This is the first part of @ref classifyPacket
index 84f7eaa5dcc610afb581dfe92d93286ee76e81fa..87e441c45120b767185303220ab94f29f22acf0e 100644 (file)
@@ -1089,7 +1089,7 @@ public:
     /// counters.
     ///
     /// \param clean_report value to generate easy to parse report.
-    /// \param sep_ string used as separator if clean_report enabled..
+    /// \param clean_sep string used as separator if clean_report enabled..
     void
     printIntermediateStats(bool clean_report, std::string clean_sep) const {
         std::ostringstream stream_sent;
index 79cb7631539855f566ce3f0998c75b1c0f70b60e..7d1dd32bd134abe4050c89ce98e706978e55fdc1 100644 (file)
@@ -568,7 +568,7 @@ protected:
     /// Generate list of addresses and check for uniqueness.
     ///
     /// \param pkt6 object representing received DHCPv6 packet
-    /// \param ExhchangeType enum value.
+    /// \param xchg_type ExchangeType enum value.
     void address6Uniqueness(const dhcp::Pkt6Ptr& pkt6, ExchangeType xchg_type);
 
     /// \brief Process received v4 addresses uniqueness.
@@ -576,7 +576,7 @@ protected:
     /// Generate list of addresses and check for uniqueness.
     ///
     /// \param pkt4 object representing received DHCPv4 packet
-    /// \param ExchangeType enum value.
+    /// \param xchg_type ExchangeType enum value.
     void address4Uniqueness(const dhcp::Pkt4Ptr& pkt4, ExchangeType xchg_type);
 
     /// \brief add unique address to already assigned list.
@@ -584,8 +584,8 @@ protected:
     /// Add address and/or prefix to unique set if it's not already there,
     /// otherwise increment the number of non unique addresses.
     ///
-    /// \param std::set set of addresses that should be added to unique list
-    /// \param ExchangeType enum value.
+    /// \param current set of addresses that should be added to unique list
+    /// \param xchg_type ExchangeType enum value.
     void addUniqeAddr(const std::set<std::string>& current, ExchangeType xchg_type) {
         switch(xchg_type) {
             case ExchangeType::SA: {
@@ -648,7 +648,7 @@ protected:
     /// If address is released we should remove it from both
     /// advertised (offered) and assigned sets.
     ///
-    /// \param std::string holding value of unique address.
+    /// \param addr holding value of unique address.
     void removeUniqueAddr(const std::set<std::string>& addr) {
         for (auto addr_it = addr.begin(); addr_it != addr.end(); ++addr_it) {
             auto it = unique_address_.find(*addr_it);
index 24ec003be76c7466843c97d318b743f283512552..8f438920eab700e27f4422dd69f474cb3fb99dc0 100644 (file)
@@ -874,7 +874,7 @@ protected:
     /// flagged as ready to read.   It is installed by the invocation to
     /// register the socket with IfaceMgr made in @ref clientConnectHandler.
     ///
-    /// The handler calls @c HttpClient::closeIfOutOfBandwidth() to catch
+    /// The handler calls @c http::HttpClient::closeIfOutOfBandwidth() to catch
     /// and close any sockets that have gone ready outside of transactions.
     ///
     /// We do this in case the other peer closed the socket (e.g. idle timeout),
index b54761ed86f1e38b3e60b1bffdc74c8faf2cefe1..24a0e391220e5584f0f6894972b3cda2ab434499 100644 (file)
@@ -354,8 +354,8 @@ public:
     /// @brief Fetches an IP address parameter from a map of parameters
     /// @param map of parameters in which to look
     /// @name name of the parameter desired
-    /// @family expected protocol family of the address parameter, AF_INET
-    /// or AF_INET6
+    /// @param family expected protocol family of the address parameter,
+    /// AF_INET or AF_INET6
     /// @return IOAddress containing the value of the parameter.
     /// @throw BadValue if the parameter is missing or invalid
     IOAddress getAddressParam(ConstElementPtr params, const std::string name,
index 672ba16a9771400c3de3f3256b4c39269a730485..d85587f4941c363aef9cb0651f3233262c4905a9 100644 (file)
@@ -161,7 +161,7 @@ public:
     /// Fills in the CQL_BIND array for sending data in the Lease4 object to
     /// the database. Used for DELETE statements.
     ///
-    /// @param address address of the lease to be deleted
+    /// @param lease Deleted lease information.
     /// @param data lease info in CQL format will be stored here
     /// @param statement_tag tag identifying the query (optional)
     void createBindForDelete(const Lease4Ptr &lease,
index f73064c35f1f8b35f9016dd90064bd94c370646b..0884e4ab060a08e9885bf9172a4d3bcb9a7a2c3e 100644 (file)
@@ -693,7 +693,7 @@ public:
 
     /// @brief Sets new store-extended-info
     ///
-    /// @param store-extended-info New value to use.
+    /// @param store_extended_info New value to use.
     void setStoreExtendedInfo(const util::Optional<bool>& store_extended_info) {
         store_extended_info_ = store_extended_info;
     }
index feebec53a2a537c1218ea15311b97d98bf0b022e..3f004c139267a5f6e7f23dc1825f58f24fd98353 100644 (file)
@@ -1,4 +1,4 @@
-// Copyright (C) 2013-2019 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2013-2020 Internet Systems Consortium, Inc. ("ISC")
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
@@ -803,8 +803,6 @@ public:
     ///
     /// @param [out] subnets Container where parsed subnets will be stored.
     /// @param subnets_list pointer to a list of IPv6 subnets
-    /// @param check_iface Check if the specified interface exists in
-    /// the system.
     /// @return Number of subnets created.
     size_t parse(Subnet6Collection& subnets,
                  data::ConstElementPtr subnets_list);
index cc9c9fb02cfab8e7b813755fa09b6a6422b885ca..1603f856634ad2d1190ce1da12c117e4d7111ede 100644 (file)
@@ -1,4 +1,4 @@
-// Copyright (C) 2017-2019 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2017-2020 Internet Systems Consortium, Inc. ("ISC")
 //
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
@@ -54,8 +54,6 @@ public:
     ///
     /// @param shared_network_data Data element holding shared network
     /// configuration to be parsed.
-    /// @param check_iface Check if the specified interface exists in
-    /// the system.
     ///
     /// @return Pointer to an object representing shared network.
     /// @throw DhcpConfigError when shared network configuration is invalid.
index 288d68381ba2faa1a406f1ee8445f90fd7ab2212..bc1de1729a9756c1501524082a0322dd80b5629a 100644 (file)
@@ -73,7 +73,7 @@ public:
     ///        used.  Note: although -1 is a valid argument value for
     ///        @ref isc::hooks::CalloutManager::setLibraryIndex(), in this class
     ///        it is used as a sentinel to indicate that the library index in
-    ///        @ref isc::util::CalloutManager should not be set or reset.
+    ///        @ref isc::hooks::CalloutManager should not be set or reset.
     LibraryHandle(CalloutManager& manager, int index = -1)
         : callout_manager_(manager), index_(index) {}
 
index 49ab17ca7e9b7edd8255951d6ba5d3d8134c5bd1..9723c6b0aead6c7047f7d76ef99666919763dd08 100644 (file)
@@ -472,7 +472,7 @@ private:
     /// method.
     StatsMgr();
 
-    /// @private
+    /// @public
 
     /// @brief Sets a given statistic to specified value (internal version).
     ///
@@ -496,7 +496,7 @@ private:
         }
     }
 
-    /// @private
+    /// @public
 
     /// @brief Adds specified value to a given statistic (internal version).
     ///
@@ -525,7 +525,7 @@ private:
         }
     }
 
-    /// @private
+    /// @public
 
     /// @brief Adds a new observation.
     ///
@@ -536,7 +536,7 @@ private:
     /// @param stat observation
     void addObservation(const ObservationPtr& stat);
 
-    /// @private
+    /// @public
 
     /// @brief Adds a new observation in a thread safe context.
     ///