From 4e2eb85749410256756486fe8a5774e330718e97 Mon Sep 17 00:00:00 2001
From: William McBrine <wmcbrine@gmail.com>
Date: Tue, 2 Jan 2007 14:19:43 +0000
Subject: [PATCH] Useless/incorrect comments.

---
 dos/pdcdisp.c    |  9 +--------
 dos/pdcgetsc.c   | 27 +--------------------------
 dos/pdckbd.c     | 26 +++-----------------------
 dos/pdcscrn.c    | 16 +---------------
 dos/pdcsetsc.c   |  8 +-------
 os2/pdcdisp.c    |  9 +--------
 os2/pdcgetsc.c   | 20 +-------------------
 os2/pdckbd.c     | 26 +++-----------------------
 os2/pdcscrn.c    | 16 +---------------
 os2/pdcsetsc.c   |  8 +-------
 win32/pdcdisp.c  |  9 +--------
 win32/pdcgetsc.c | 30 +-----------------------------
 win32/pdckbd.c   | 23 +----------------------
 win32/pdcscrn.c  | 14 +-------------
 win32/pdcsetsc.c |  5 +----
 x11/pdcdisp.c    |  9 +--------
 x11/pdcgetsc.c   | 18 +-----------------
 x11/pdckbd.c     | 23 +++--------------------
 x11/pdcscrn.c    | 16 +---------------
 x11/pdcsetsc.c   |  8 +-------
 20 files changed, 26 insertions(+), 294 deletions(-)

diff --git a/dos/pdcdisp.c b/dos/pdcdisp.c
index efc095f7..057c101b 100644
--- a/dos/pdcdisp.c
+++ b/dos/pdcdisp.c
@@ -13,7 +13,7 @@
 
 #include "pdcdos.h"
 
-RCSID("$Id: pdcdisp.c,v 1.58 2006/12/16 21:53:17 wmcbrine Exp $");
+RCSID("$Id: pdcdisp.c,v 1.59 2007/01/02 14:19:43 wmcbrine Exp $");
 
 /* ACS definitions originally by jshumate@wrdis01.robins.af.mil -- these
    match code page 437 and compatible pages (CP850, CP852, etc.) */
@@ -79,9 +79,6 @@ void movedata(unsigned sseg, unsigned soff, unsigned dseg,
 	screen. We don't optimize here -- on a PC, it takes more time
 	to optimize than to do things directly.
 
-  Portability:
-	PDCurses  void PDC_gotoyx(int row, int col);
-
 **man-end****************************************************************/
 
 void PDC_gotoyx(int row, int col)
@@ -107,10 +104,6 @@ void PDC_gotoyx(int row, int col)
 	Updates the given physical line to look like the corresponding
 	line in _curscr.
 
-  Portability:
-	PDCurses  void PDC_transform_line(int lineno, int x, int len, 
-					  const chtype *srcp);
-
 **man-end****************************************************************/
 
 void PDC_transform_line(int lineno, int x, int len, const chtype *srcp)
diff --git a/dos/pdcgetsc.c b/dos/pdcgetsc.c
index ef2dd601..1f13f48e 100644
--- a/dos/pdcgetsc.c
+++ b/dos/pdcgetsc.c
@@ -15,7 +15,7 @@
 
 #include <stdlib.h>
 
-RCSID("$Id: pdcgetsc.c,v 1.35 2006/11/05 05:37:40 wmcbrine Exp $");
+RCSID("$Id: pdcgetsc.c,v 1.36 2007/01/02 14:19:43 wmcbrine Exp $");
 
 /*man-start**************************************************************
 
@@ -32,12 +32,6 @@ RCSID("$Id: pdcgetsc.c,v 1.35 2006/11/05 05:37:40 wmcbrine Exp $");
 	This routine will return OK upon success and otherwise ERR will 
 	be returned.
 
-  PDCurses Errors:
-	There are no defined errors for this routine.
-
-  Portability:
-	PDCurses  int PDC_get_cursor_pos(int *row, int *col);
-
 **man-end****************************************************************/
 
 int PDC_get_cursor_pos(int *row, int *col)
@@ -64,16 +58,6 @@ int PDC_get_cursor_pos(int *row, int *col)
 
 	This function will return the width of the current screen.
 
-  PDCurses Return Value:
-	This routine will return OK upon success and otherwise ERR will 
-	be returned.
-
-  PDCurses Errors:
-	There are no defined errors for this routine.
-
-  Portability:
-	PDCurses  int PDC_get_columns(void);
-
 **man-end****************************************************************/
 
 int PDC_get_columns(void)
@@ -108,9 +92,6 @@ int PDC_get_columns(void)
   PDCurses Description:
 	Gets the cursor size.
 
-  Portability:
-	PDCurses  int PDC_get_cursor_mode(void);
-
 **man-end****************************************************************/
 
 int PDC_get_cursor_mode(void)
@@ -130,12 +111,6 @@ int PDC_get_cursor_mode(void)
 	Returns the maximum number of rows supported by the display.
 	e.g. 25, 28, 43, 50, 60, 66...
 
-  PDCurses Return Value:
-	This function returns OK on success and ERR on error.
-
-  Portability:
-	PDCurses  int PDC_get_rows(void);
-
 **man-end****************************************************************/
 
 int PDC_get_rows(void)
diff --git a/dos/pdckbd.c b/dos/pdckbd.c
index e72c15e3..5b240e5b 100644
--- a/dos/pdckbd.c
+++ b/dos/pdckbd.c
@@ -26,7 +26,7 @@
 
 #include "pdcdos.h"
 
-RCSID("$Id: pdckbd.c,v 1.74 2006/12/29 17:08:21 wmcbrine Exp $");
+RCSID("$Id: pdckbd.c,v 1.75 2007/01/02 14:19:43 wmcbrine Exp $");
 
 /************************************************************************
  *    Table for key code translation of function keys in keypad mode	*
@@ -104,12 +104,6 @@ static const unsigned short button_map[3] = {0, 2, 1};
 	This routine will return the file descriptor that PDCurses reads
 	its input from. It can be used for select().
 
-  PDCurses Return Value:
-	Returns a file descriptor.
-
-  Portability:
-	PDCurses  int PDC_get_input_fd(void);
-
 **man-end****************************************************************/
 
 unsigned long PDC_get_input_fd(void)
@@ -135,10 +129,8 @@ void PDC_set_keyboard_binary(bool on)
 	keystrokes are pending.
 
   PDCurses Return Value:
-	Returns 1 if a keyboard character is available, 0 otherwise.
-
-  Portability:
-	PDCurses  bool PDC_check_bios_key(void);
+	Returns TRUE if a keyboard character is available, FALSE
+	otherwise.
 
 **man-end****************************************************************/
 
@@ -356,9 +348,6 @@ static int _process_mouse_events(void)
 
 	Returns the next key code struck at the keyboard.
 
-  Portability:
-	PDCurses  int PDC_get_bios_key(void);
-
 **man-end****************************************************************/
 
 int PDC_get_bios_key(void)
@@ -505,9 +494,6 @@ int PDC_get_bios_key(void)
 	This function returns TRUE if the Control Break Check is enabled 
 	otherwise FALSE is returned.
 
-  Portability:
-	PDCurses  bool PDC_get_ctrl_break(void);
-
 **man-end****************************************************************/
 
 bool PDC_get_ctrl_break(void)
@@ -537,9 +523,6 @@ bool PDC_get_ctrl_break(void)
   PDCurses Return Value:
 	This function returns OK on success and ERR on error.
 
-  Portability:
-	PDCurses  int PDC_set_ctrl_break(bool setting);
-
 **man-end****************************************************************/
 
 int PDC_set_ctrl_break(bool setting)
@@ -572,9 +555,6 @@ int PDC_set_ctrl_break(bool setting)
 	Discards any pending keyboard and mouse input. Called by 
 	flushinp().
 
-  Portability:
-	PDCurses  void PDC_flushinp(void);
-
 **man-end****************************************************************/
 
 void PDC_flushinp(void)
diff --git a/dos/pdcscrn.c b/dos/pdcscrn.c
index 6237359f..33fe01ee 100644
--- a/dos/pdcscrn.c
+++ b/dos/pdcscrn.c
@@ -15,7 +15,7 @@
 
 #include <stdlib.h>
 
-RCSID("$Id: pdcscrn.c,v 1.77 2006/12/29 18:36:35 wmcbrine Exp $");
+RCSID("$Id: pdcscrn.c,v 1.78 2007/01/02 14:19:43 wmcbrine Exp $");
 
 int	pdc_adapter;		/* screen type				*/
 int	pdc_scrnmode;		/* default screen mode			*/
@@ -447,12 +447,6 @@ static int _query_adapter_type(void)
 	May restore the screen to its state before PDC_scr_open(); 
 	miscellaneous cleanup.
 
-  PDCurses Return Value:
-	This function returns OK on success, otherwise an ERR is returned.
-
-  Portability:
-	PDCurses  void PDC_scr_close(void);
-
 **man-end****************************************************************/
 
 void PDC_scr_close(void)
@@ -521,9 +515,6 @@ void PDC_scr_free(void)
   PDCurses Return Value:
 	This function returns OK on success, otherwise an ERR is returned.
 
-  Portability:
-	PDCurses  int PDC_scr_open(int argc, char **argv);
-
 **man-end****************************************************************/
 
 int PDC_scr_open(int argc, char **argv)
@@ -621,11 +612,6 @@ int PDC_scr_open(int argc, char **argv)
   PDCurses Return Value:
 	This function returns OK on success, otherwise an ERR is returned.
 
-  PDCurses Errors:
-
-  Portability:
-	PDCurses  int PDC_resize_screen(int, int);
-
 **man-end****************************************************************/
 
 int PDC_resize_screen(int nlines, int ncols)
diff --git a/dos/pdcsetsc.c b/dos/pdcsetsc.c
index 37f447b6..648d7580 100644
--- a/dos/pdcsetsc.c
+++ b/dos/pdcsetsc.c
@@ -13,7 +13,7 @@
 
 #include "pdcdos.h"
 
-RCSID("$Id: pdcsetsc.c,v 1.32 2006/10/18 22:35:11 wmcbrine Exp $");
+RCSID("$Id: pdcsetsc.c,v 1.33 2007/01/02 14:19:43 wmcbrine Exp $");
 
 int PDC_curs_set(int visibility)
 {
@@ -59,12 +59,6 @@ int PDC_curs_set(int visibility)
 	Sets the title of the window in which the curses program is 
 	running. This function does not do anything on DOS.
 
-  PDCurses Return Value:
-	N/A
-
-  Portability:
-	PDCurses  void PDC_set_title(const char *title);
-
 **man-end****************************************************************/
 
 void PDC_set_title(const char *title)
diff --git a/os2/pdcdisp.c b/os2/pdcdisp.c
index 29455135..c0a07409 100644
--- a/os2/pdcdisp.c
+++ b/os2/pdcdisp.c
@@ -13,7 +13,7 @@
 
 #include "pdcos2.h"
 
-RCSID("$Id: pdcdisp.c,v 1.42 2006/12/16 21:53:17 wmcbrine Exp $");
+RCSID("$Id: pdcdisp.c,v 1.43 2007/01/02 14:19:43 wmcbrine Exp $");
 
 /* ACS definitions originally by jshumate@wrdis01.robins.af.mil -- these 
    match code page 437 and compatible pages (CP850, CP852, etc.) */
@@ -67,9 +67,6 @@ chtype acs_map[128] =
 	We don't optimize here -- on a PC, it takes more time to 
 	optimize than to do things directly.
 
-  Portability:
-	PDCurses  void PDC_gotoyx(int row, int col);
-
 **man-end****************************************************************/
 
 void PDC_gotoyx(int row, int col)
@@ -93,10 +90,6 @@ void PDC_gotoyx(int row, int col)
 	Updates the given physical line to look like the corresponding
 	line in _curscr.
 
-  Portability:
-	PDCurses  void PDC_transform_line(int lineno, int x, int len, 
-					  const chtype *srcp);
-
 **man-end****************************************************************/
 
 void PDC_transform_line(int lineno, int x, int len, const chtype *srcp)
diff --git a/os2/pdcgetsc.c b/os2/pdcgetsc.c
index c4f7c476..97a91734 100644
--- a/os2/pdcgetsc.c
+++ b/os2/pdcgetsc.c
@@ -13,7 +13,7 @@
 
 #include "pdcos2.h"
 
-RCSID("$Id: pdcgetsc.c,v 1.32 2006/11/05 05:37:40 wmcbrine Exp $");
+RCSID("$Id: pdcgetsc.c,v 1.33 2007/01/02 14:19:43 wmcbrine Exp $");
 
 /*man-start**************************************************************
 
@@ -30,12 +30,6 @@ RCSID("$Id: pdcgetsc.c,v 1.32 2006/11/05 05:37:40 wmcbrine Exp $");
 	This routine will return OK upon success and otherwise ERR will 
 	be returned.
 
-  PDCurses Errors:
-	There are no defined errors for this routine.
-
-  Portability:
-	PDCurses  int PDC_get_cursor_pos(int *row, int *col);
-
 **man-end****************************************************************/
 
 int PDC_get_cursor_pos(int *row, int *col)
@@ -63,12 +57,6 @@ int PDC_get_cursor_pos(int *row, int *col)
 	This routine will return OK upon success and otherwise ERR will 
 	be returned.
 
-  PDCurses Errors:
-	There are no defined errors for this routine.
-
-  Portability:
-	PDCurses  int PDC_get_columns(void);
-
 **man-end****************************************************************/
 
 int PDC_get_columns(void)
@@ -107,9 +95,6 @@ int PDC_get_columns(void)
   PDCurses Description:
 	Gets the cursor size.
 
-  Portability:
-	PDCurses  int PDC_get_cursor_mode(void);
-
 **man-end****************************************************************/
 
 int PDC_get_cursor_mode(void)
@@ -144,9 +129,6 @@ int PDC_get_cursor_mode(void)
   PDCurses Return Value:
 	This function returns OK on success and ERR on error.
 
-  Portability:
-	PDCurses  int PDC_get_rows(void);
-
 **man-end****************************************************************/
 
 int PDC_get_rows(void)
diff --git a/os2/pdckbd.c b/os2/pdckbd.c
index ffa9686f..91742c97 100644
--- a/os2/pdckbd.c
+++ b/os2/pdckbd.c
@@ -35,7 +35,7 @@ static bool key_pressed = FALSE;
 static int mouse_events = 0;
 #endif
 
-RCSID("$Id: pdckbd.c,v 1.75 2006/12/24 06:07:25 wmcbrine Exp $");
+RCSID("$Id: pdckbd.c,v 1.76 2007/01/02 14:19:43 wmcbrine Exp $");
 
 /************************************************************************
  *   Table for key code translation of function keys in keypad mode	*
@@ -100,12 +100,6 @@ unsigned long pdc_key_modifiers = 0L;
 	This routine will return the file descriptor that PDCurses reads
 	its input from. It can be used for select().
 
-  PDCurses Return Value:
-	Returns a file descriptor.
-
-  Portability:
-	PDCurses  int PDC_get_input_fd(void);
-
 **man-end****************************************************************/
 
 unsigned long PDC_get_input_fd(void)
@@ -183,10 +177,8 @@ void PDC_set_keyboard_binary(bool on)
 	keystrokes are pending.
 
   PDCurses Return Value:
-	Returns 1 if a keyboard character is available, 0 otherwise.
-
-  Portability:
-	PDCurses  bool PDC_check_bios_key(void);
+	Returns TRUE if a keyboard character is available, FALSE 
+	otherwise.
 
 **man-end****************************************************************/
 
@@ -371,9 +363,6 @@ static int _process_mouse_events(void)
 
 	Returns the next key code struck at the keyboard.
 
-  Portability:
-	PDCurses  int PDC_get_bios_key(void);
-
 **man-end****************************************************************/
 
 int PDC_get_bios_key(void)
@@ -534,9 +523,6 @@ int PDC_get_bios_key(void)
 	This function returns TRUE if the Control Break Check is enabled 
 	otherwise FALSE is returned.
 
-  Portability:
-	PDCurses  bool PDC_get_ctrl_break(void);
-
 **man-end****************************************************************/
 
 bool PDC_get_ctrl_break(void)
@@ -592,9 +578,6 @@ bool PDC_get_ctrl_break(void)
   PDCurses Return Value:
 	This function returns OK on success and ERR on error.
 
-  Portability:
-	PDCurses  int PDC_set_ctrl_break(bool setting);
-
 **man-end****************************************************************/
 
 int PDC_set_ctrl_break(bool setting)
@@ -633,9 +616,6 @@ int PDC_set_ctrl_break(bool setting)
 	Discards any pending keyboard and mouse input. Called by 
 	flushinp().
 
-  Portability:
-	PDCurses  void PDC_flushinp(void);
-
 **man-end****************************************************************/
 
 void PDC_flushinp(void)
diff --git a/os2/pdcscrn.c b/os2/pdcscrn.c
index a19d6350..a71d3395 100644
--- a/os2/pdcscrn.c
+++ b/os2/pdcscrn.c
@@ -13,7 +13,7 @@
 
 #include "pdcos2.h"
 
-RCSID("$Id: pdcscrn.c,v 1.63 2006/12/28 09:51:31 wmcbrine Exp $");
+RCSID("$Id: pdcscrn.c,v 1.64 2007/01/02 14:19:43 wmcbrine Exp $");
 
 int pdc_font;			/* default font size	*/
 
@@ -107,12 +107,6 @@ static void _set_font(int size)
 	May restore the screen to its state before PDC_scr_open();
 	miscellaneous cleanup.
 
-  PDCurses Return Value:
-	This function returns OK on success, otherwise an ERR is returned.
-
-  Portability:
-	PDCurses  void PDC_scr_close(void);
-
 **man-end****************************************************************/
 
 void PDC_scr_close(void)
@@ -161,9 +155,6 @@ void PDC_scr_free(void)
   PDCurses Return Value:
 	This function returns OK on success, otherwise an ERR is returned.
 
-  Portability:
-	PDCurses  int PDC_scr_open(int argc, char **argv);
-
 **man-end****************************************************************/
 
 int PDC_scr_open(int argc, char **argv)
@@ -254,11 +245,6 @@ int PDC_scr_open(int argc, char **argv)
 	This function returns OK on success, otherwise an ERR is 
 	returned.
 
-  PDCurses Errors:
-
-  Portability:
-	PDCurses  int PDC_resize_screen(int, int);
-
 **man-end****************************************************************/
 
 int PDC_resize_screen(int nlines, int ncols)
diff --git a/os2/pdcsetsc.c b/os2/pdcsetsc.c
index 311f23dd..139090c2 100644
--- a/os2/pdcsetsc.c
+++ b/os2/pdcsetsc.c
@@ -13,7 +13,7 @@
 
 #include "pdcos2.h"
 
-RCSID("$Id: pdcsetsc.c,v 1.37 2006/11/13 21:17:54 wmcbrine Exp $");
+RCSID("$Id: pdcsetsc.c,v 1.38 2007/01/02 14:19:43 wmcbrine Exp $");
 
 int PDC_curs_set(int visibility)
 {
@@ -72,12 +72,6 @@ int PDC_curs_set(int visibility)
 	Sets the title of the window in which the curses program is 
 	running. This function may not do anything on some platforms.
 
-  PDCurses Return Value:
-	N/A
-
-  Portability:
-	PDCurses void PDC_set_title(const char *title);
-
 **man-end****************************************************************/
 
 void PDC_set_title(const char *title)
diff --git a/win32/pdcdisp.c b/win32/pdcdisp.c
index f21b011b..ac2c719b 100644
--- a/win32/pdcdisp.c
+++ b/win32/pdcdisp.c
@@ -16,7 +16,7 @@
 #include <stdlib.h>
 #include <string.h>
 
-RCSID("$Id: pdcdisp.c,v 1.40 2006/12/16 21:53:17 wmcbrine Exp $");
+RCSID("$Id: pdcdisp.c,v 1.41 2007/01/02 14:19:43 wmcbrine Exp $");
 
 #ifdef CHTYPE_LONG
 
@@ -86,9 +86,6 @@ chtype acs_map[128] =
 	We don't optimize here -- on a PC, it takes more time to 
 	optimize than to do things directly.
 
-  Portability:
-	PDCurses  void PDC_gotoyx(int row, int col);
-
 **man-end****************************************************************/
 
 void PDC_gotoyx(int row, int col)
@@ -114,10 +111,6 @@ void PDC_gotoyx(int row, int col)
 	Updates the given physical line to look like the corresponding
 	line in _curscr.
 
-  Portability:
-	PDCurses  void PDC_transform_line(int lineno, int x, int len, 
-					  const chtype *srcp);
-
 **man-end****************************************************************/
 
 void PDC_transform_line(int lineno, int x, int len, const chtype *srcp)
diff --git a/win32/pdcgetsc.c b/win32/pdcgetsc.c
index dccbe64a..03eef72d 100644
--- a/win32/pdcgetsc.c
+++ b/win32/pdcgetsc.c
@@ -13,7 +13,7 @@
 
 #include "pdcwin.h"
 
-RCSID("$Id: pdcgetsc.c,v 1.29 2006/10/15 02:42:26 wmcbrine Exp $");
+RCSID("$Id: pdcgetsc.c,v 1.30 2007/01/02 14:19:43 wmcbrine Exp $");
 
 /*man-start**************************************************************
 
@@ -30,12 +30,6 @@ RCSID("$Id: pdcgetsc.c,v 1.29 2006/10/15 02:42:26 wmcbrine Exp $");
 	This routine will return OK upon success and otherwise ERR will
 	be returned.
 
-  PDCurses Errors:
-	There are no defined errors for this routine.
-
-  Portability:
-	PDCurses  int PDC_get_cursor_pos(int *row, int *col);
-
 **man-end****************************************************************/
 
 int PDC_get_cursor_pos(int *row, int *col)
@@ -59,9 +53,6 @@ int PDC_get_cursor_pos(int *row, int *col)
   PDCurses Description:
 	Gets the cursor size.
 
-  Portability:
-	PDCurses  int PDC_get_cursor_mode(void);
-
 **man-end****************************************************************/
 
 int PDC_get_cursor_mode(void)
@@ -85,12 +76,6 @@ int PDC_get_cursor_mode(void)
 	Returns the maximum number of rows supported by the display.
 	e.g.  25, 28, 43, 50, 60, 66...
 
-  PDCurses Return Value:
-	This function returns OK on success and ERR on error.
-
-  Portability:
-	PDCurses  int PDC_get_rows(void);
-
 **man-end****************************************************************/
 
 int PDC_get_rows(void)
@@ -114,9 +99,6 @@ int PDC_get_rows(void)
   PDCurses Return Value:
 	Returns the maximum number of rows in the screen buffer.
 
-  Portability:
-	PDCurses  int PDC_get_buffer_rows(void);
-
 **man-end****************************************************************/
 
 int PDC_get_buffer_rows(void)
@@ -139,16 +121,6 @@ int PDC_get_buffer_rows(void)
 
 	This function will return the width of the current screen.
 
-  PDCurses Return Value:
-	This routine will return OK upon success and otherwise ERR will
-	be returned.
-
-  PDCurses Errors:
-	There are no defined errors for this routine.
-
-  Portability:
-	PDCurses  int PDC_get_columns(void);
-
 **man-end****************************************************************/
 
 int PDC_get_columns(void)
diff --git a/win32/pdckbd.c b/win32/pdckbd.c
index 417b9fe8..b2a36642 100644
--- a/win32/pdckbd.c
+++ b/win32/pdckbd.c
@@ -13,7 +13,7 @@
 
 #include "pdcwin.h"
 
-RCSID("$Id: pdckbd.c,v 1.101 2006/12/24 06:07:25 wmcbrine Exp $");
+RCSID("$Id: pdckbd.c,v 1.102 2007/01/02 14:19:43 wmcbrine Exp $");
 
 unsigned long pdc_key_modifiers = 0L;
 
@@ -237,12 +237,6 @@ static KPTAB ext_kptab[] =
 	This routine will return the file descriptor that PDCurses reads
 	its input from. It can be used for WaitForMulitpleObjects().
 
-  PDCurses Return Value:
-	Returns a HANDLE.
-
-  Portability:
-	PDCurses  int PDC_get_input_fd(void);
-
 **man-end****************************************************************/
 
 unsigned long PDC_get_input_fd(void)
@@ -636,12 +630,6 @@ static int _process_mouse_event(void)
 	bits are 0, the upper bits contain the extended character
 	code. If bit 0-7 are non-zero, the upper bits = 0.
 
-  PDCurses Return Value:
-	See above.
-
-  Portability:
-	PDCurses  int PDC_get_bios_key(void);
-
 **man-end****************************************************************/
 
 int PDC_get_bios_key(void)
@@ -693,9 +681,6 @@ int PDC_get_bios_key(void)
 	This function returns TRUE if the Control Break Check is 
 	enabled; otherwise, FALSE is returned.
 
-  Portability:
-	PDCurses  bool PDC_get_ctrl_break(void);
-
 **man-end****************************************************************/
 
 bool PDC_get_ctrl_break(void)
@@ -719,9 +704,6 @@ bool PDC_get_ctrl_break(void)
   PDCurses Return Value:
 	This function returns OK on success and ERR on error.
 
-  Portability:
-	PDCurses  int PDC_set_ctrl_break(bool setting);
-
 **man-end****************************************************************/
 
 int PDC_set_ctrl_break(bool setting)
@@ -741,9 +723,6 @@ int PDC_set_ctrl_break(bool setting)
 	Discards any pending keyboard and mouse input. Called by 
 	flushinp().
 
-  Portability:
-	PDCurses  void PDC_flushinp(void);
-
 **man-end****************************************************************/
 
 void PDC_flushinp(void)
diff --git a/win32/pdcscrn.c b/win32/pdcscrn.c
index e27410dc..ba6a4e66 100644
--- a/win32/pdcscrn.c
+++ b/win32/pdcscrn.c
@@ -13,7 +13,7 @@
 
 #include "pdcwin.h"
 
-RCSID("$Id: pdcscrn.c,v 1.75 2006/12/28 09:51:31 wmcbrine Exp $");
+RCSID("$Id: pdcscrn.c,v 1.76 2007/01/02 14:19:43 wmcbrine Exp $");
 
 #define PDC_RESTORE_NONE     0
 #define PDC_RESTORE_BUFFER   1
@@ -222,12 +222,6 @@ static void _init_console_info(void)
 	May restore the screen to its state before PDC_scr_open();
 	miscellaneous cleanup.
 
-  PDCurses Return Value:
-	This function returns OK on success, otherwise an ERR is returned.
-
-  Portability:
-	PDCurses  void PDC_scr_close(void);
-
 **man-end****************************************************************/
 
 void PDC_scr_close(void)
@@ -296,9 +290,6 @@ void PDC_scr_free(void)
   PDCurses Return Value:
 	This function returns OK on success, otherwise an ERR is returned.
 
-  Portability:
-	PDCurses  int PDC_scr_open(int argc, char **argv);
-
 **man-end****************************************************************/
 
 int PDC_scr_open(int argc, char **argv)
@@ -523,9 +514,6 @@ static BOOL _fit_console_window(HANDLE con_out, CONST SMALL_RECT *rect)
 	This function returns OK on success, otherwise an ERR is 
 	returned.
 
-  Portability:
-	PDCurses  int PDC_resize_screen(int, int);
-
 **man-end****************************************************************/
 
 int PDC_resize_screen(int nlines, int ncols)
diff --git a/win32/pdcsetsc.c b/win32/pdcsetsc.c
index dcac6d03..aa48793e 100644
--- a/win32/pdcsetsc.c
+++ b/win32/pdcsetsc.c
@@ -13,7 +13,7 @@
 
 #include "pdcwin.h"
 
-RCSID("$Id: pdcsetsc.c,v 1.32 2006/10/15 02:42:26 wmcbrine Exp $");
+RCSID("$Id: pdcsetsc.c,v 1.33 2007/01/02 14:19:43 wmcbrine Exp $");
 
 int PDC_curs_set(int visibility)
 {
@@ -57,9 +57,6 @@ int PDC_curs_set(int visibility)
 	Sets the title of the window in which the curses program is 
 	running. This function may not do anything on some platforms.
 
-  Portability:
-	PDCurses  void PDC_set_title(const char *title);
-
 **man-end****************************************************************/
 
 void PDC_set_title(const char *title)
diff --git a/x11/pdcdisp.c b/x11/pdcdisp.c
index 33b794a4..c2748b0f 100644
--- a/x11/pdcdisp.c
+++ b/x11/pdcdisp.c
@@ -15,7 +15,7 @@
 
 #include <string.h>
 
-RCSID("$Id: pdcdisp.c,v 1.40 2006/12/16 21:53:18 wmcbrine Exp $");
+RCSID("$Id: pdcdisp.c,v 1.41 2007/01/02 14:19:43 wmcbrine Exp $");
 
 #ifdef CHTYPE_LONG
 
@@ -126,9 +126,6 @@ int PDC_display_cursor(int oldrow, int oldcol, int newrow, int newcol,
 	screen. We don't optimize here -- on a PC, it takes more time
 	to optimize than to do things directly.
 
-  Portability:
-	PDCurses  void PDC_gotoyx(int row, int col);
-
 **man-end****************************************************************/
 
 void PDC_gotoyx(int row, int col)
@@ -149,10 +146,6 @@ void PDC_gotoyx(int row, int col)
 	Updates the given physical line to look like the corresponding
 	line in _curscr.
 
-  Portability:
-	PDCurses  void PDC_transform_line(int lineno, int x, int len, 
-					  const chtype *srcp);
-
 **man-end****************************************************************/
 
 void PDC_transform_line(int lineno, int x, int len, const chtype *srcp)
diff --git a/x11/pdcgetsc.c b/x11/pdcgetsc.c
index 36c1faf0..05142e03 100644
--- a/x11/pdcgetsc.c
+++ b/x11/pdcgetsc.c
@@ -13,7 +13,7 @@
 
 #include "pdcx11.h"
 
-RCSID("$Id: pdcgetsc.c,v 1.20 2006/10/18 23:09:16 wmcbrine Exp $");
+RCSID("$Id: pdcgetsc.c,v 1.21 2007/01/02 14:19:43 wmcbrine Exp $");
 
 /*man-start**************************************************************
 
@@ -24,16 +24,6 @@ RCSID("$Id: pdcgetsc.c,v 1.20 2006/10/18 23:09:16 wmcbrine Exp $");
 
 	This function will return the width of the current screen.
 
-  PDCurses Return Value:
-	This routine will return OK upon success and otherwise ERR will
-	be returned.
-
-  PDCurses Errors:
-	There are no defined errors for this routine.
-
-  Portability:
-	PDCurses  int PDC_get_columns(void);
-
 **man-end****************************************************************/
 
 int PDC_get_columns(void)
@@ -58,12 +48,6 @@ int PDC_get_cursor_mode(void)
 	Returns the maximum number of rows supported by the display.
 	e.g.  25, 28, 43, 50, 60, 66...
 
-  PDCurses Return Value:
-	This function returns OK on success and ERR on error.
-
-  Portability:
-	PDCurses  int PDC_get_rows(void);
-
 **man-end****************************************************************/
 
 int PDC_get_rows(void)
diff --git a/x11/pdckbd.c b/x11/pdckbd.c
index 46e65508..8cb20c54 100644
--- a/x11/pdckbd.c
+++ b/x11/pdckbd.c
@@ -13,7 +13,7 @@
 
 #include "pdcx11.h"
 
-RCSID("$Id: pdckbd.c,v 1.53 2006/11/27 04:23:26 wmcbrine Exp $");
+RCSID("$Id: pdckbd.c,v 1.54 2007/01/02 14:19:43 wmcbrine Exp $");
 
 /*man-start**************************************************************
 
@@ -26,10 +26,8 @@ RCSID("$Id: pdckbd.c,v 1.53 2006/11/27 04:23:26 wmcbrine Exp $");
 	keystrokes are pending.
 
   PDCurses Return Value:
-	Returns 1 if a keyboard character is available, 0 otherwise.
-
-  Portability:
-	PDCurses  bool PDC_check_bios_key(void);
+	Returns TRUE if a keyboard character is available, FALSE 
+	otherwise.
 
 **man-end****************************************************************/
 
@@ -92,12 +90,6 @@ int PDC_get_bios_key(void)
 	This routine will return the file descriptor that PDCurses reads
 	its input from. It can be used for select().
 
-  PDCurses Return Value:
-	Returns a file descriptor.
-
-  Portability:
-	PDCurses  int PDC_get_input_fd(void);
-
 **man-end****************************************************************/
 
 unsigned long PDC_get_input_fd(void)
@@ -125,9 +117,6 @@ void PDC_set_keyboard_binary(bool on)
 	This function returns TRUE if the Control Break
 	Check is enabled otherwise FALSE is returned.
 
-  Portability:
-	PDCurses  bool PDC_get_ctrl_break(void);
-
 **man-end****************************************************************/
 
 bool PDC_get_ctrl_break(void)
@@ -151,9 +140,6 @@ bool PDC_get_ctrl_break(void)
   PDCurses Return Value:
 	This function returns OK on success and ERR on error.
 
-  Portability:
-	PDCurses  int PDC_set_ctrl_break(bool setting);
-
 **man-end****************************************************************/
 
 int PDC_set_ctrl_break(bool setting)
@@ -173,9 +159,6 @@ int PDC_set_ctrl_break(bool setting)
 	Discards any pending keyboard and mouse input. Called by 
 	flushinp().
 
-  Portability:
-	PDCurses  void PDC_flushinp(void);
-
 **man-end****************************************************************/
 
 void PDC_flushinp(void)
diff --git a/x11/pdcscrn.c b/x11/pdcscrn.c
index 7f88a119..52db230c 100644
--- a/x11/pdcscrn.c
+++ b/x11/pdcscrn.c
@@ -13,7 +13,7 @@
 
 #include "pdcx11.h"
 
-RCSID("$Id: pdcscrn.c,v 1.48 2006/11/12 10:26:14 wmcbrine Exp $");
+RCSID("$Id: pdcscrn.c,v 1.49 2007/01/02 14:19:43 wmcbrine Exp $");
 
 /*man-start**************************************************************
 
@@ -24,12 +24,6 @@ RCSID("$Id: pdcscrn.c,v 1.48 2006/11/12 10:26:14 wmcbrine Exp $");
 	May restore the screen to its state before PDC_scr_open();
 	miscellaneous cleanup.
 
-  PDCurses Return Value:
-	This function returns OK on success, otherwise an ERR is returned.
-
-  Portability:
-	PDCurses  void PDC_scr_close(void);
-
 **man-end****************************************************************/
 
 void PDC_scr_close(void)
@@ -55,9 +49,6 @@ void PDC_scr_free(void)
   PDCurses Return Value:
 	This function returns OK on success, otherwise an ERR is returned.
 
-  Portability:
-	PDCurses  int PDC_scr_open(int argc, char **argv);
-
 **man-end****************************************************************/
 
 int PDC_scr_open(int argc, char **argv)
@@ -96,11 +87,6 @@ int PDC_scr_open(int argc, char **argv)
   PDCurses Return Value:
 	This function returns OK on success, otherwise an ERR is returned.
 
-  PDCurses Errors:
-
-  Portability:
-	PDCurses  int PDC_resize_screen(int, int);
-
 **man-end****************************************************************/
 
 int PDC_resize_screen(int nlines, int ncols)
diff --git a/x11/pdcsetsc.c b/x11/pdcsetsc.c
index b1836fe2..e3a2debd 100644
--- a/x11/pdcsetsc.c
+++ b/x11/pdcsetsc.c
@@ -15,7 +15,7 @@
 
 #include <string.h>
 
-RCSID("$Id: pdcsetsc.c,v 1.26 2006/10/15 02:42:26 wmcbrine Exp $");
+RCSID("$Id: pdcsetsc.c,v 1.27 2007/01/02 14:19:43 wmcbrine Exp $");
 
 int PDC_curs_set(int visibility)
 {
@@ -41,12 +41,6 @@ int PDC_curs_set(int visibility)
 	Sets the title of the window in which the curses program is 
 	running. This function may not do anything on some platforms.
 
-  PDCurses Return Value:
-	N/A
-
-  Portability:
-	PDCurses  void PDC_set_title(const char *title);
-
 **man-end****************************************************************/
 
 void PDC_set_title(const char *title)