डॉक्सिजन के साथ समान नाम के साथ गणना मूल्यों को कैसे दस्तावेज़ित करें?

Question

मैं दो वर्ग गणनाओं को दस्तावेज करने की कोशिश कर रहा हूं जिसमें डोक्सिजन के साथ कुछ समान मूल्य शामिल हैं। लेकिन यह एक ही नाम के साथ प्रत्येक फ़ील्ड के लिए डुप्लीकेट पाठ उत्पन्न करता है।

/*! 
* \enum OperandType 
* \brief A type of operand. Represents the location of the operand. 
*/ 
enum class OperandType : unsigned int { 
    IMMEDIATE,   /**< An immediate operand */ 
    REGISTER,   /**< An operand in a register */ 
    STACK,    /**< An operand on the stack */ 
    GLOBAL    /**< A global operand */ 
}; 
/*! 
* \enum PositionType 
* \brief A type of position for a variable 
*/ 
enum class PositionType : unsigned int { 
    STACK,   /**< A variable on the stack */ 
    PARAMETER,  /**< A parameter */ 
    GLOBAL,   /**< A global variable */ 
    CONST   /**< A const variable.*/ 
}; 

प्रत्येक गणना के ढेर सदस्य के लिए विवरण दोनों विवरण के संयोजन है और वहाँ ग्लोबल के लिए एक ही समस्या है:

यहाँ मेरी दो enumerations हैं।

ढेर के वर्णन है:

ढेर

ढेर

वहाँ विशेष रूप से उनमें से प्रत्येक दस्तावेज़ के लिए एक रास्ता है पर एक संकार्य पर एक चर?

Answer 1

वर्कअराउंड इसे नामस्थान में रखना और using इसे बाहर निकालना है।

/*! 
* enum class 
*/ 
namespace enum_class { 
    /*! 
    * \enum OperandType 
    * \brief A type of operand. Represents the location of the operand. 
    * Ok 
    */ 
    enum class OperandType : unsigned int { 
     IMMEDIATE,   /**< An immediate operand */ 
      REGISTER,   /**< An operand in a register */ 
     STACK,    /**< An operand on the stack */ 
     GLOBAL    /**< A global operand */ 
    }; 
} 
using enum_class::OperandType; 
/*! 
* \enum PositionType 
* \brief A type of position for a variable 
*/ 
enum class PositionType : unsigned int { 
    STACK,   /**< A variable on the stack */ 
    PARAMETER,  /**< A parameter */ 
    GLOBAL,   /**< A global variable */ 
    CONST   /**< A const variable.*/ 
}; 

आप एक अलग नाम स्थान (enumeration) में PositionType, इसलिए यदि आपका जुदाई पसंद नहीं है सकते हैं।