Improving comments

Author: aentinger

examples/ConnectionHandlerDemo/ConnectionHandlerDemo.ino

@@ -32,30 +32,26 @@ NBConnectionHandler conMan(SECRET_PIN);
 
 void setup() {
   Serial.begin(9600);
-  /* give a few seconds for the Serial connection to be available */
+  /* Give a few seconds for the Serial connection to be available */
   delay(4000);
 
   setDebugMessageLevel(DBG_INFO);
 
-  // the following methods allow the sketch to be notified when connected or
-  // disconnected to the network
-
-  conMan.addConnectCallback(
-    onNetworkConnect); // look at function onNetworkConnect towards the end of
-  // this sketch
-  conMan.addDisconnectCallback(
-    onNetworkDisconnect); // look at function onNetworkDisconnect towards the
-  // end of this sketch
+  /* Register a function to be called upon connection to a network */
+  conMan.addConnectCallback(onNetworkConnect);
+  /* Register a function to be called upon disconnection from a network */
+  conMan.addDisconnectCallback(onNetworkDisconnect);
 }
 
 void loop() {
-  // the following code keeps on running connection workflows on our
-  // ConnectionHandler object, hence allowing reconnection in case of failure
-  // and notification of connect/disconnect event if enabled (see
-  // addConnectCallback/addDisconnectCallback) NOTE: any use of delay() within
-  // the loop or methods called from it will delay the execution of .update(),
-  // which might not guarantee the correct functioning of the ConnectionHandler
-  // object.
+  /* The following code keeps on running connection workflows on our
+   * ConnectionHandler object, hence allowing reconnection in case of failure
+   * and notification of connect/disconnect event if enabled (see
+   * addConnectCallback/addDisconnectCallback) NOTE: any use of delay() within
+   * the loop or methods called from it will delay the execution of .update(),
+   * which might not guarantee the correct functioning of the ConnectionHandler
+   * object.
+   */
 
   conMan.update();
 }