From: Hoa Nguyen <hoanguyen@ucdavis.edu>
Date: Thu, 20 Aug 2020 06:39:36 +0000 (-0700)
Subject: base: Tag API methods and variables in channel_addr.hh
X-Git-Tag: v20.1.0.0~94
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=b1a2f9393dca1ff8da73f97b8b0989e4287acbed;p=gem5.git

base: Tag API methods and variables in channel_addr.hh

Change-Id: I91c806e88f035457f93dcfcee1833d6955a07807
Signed-off-by: Hoa Nguyen <hoanguyen@ucdavis.edu>
Reviewed-on: https://gem5-review.googlesource.com/c/public/gem5/+/32960
Reviewed-by: Bobby R. Bruce <bbruce@ucdavis.edu>
Reviewed-by: Jason Lowe-Power <power.jg@gmail.com>
Maintainer: Bobby R. Bruce <bbruce@ucdavis.edu>
Tested-by: kokoro <noreply+kokoro@google.com>
---

diff --git a/src/base/channel_addr.hh b/src/base/channel_addr.hh
index 06fae7270..2cfe38027 100644
--- a/src/base/channel_addr.hh
+++ b/src/base/channel_addr.hh
@@ -51,7 +51,12 @@ class ChannelAddr
   public:
     using Type = Addr;
 
-    /** Explicit constructor assigning a value. */
+    /**
+     * Explicit constructor assigning a value.
+     *
+     * @ingroup api_channel_addr
+     * @{
+     */
     explicit constexpr ChannelAddr(Type _a) : a(_a) { }
 
     /** Converting back to the value type. */
@@ -131,6 +136,8 @@ class ChannelAddr
     constexpr bool operator==(const ChannelAddr &b) const { return a == b.a; }
     constexpr bool operator!=(const ChannelAddr &b) const { return a != b.a; }
 
+    /** @} */ // end of api_channel_addr
+
   private:
     /** Member holding the actual value. */
     Type a;
@@ -143,6 +150,10 @@ class ChannelAddr
 class ChannelAddrRange
 {
   public:
+    /**
+     * @ingroup api_channel_addr
+     * @{
+     */
     constexpr ChannelAddrRange()
         : ChannelAddrRange(ChannelAddr(1), ChannelAddr(0)) {}
 
@@ -165,6 +176,8 @@ class ChannelAddrRange
         return a >= _start && a <= _end;
     }
 
+    /** @} */ // end of api_channel_addr
+
   protected:
     ChannelAddr _start;
     ChannelAddr _end;
@@ -186,6 +199,9 @@ namespace std
     };
 }
 
+/**
+ * @ingroup api_channel_addr
+ */
 std::ostream &operator<<(std::ostream &out, const ChannelAddr &addr);
 
 #endif // __BASE_CHANNEL_ADDR_HH__