diff --git a/Adafruit_GFX.h b/Adafruit_GFX.h
index 8000fa01..63c6ab68 100644
--- a/Adafruit_GFX.h
+++ b/Adafruit_GFX.h
@@ -328,7 +328,7 @@ class GFXcanvas1 : public Adafruit_GFX {
   bool getRawPixel(int16_t x, int16_t y) const;
   void drawFastRawVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
   void drawFastRawHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
-  uint8_t *buffer; // protected (no longer private) for subclass flexibility
+  uint8_t *buffer; ///< Raster data: no longer private, allow subclass access
 
 private:
 #ifdef __AVR__
@@ -359,7 +359,7 @@ class GFXcanvas8 : public Adafruit_GFX {
   uint8_t getRawPixel(int16_t x, int16_t y) const;
   void drawFastRawVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
   void drawFastRawHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
-  uint8_t *buffer; // protected (no longer private) for subclass flexibility
+  uint8_t *buffer; ///< Raster data: no longer private, allow subclass access
 };
 
 ///  A GFX 16-bit canvas context for graphics
@@ -385,7 +385,7 @@ class GFXcanvas16 : public Adafruit_GFX {
   uint16_t getRawPixel(int16_t x, int16_t y) const;
   void drawFastRawVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
   void drawFastRawHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
-  uint16_t *buffer; // protected (no longer private) for subclass flexibility
+  uint16_t *buffer; ///< Raster data: no longer private, allow subclass access
 };
 
 #endif // _ADAFRUIT_GFX_H