Unix porting fixes
[shibboleth/cpp-xmltooling.git] / xmltooling / base.h
index d2060cb..093152e 100644 (file)
 #define NULL    0
 #endif
 
+#ifdef _MSC_VER
+    #define XMLTOOLING_DOXYGEN(desc) /##** desc */
+#else
+    #define XMLTOOLING_DOXYGEN(desc)
+#endif
+
 /**
  * Blocks copy c'tor and assignment operator for a class.
  */
         cname() {} \
     public: \
         virtual ~cname() {} \
-        /##** Type-specific clone method. */ \
+        XMLTOOLING_DOXYGEN(Type-specific clone method.) \
         virtual cname* clone##cname() const=0; \
-        /##** Element prefix */ \
+        XMLTOOLING_DOXYGEN(Element prefix) \
         static const XMLCh PREFIX[]; \
-        /##** Element local name */ \
+        XMLTOOLING_DOXYGEN(Element local name) \
         static const XMLCh LOCAL_NAME[]
 
 /**
  * @param upcased   the upcased name of the attribute
  */
 #define DECL_XMLOBJECT_ATTRIB(proper,upcased) \
-    /##** proper attribute name */ \
+    XMLTOOLING_DOXYGEN(proper attribute name) \
     static const XMLCh upcased##_ATTRIB_NAME[]; \
-    /##** Returns the proper attribute. */ \
+    XMLTOOLING_DOXYGEN(Returns the proper attribute.) \
     virtual const XMLCh* get##proper() const=0; \
-    /##** Sets the proper attribute. */ \
+    XMLTOOLING_DOXYGEN(Sets the proper attribute.) \
     virtual void set##proper(const XMLCh* proper)=0
 
 /**
  * @param cname the name of the XMLObject specialization
  */
 #define BEGIN_XMLOBJECTBUILDER(cname) \
-    /##** Builder for cname objects. */ \
+    XMLTOOLING_DOXYGEN(Builder for cname objects.) \
     class XMLTOOL_API cname##Builder : public xmltooling::XMLObjectBuilder { \
     public: \
         virtual ~cname##Builder() {} \
-        /##** Default builder. */ \
+        XMLTOOLING_DOXYGEN(Default builder.) \
         virtual cname* buildObject() const=0
 
 /**