1. Added a description comment to each C and H file.

2. Updated the FSF address in the comments.

examples/server/server.c

@@ -16,7 +16,8 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
  */
 
 

src/internal.c

@@ -16,7 +16,14 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The internal module contains the private data and functions. The public
+ * API calls into this module to do the work of processing the connections.
  */
 
 

src/io.c

@@ -16,7 +16,15 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The io module provides the default send and receive callbacks used
+ * by the library to handle network I/O. By default they handle UNIX
+ * style I/O.
  */
 
 

src/log.c

@@ -16,9 +16,18 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
  */
 
+
+/*
+ * The log module contains the interface to the logging function. When
+ * debugging is enabled and turned on, the logger will output to STDOUT.
+ * A custom logging callback may be installed.
+ */
+
+
 #ifdef HAVE_CONFIG_H
     #include <config.h>
 #endif

src/memory.c

@@ -16,7 +16,13 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The memory module contains the interface to the custom memory handling hooks.
  */
 
 

src/port.c

@@ -16,7 +16,16 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The port module wraps standard C library functions with macros to
+ * cover portablility issues when building in environments that rename
+ * those functions. This module also provides local versions of some
+ * standard C library functions that are missing on some platforms.
  */
 
 

src/ssh.c

@@ -16,7 +16,13 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The ssh module contains the public API for wolfSSH.
  */
 
 

wolfssh/error.h

@@ -16,7 +16,13 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The error header file provides the error codes used in the library.
  */
 
 
@@ -64,7 +70,6 @@ enum WS_IOerrors {
 };
 
 
-
 #ifdef __cplusplus
 }
 #endif

wolfssh/internal.h

@@ -16,7 +16,14 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The internal module contains the private data and functions. The public
+ * API calls into this module to do the work of processing the connections.
  */
 
 

wolfssh/log.h

@@ -16,7 +16,15 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The log module contains the interface to the logging function. When
+ * debugging is enabled and turned on, the logger will output to STDOUT.
+ * A custom logging callback may be installed.
  */
 
 

wolfssh/memory.h

@@ -16,7 +16,13 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The memory module contains the interface to the custom memory handling hooks.
  */
 
 

wolfssh/port.h

@@ -16,7 +16,16 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The port module wraps standard C library functions with macros to
+ * cover portablility issues when building in environments that rename
+ * those functions. This module also provides local versions of some
+ * standard C library functions that are missing on some platforms.
  */
 
 

wolfssh/settings.h

@@ -16,7 +16,15 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The settings header provides a method for developers to provide the
+ * internal preprocessor defines that the configure script provides to
+ * environments that do not use the configure script.
  */
 
 

wolfssh/ssh.h

@@ -16,7 +16,13 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The ssh module contains the public API for wolfSSH.
  */
 
 

wolfssh/version.h

@@ -16,7 +16,16 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The version header provides the current version number to the code
+ * based and is updated automatically by the configure script. A copy
+ * of the last generated copy of version.h is included with the
+ * distribution for environments that do not use configure.
  */
 
 

wolfssh/version.h.in

@@ -16,7 +16,16 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The version header provides the current version number to the code
+ * based and is updated automatically by the configure script. A copy
+ * of the last generated copy of version.h is included with the
+ * distribution for environments that do not use configure.
  */
 
 

wolfssh/visibility.h

@@ -16,7 +16,15 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301, USA.
+ */
+
+
+/*
+ * The visibility header handles the visibility of function prototypes
+ * between the local (used between modules in the library) and public
+ * (exported for the library user) APIs.
  */