Consistent top-of-file doc blocks

lib/adaptor.js

@@ -1,5 +1,5 @@
-/*
- * adaptor
+/**
+ * Cylon.js - Adaptor base class
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/basestar.js

@@ -1,5 +1,5 @@
-/*
- * basestar
+/**
+ * Cylon.js - Basestar base class
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/config.js

@@ -1,5 +1,5 @@
 /*
- * Cylon - Internal Configuration
+ * Cylon.js - Internal Configuration
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/cylon.js

@@ -1,5 +1,5 @@
 /*
- * cylon
+ * Cylon.js - Master Control Program
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/driver.js

@@ -1,5 +1,5 @@
-/*
- * driver
+/**
+ * Cylon.js - Driver base class
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/initializer.js

@@ -1,5 +1,5 @@
-/*
- * Device/Connection Initializer
+/**
+ * Cylon.js - Adaptor/Driver initializer
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/io/digital-pin.js

@@ -1,5 +1,5 @@
-/*
- * Linux IO DigitalPin
+/**
+ * Cylon.js - GPIO Digital Pin class
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/io/utils.js

@@ -1,3 +1,11 @@
+/**
+ * Cylon.js - I/O Utils
+ * cylonjs.com
+ *
+ * Copyright (c) 2013-2015 The Hybrid Group
+ * Licensed under the Apache 2.0 license.
+*/
+
 "use strict";
 
 module.exports = {

lib/logger.js

@@ -1,5 +1,5 @@
-/*
- * logger
+/**
+ * Cylon.js - Logger
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/logger/basic_logger.js

@@ -1,3 +1,11 @@
+/**
+ * Cylon.js - Basic Logger
+ * cylonjs.com
+ *
+ * Copyright (c) 2013-2015 The Hybrid Group
+ * Licensed under the Apache 2.0 license.
+*/
+
 "use strict";
 
 var getArgs = function(args) {

lib/logger/null_logger.js

@@ -1,3 +1,11 @@
+/**
+ * Cylon.js - Null Logger
+ * cylonjs.com
+ *
+ * Copyright (c) 2013-2015 The Hybrid Group
+ * Licensed under the Apache 2.0 license.
+*/
+
 "use strict";
 
 // The NullLogger is designed for cases where you want absolutely nothing to

lib/registry.js

@@ -1,9 +1,5 @@
-/*
- * Registry
- *
- * The Registry contains references to all Drivers and Adaptors Cylon is aware
- * of, along with which module they live in (e.g. cylon-firmata).
- *
+/**
+ * Cylon.js - Module Registry
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/robot.js

@@ -1,5 +1,5 @@
-/*
- * robot
+/**
+ * Cylon.js - Robot class
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/test/loopback.js

@@ -1,5 +1,5 @@
 /*
- * Loopback adaptor
+ * Cylon.js - Loopback adaptor
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/test/ping.js

@@ -1,5 +1,5 @@
 /*
- * Ping driver
+ * Cylon.js - Ping driver
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/test/test-adaptor.js

@@ -1,5 +1,5 @@
 /*
- * Test adaptor
+ * Cylon.js - Test Adaptor
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/test/test-driver.js

@@ -1,5 +1,5 @@
 /*
- * Test driver
+ * Cylon.js - Test Driver
  * cylonjs.com
  *
  * Copyright (c) 2013-2015 The Hybrid Group

lib/utils/helpers.js

@@ -1,5 +1,11 @@
-// A collection of useful helper functions, used internally but not exported
-// with the rest of Cylon. 
+/**
+ * Cylon.js - Helper Utilities
+ * cylonjs.com
+ *
+ * Copyright (c) 2013-2015 The Hybrid Group
+ * Licensed under the Apache 2.0 license.
+*/
+
 "use strict";
 
 var __slice = Array.prototype.slice;

lib/utils/monkey-patches.js

@@ -1,3 +1,11 @@
+/**
+ * Cylon.js - Monkey Patches
+ * cylonjs.com
+ *
+ * Copyright (c) 2013-2015 The Hybrid Group
+ * Licensed under the Apache 2.0 license.
+*/
+
 "use strict";
 
 var max = Math.max,