Sprinkle some header comments in various files in an attempt to explain what

they're for.

[originally from svn r6639]

cmdline.c

@@ -1,3 +1,8 @@
+/*
+ * cmdline.c - command-line parsing shared between many of the
+ * PuTTY applications
+ */
+
 #include <stdio.h>
 #include <assert.h>
 #include <stdlib.h>

logging.c

@@ -1,3 +1,7 @@
+/*
+ * Session logging.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <ctype.h>

misc.h

@@ -1,3 +1,7 @@
+/*
+ * Header for misc.c.
+ */
+
 #ifndef PUTTY_MISC_H
 #define PUTTY_MISC_H
 

portfwd.c

@@ -1,3 +1,7 @@
+/*
+ * SSH port forwarding.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 

puttyps.h

@@ -1,3 +1,7 @@
+/*
+ * Find the platform-specific header for this platform.
+ */
+
 #ifndef PUTTY_PUTTYPS_H
 #define PUTTY_PUTTYPS_H
 

raw.c

@@ -1,3 +1,7 @@
+/*
+ * "Raw" backend.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 

rlogin.c

@@ -1,3 +1,7 @@
+/*
+ * Rlogin backend.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <ctype.h>

ssh.c

@@ -1,3 +1,7 @@
+/*
+ * SSH backend.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <stdarg.h>

sshdh.c

@@ -1,3 +1,7 @@
+/*
+ * Diffie-Hellman implementation for PuTTY.
+ */
+
 #include "ssh.h"
 
 /*

sshdss.c

@@ -1,3 +1,7 @@
+/*
+ * Digital Signature Standard implementation for PuTTY.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <assert.h>

telnet.c

@@ -1,3 +1,7 @@
+/*
+ * Telnet backend.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 

terminal.c

@@ -1,3 +1,7 @@
+/*
+ * Terminal emulator.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <ctype.h>

windows/sizetip.c

@@ -1,3 +1,7 @@
+/*
+ * sizetip.c - resize tips for PuTTY(tel) terminal window.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <tchar.h>

windows/win_res.h

@@ -1,3 +1,7 @@
+/*
+ * win_res.h - constants shared between win_res.rc2 and the C code.
+ */
+
 #ifndef PUTTY_WIN_RES_H
 #define PUTTY_WIN_RES_H
 

windows/wincons.c

@@ -1,5 +1,5 @@
 /*
- * console.c: various interactive-prompt routines shared between
+ * wincons.c - various interactive-prompt routines shared between
  * the Windows console PuTTY tools
  */
 

windows/windlg.c

@@ -1,3 +1,7 @@
+/*
+ * windlg.c - dialogs for PuTTY(tel), including the configuration dialog.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <limits.h>

windows/window.c

@@ -1,3 +1,8 @@
+/*
+ * window.c - the PuTTY(tel) main program, which runs a PuTTY terminal
+ * emulator and backend in a window.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <ctype.h>

windows/wintime.c

@@ -1,3 +1,7 @@
+/*
+ * wintime.c - Avoid trouble with time() returning (time_t)-1 on Windows.
+ */
+
 #include "putty.h"
 #include <time.h>