diff --git a/energyplugin/etm/types/drawcap.h b/energyplugin/etm/types/drawcap.h
index 1e59f64..72b5363 100644
--- a/energyplugin/etm/types/drawcap.h
+++ b/energyplugin/etm/types/drawcap.h
@@ -46,13 +46,17 @@ enum class DrawCapSource {
  *   valeur licite et voudrait dire *interdiction totale de soutirer*.
  */
 struct DrawCap {
+    //! D'où vient ce plafond. Décide du motif publié et du geste qu'il appelle.
     DrawCapSource source = DrawCapSource::Breaker;
     //! Plafond **par phase**, en watts. Négatif = ce plafond ne borne pas par phase.
     double perPhaseW = -1;
     //! Plafond **total** au point de livraison, en watts. Négatif = ne borne pas au total.
     double totalW    = -1;
 
+    //! \return Vrai si ce plafond borne PAR PHASE. Une valeur négative dit « pas de cette
+    //!   façon » ; zéro dirait « zéro watt autorisé », ce qui est une autre affirmation.
     bool bornePhase() const { return perPhaseW >= 0; }
+    //! \return Vrai si ce plafond borne AU TOTAL, au point de livraison. Même règle du signe.
     bool borneTotal() const { return totalW    >= 0; }
 };