Document Object.getNObject & refCount are debug

Document the fact that Object.getNObject and refCount
are only for debugging astshim.

include/astshim/Object.h

@@ -123,13 +123,22 @@ class Object {
     /// Get @ref Object_Ident "Ident": object identification string that is copied.
     std::string getIdent() const { return getC("Ident"); }
 
-    /// Get @ref Object_NObject "NObject": number of Objects in class.
+    /**
+    Get @ref Object_NObject "NObject": number of AST objects in existence of the same type
+    as the underlying AST class.
+
+    @warning Intended only for debugging astshim.
+    */
     int getNObject() const { return getI("NObject"); }
 
-    /// Get @ref Object_ObjSize "ObjSize": the in-memory size of the Object in bytes.
+    /// Get @ref Object_ObjSize "ObjSize": the in-memory size of the AST object in bytes.
     int getObjSize() const { return getI("ObjSize"); }
 
-    /// Get @ref Object_RefCount "RefCount": count of active Object pointers
+    /**
+    Get @ref Object_RefCount "RefCount": number of active pointers to the underlying AST object
+
+    @warning Intended only for debugging astshim.
+    */
     int getRefCount() const { return getI("RefCount"); }
 
     /// Get @ref Object_UseDefs "UseDefs": allow use of default values for Object attributes?

include/astshim/detail/utils.h

@@ -29,6 +29,8 @@
 namespace ast {
 namespace detail {
 
+class Object
+
 static const int FITSLEN = 80;
 
 /// A wrapper around astAnnul; intended as a custom deleter for std::unique_ptr

src/detail/utils.cc

@@ -20,6 +20,7 @@
  * see <https://www.lsstcorp.org/LegalNotices/>.
  */
 #include "astshim/detail/utils.h"
+#include "astshim/Object.h"
 
 namespace ast {
 namespace detail {