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

they're for.

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

diff --git a/cmdline.c b/cmdline.c
index 39f57bb..e834342 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 ab765b3..8122a48 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 f4363e4..49942aa 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 54a6876..e6cf200 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 1370bfd..d1f3c37 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 31d7490..28da09f 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 2d2b288..1b9a806 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 1a7880c..38eb2bb 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 48f277a..f0abd3e 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 41974c2..22992fe 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 fe6f5cf..5038833 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 72ff9f9..806d650 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 2073a09..4f0a195 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 d5f6b80..118f749 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 e0f0215..7b763a2 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 019f615..3f02801 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 65bca73..e997ff0 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 eea0cf6..eebed9e 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>