Clarify display and clear usage in comments to fix #9.

examples/ssd1306_128x32_i2c/ssd1306_128x32_i2c.ino

@@ -61,12 +61,20 @@ void setup()   {
   display.begin(SSD1306_SWITCHCAPVCC, 0x3C);  // initialize with the I2C addr 0x3C (for the 128x32)
   // init done
   
-  display.display(); // show splashscreen
+  // Show image buffer on the display hardware.
+  // Since the buffer is intialized with an Adafruit splashscreen
+  // internally, this will display the splashscreen.
+  display.display();
   delay(2000);
-  display.clearDisplay();   // clears the screen and buffer
+
+  // Clear the buffer.
+  display.clearDisplay();
 
   // draw a single pixel
   display.drawPixel(10, 10, WHITE);
+  // Show the display buffer on the hardware.
+  // NOTE: You _must_ call display after making any drawing commands
+  // to make them visible on the display hardware!
   display.display();
   delay(2000);
   display.clearDisplay();

examples/ssd1306_128x32_spi/ssd1306_128x32_spi.ino

@@ -72,12 +72,20 @@ void setup()   {
   display.begin(SSD1306_SWITCHCAPVCC);
   // init done
   
-  display.display(); // show splashscreen
+  // Show image buffer on the display hardware.
+  // Since the buffer is intialized with an Adafruit splashscreen
+  // internally, this will display the splashscreen.
+  display.display();
   delay(2000);
-  display.clearDisplay();   // clears the screen and buffer
+
+  // Clear the buffer.
+  display.clearDisplay();
 
   // draw a single pixel
   display.drawPixel(10, 10, WHITE);
+  // Show the display buffer on the hardware.
+  // NOTE: You _must_ call display after making any drawing commands
+  // to make them visible on the display hardware!
   display.display();
   delay(2000);
   display.clearDisplay();

examples/ssd1306_128x64_i2c/ssd1306_128x64_i2c.ino

@@ -61,12 +61,20 @@ void setup()   {
   display.begin(SSD1306_SWITCHCAPVCC, 0x3D);  // initialize with the I2C addr 0x3D (for the 128x64)
   // init done
   
-  display.display(); // show splashscreen
+  // Show image buffer on the display hardware.
+  // Since the buffer is intialized with an Adafruit splashscreen
+  // internally, this will display the splashscreen.
+  display.display();
   delay(2000);
-  display.clearDisplay();   // clears the screen and buffer
+
+  // Clear the buffer.
+  display.clearDisplay();
 
   // draw a single pixel
   display.drawPixel(10, 10, WHITE);
+  // Show the display buffer on the hardware.
+  // NOTE: You _must_ call display after making any drawing commands
+  // to make them visible on the display hardware!
   display.display();
   delay(2000);
   display.clearDisplay();

examples/ssd1306_128x64_spi/ssd1306_128x64_spi.ino

@@ -72,12 +72,20 @@ void setup()   {
   display.begin(SSD1306_SWITCHCAPVCC);
   // init done
   
-  display.display(); // show splashscreen
+  // Show image buffer on the display hardware.
+  // Since the buffer is intialized with an Adafruit splashscreen
+  // internally, this will display the splashscreen.
+  display.display();
   delay(2000);
-  display.clearDisplay();   // clears the screen and buffer
+
+  // Clear the buffer.
+  display.clearDisplay();
 
   // draw a single pixel
   display.drawPixel(10, 10, WHITE);
+  // Show the display buffer on the hardware.
+  // NOTE: You _must_ call display after making any drawing commands
+  // to make them visible on the display hardware!
   display.display();
   delay(2000);
   display.clearDisplay();