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

they're for.

git-svn-id: http://svn.tartarus.org/sgt/putty@6639 cda61777-01e9-0310-a592-d414129be87e

diff --git a/cmdline.c b/cmdline.c
index 39f57bbf6281ee58440c6c901c8cb90fe745f910..e8343427b6100b1191ec824170136bbf76b3ee80 100644 (file)
--- a/cmdline.c
+++ b/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>

diff --git a/logging.c b/logging.c
index ab765b3b4774bed84b2bfb135d0aa1e78e10da9e..8122a480ed156abc23ba6942d3a6dfdfef079d57 100644 (file)
--- a/logging.c
+++ b/logging.c
@@ -1,3 +1,7 @@
+/*
+ * Session logging.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <ctype.h>

diff --git a/misc.h b/misc.h
index f4363e4412ba507270f836bb4cf448c605a4b376..49942aa5e0f0b3afaedac4ff33c18f49238a4e48 100644 (file)
--- a/misc.h
+++ b/misc.h
@@ -1,3 +1,7 @@
+/*
+ * Header for misc.c.
+ */
+
 #ifndef PUTTY_MISC_H
 #define PUTTY_MISC_H
 

diff --git a/portfwd.c b/portfwd.c
index 54a6876964f0386acea62e83c25d1a3896a75578..e6cf20059476a5e3c78467abdef52e6abc936587 100644 (file)
--- a/portfwd.c
+++ b/portfwd.c
@@ -1,3 +1,7 @@
+/*
+ * SSH port forwarding.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 

diff --git a/puttyps.h b/puttyps.h
index 1370bfd2a094e7ebafaae5e9cd135acc1afc5de6..d1f3c37df884dbdc96e0e63c6c6ab6d9d5f0272f 100644 (file)
--- a/puttyps.h
+++ b/puttyps.h
@@ -1,3 +1,7 @@
+/*
+ * Find the platform-specific header for this platform.
+ */
+
 #ifndef PUTTY_PUTTYPS_H
 #define PUTTY_PUTTYPS_H
 

diff --git a/raw.c b/raw.c
index 31d7490c4dc096c4055997ee6eb42f73de53a21a..28da09f758a5abfa3fb47581317fa33f6c023cee 100644 (file)
--- a/raw.c
+++ b/raw.c
@@ -1,3 +1,7 @@
+/*
+ * "Raw" backend.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 

diff --git a/rlogin.c b/rlogin.c
index 2d2b288a993d41db90dab138c8b61efd8d272ae9..1b9a8069e617fc8a0b597325b9982a734403c3dc 100644 (file)
--- a/rlogin.c
+++ b/rlogin.c
@@ -1,3 +1,7 @@
+/*
+ * Rlogin backend.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <ctype.h>

diff --git a/ssh.c b/ssh.c
index 1a7880cc03afbd9ff9869622a7e0d0de04bd5f66..38eb2bbd2bd8efcc06c23c297ef2675aa82afc3a 100644 (file)
--- a/ssh.c
+++ b/ssh.c
@@ -1,3 +1,7 @@
+/*
+ * SSH backend.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <stdarg.h>

diff --git a/sshdh.c b/sshdh.c
index 48f277a7cf31eaf02a2a34f5a6f8ebce7b22d5ee..f0abd3eca311131a57654fd1b35a1608179374e7 100644 (file)
--- a/sshdh.c
+++ b/sshdh.c
@@ -1,3 +1,7 @@
+/*
+ * Diffie-Hellman implementation for PuTTY.
+ */
+
 #include "ssh.h"
 
 /*

diff --git a/sshdss.c b/sshdss.c
index 41974c2353be18669bd371b5930d31b58608e1b7..22992fea538194d28e219bb04618d7534e2cab81 100644 (file)
--- a/sshdss.c
+++ b/sshdss.c
@@ -1,3 +1,7 @@
+/*
+ * Digital Signature Standard implementation for PuTTY.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <assert.h>

diff --git a/telnet.c b/telnet.c
index fe6f5cf94507ab8c600c9cab3f01c0071563a832..5038833765fce6898f39b541b0172d0964641932 100644 (file)
--- a/telnet.c
+++ b/telnet.c
@@ -1,3 +1,7 @@
+/*
+ * Telnet backend.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 

diff --git a/terminal.c b/terminal.c
index 72ff9f90c6c32ce39442d965a38919c45d8c3ee3..806d650c741918bf485ff889451adc2ce6fb6376 100644 (file)
--- a/terminal.c
+++ b/terminal.c
@@ -1,3 +1,7 @@
+/*
+ * Terminal emulator.
+ */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <ctype.h>

diff --git a/windows/sizetip.c b/windows/sizetip.c
index 2073a09f0d935da85f670a42b2b09e71cf46e3a2..4f0a195facde6f18f13fda37f0cdf8c943c4703e 100644 (file)
--- a/windows/sizetip.c
+++ b/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>

diff --git a/windows/win_res.h b/windows/win_res.h
index d5f6b809dd111fe6703b11acec9a936c4da9c682..118f74954a346f45949fcde10c63a7eef8ce8252 100644 (file)
--- a/windows/win_res.h
+++ b/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
 

diff --git a/windows/wincons.c b/windows/wincons.c
index e0f0215f6cab416d9197cac4b132fa145b597611..7b763a20d98a77e3905c70f2deec8d4d02cd627b 100644 (file)
--- a/windows/wincons.c
+++ b/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
  */
 

diff --git a/windows/windlg.c b/windows/windlg.c
index 019f6155c177a87dbe8bea08ebe9cd9f84b15895..3f028019ff3fc03a2cf95764bfb51ad02a5c5532 100644 (file)
--- a/windows/windlg.c
+++ b/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>

diff --git a/windows/window.c b/windows/window.c
index 65bca731324faf8e0070c4146e5f99918883a33e..e997ff067e60b1ceffe00805180230a69e1c2499 100644 (file)
--- a/windows/window.c
+++ b/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>

diff --git a/windows/wintime.c b/windows/wintime.c
index eea0cf622e81eb293e2ed7be89c1df61b3b0d5c6..eebed9e5a4e4e5922a42d51f85be768d7df98d09 100644 (file)
--- a/windows/wintime.c
+++ b/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>