Improve SeekRequest & Cue documentation

src/engine/enginebuffer.h

@@ -89,19 +89,18 @@ class EngineBuffer : public EngineObject {
   public:
     enum SeekRequest {
         SEEK_NONE = 0x00,
-        SEEK_PHASE = 0x01, // This is set to force an in-phase seek.
-        SEEK_EXACT = 0x02, // This is used to seek to position regardless of
-                           // if Quantize is enabled.
+        /// Force an in-phase seek
+        SEEK_PHASE = 0x01,
+        /// Bypass Quantization
+        SEEK_EXACT = 0x02,
+        /// This is an artificial state that happens if an exact seek and a
+        /// phase seek are scheduled at the same time.
         SEEK_EXACT_PHASE = SEEK_PHASE | SEEK_EXACT,
-						   // This is an artificial state that happens if
-                           // an exact seek and a phase seek are scheduled
-                           // at the same time.
-        SEEK_STANDARD = 0x04, // This seeks to the exact position if Quantize is
-                              // disabled or performs an in-phase seek if it is enabled.
+        /// #SEEK_PHASE if Quantize enables, otherwise SEEK_EXACT
+        SEEK_STANDARD = 0x04,
+        /// This is an artificial state that happens if a standard seek and a
+        /// phase seek are scheduled at the same time.
         SEEK_STANDARD_PHASE = SEEK_STANDARD | SEEK_PHASE,
-                              // This is an artificial state that happens if
-                              // a standard seek and a phase seek are scheduled
-                              // at the same time.
     };
     Q_DECLARE_FLAGS(SeekRequests, SeekRequest);
 

src/track/cue.h

@@ -18,7 +18,9 @@ class Cue : public QObject {
     Q_OBJECT
 
   public:
+    /// A position value for the cue that signals its position is not set
     static constexpr double kNoPosition = -1.0;
+    /// A value for #m_iHotCue signaling it is not a hotcue
     static constexpr int kNoHotCue = -1;
 
     Cue();