From ee4d22e8323184cd4bc73910b4228378c481bb36 Mon Sep 17 00:00:00 2001
From: Tom Igoe <t.igoe@arduino.cc>
Date: Sun, 25 Jul 2010 16:18:52 +0000
Subject: [PATCH] Added comments to WebClient example

---
 .../Ethernet/examples/WebClient/WebClient.pde | 51 +++++++++++++++----
 1 file changed, 41 insertions(+), 10 deletions(-)

diff --git a/libraries/Ethernet/examples/WebClient/WebClient.pde b/libraries/Ethernet/examples/WebClient/WebClient.pde
index 74a609450..9eba58ed2 100644
--- a/libraries/Ethernet/examples/WebClient/WebClient.pde
+++ b/libraries/Ethernet/examples/WebClient/WebClient.pde
@@ -1,41 +1,72 @@
+/*
+  Web  client
+ 
+ This sketch connects to a website (http://www.google.com)
+ using an Arduino Wiznet Ethernet shield. 
+ 
+ Circuit:
+ * Ethernet shield attached to pins 10, 11, 12, 13
+ 
+ created 18 Dec 2009
+ by David A. Mellis
+ 
+ */
 #include <Ethernet.h>
 
-byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
-byte ip[] = { 10, 0, 0, 177 };
-byte server[] = { 64, 233, 187, 99 }; // Google
+// Enter a MAC address and IP address for your controller below.
+// The IP address will be dependent on your local network:
+byte mac[] = { 
+  0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
+byte ip[] = { 
+  192,168,1,177 };
+byte server[] = { 
+  173,194,33,104 }; // Google
 
+// Initialize the Ethernet client library
+// with the IP address and port of the server 
+// that you want to connect to (port 80 is default for HTTP):
 Client client(server, 80);
 
-void setup()
-{
+void setup() {
+  // start the Ethernet connection:
   Ethernet.begin(mac, ip);
+  // start the serial library:
   Serial.begin(9600);
-  
+  // give the Ethernet shield a second to initialize:
   delay(1000);
-  
   Serial.println("connecting...");
-  
+
+  // if you get a connection, report back via serial:
   if (client.connect()) {
     Serial.println("connected");
+    // Make a HTTP request:
     client.println("GET /search?q=arduino HTTP/1.0");
     client.println();
-  } else {
+  } 
+  else {
+    // kf you didn't get a connection to the server:
     Serial.println("connection failed");
   }
 }
 
 void loop()
 {
+  // if there are incoming bytes available 
+  // from the server, read them and print them:
   if (client.available()) {
     char c = client.read();
     Serial.print(c);
   }
-  
+
+  // if the server's disconnected, stop the client:
   if (!client.connected()) {
     Serial.println();
     Serial.println("disconnecting.");
     client.stop();
+
+    // do nothing forevermore:
     for(;;)
       ;
   }
 }
+