]> ncurses.scripts.mit.edu Git - ncurses.git/commitdiff
ncurses 5.9 - patch 20111015
authorThomas E. Dickey <dickey@invisible-island.net>
Sun, 16 Oct 2011 01:15:17 +0000 (01:15 +0000)
committerThomas E. Dickey <dickey@invisible-island.net>
Sun, 16 Oct 2011 01:15:17 +0000 (01:15 +0000)
+ improve description of --disable-tic-depends option to make it
  clear that it may be useful whether or not the --with-termlib
  option is also given (report by Sven Joachim).
+ amend termcap equivalent for set_pglen_inch to use the X/Open
  "YI" rather than the obsolete Solaris 2.5 "sL" (cf: 990109).
+ improve manpage for tgetent differences from termcap library.

INSTALL
NEWS
dist.mk
include/Caps
include/Caps.aix4
include/Caps.hpux11
include/Caps.keys
include/Caps.osf1r5
man/curs_termcap.3x

diff --git a/INSTALL b/INSTALL
index 72a599e588a7f97c1265dd6ae564b175ce3a5043..c7dd3278c26717171a189f9e9dcac1cdbb911f1b 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -25,7 +25,7 @@
 -- sale, use or other dealings in this Software without prior written        --
 -- authorization.                                                            --
 -------------------------------------------------------------------------------
 -- sale, use or other dealings in this Software without prior written        --
 -- authorization.                                                            --
 -------------------------------------------------------------------------------
--- $Id: INSTALL,v 1.159 2011/09/10 20:19:24 tom Exp $
+-- $Id: INSTALL,v 1.160 2011/10/15 23:32:49 tom Exp $
 ---------------------------------------------------------------------
              How to install Ncurses/Terminfo on your system
 ---------------------------------------------------------------------
 ---------------------------------------------------------------------
              How to install Ncurses/Terminfo on your system
 ---------------------------------------------------------------------
@@ -407,13 +407,14 @@ SUMMARY OF CONFIGURE OPTIONS:
 
     --disable-tic-depends
        When building shared libraries, normally the tic library is linked to
 
     --disable-tic-depends
        When building shared libraries, normally the tic library is linked to
-       depend upon the ncurses library (and in turn, on the term-library if
-       the --with-termlib option was given).  The tic- and term-libraries
-       ABI does not depend on the --enable-widec option. Some packagers have
-       used this to reduce the number of library files which are packaged
-       by using only one copy of those libraries.  To make this work properly,
+       depend upon the ncurses library (or equivalently, on the tinfo-library
+       if the --with-termlib option was given).  The tic- and tinfo-library
+       ABIs do not depend on the --enable-widec option.  Some packagers have
+       used this to reduce the number of library files which are packaged by
+       using only one copy of those libraries.  To make this work properly,
        the tic library must be built without an explicit dependency on the
        the tic library must be built without an explicit dependency on the
-       ncurses (or ncursesw) library.  Use this configure option to do that.
+       underlying library (ncurses vs ncursesw, tinfo vs tinfow).  Use this
+       configure option to do that.
        For example
                configure --with-ticlib --with-shared --disable-tic-depends
 
        For example
                configure --with-ticlib --with-shared --disable-tic-depends
 
diff --git a/NEWS b/NEWS
index 9795fd681c2e21cc286a711d287dab2827bed9a2..b4087abb957b6f8a63a31784edaacbd579384e91 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -25,7 +25,7 @@
 -- sale, use or other dealings in this Software without prior written        --
 -- authorization.                                                            --
 -------------------------------------------------------------------------------
 -- sale, use or other dealings in this Software without prior written        --
 -- authorization.                                                            --
 -------------------------------------------------------------------------------
--- $Id: NEWS,v 1.1798 2011/10/08 21:06:49 tom Exp $
+-- $Id: NEWS,v 1.1800 2011/10/15 23:34:06 tom Exp $
 -------------------------------------------------------------------------------
 
 This is a log of changes that ncurses has gone through since Zeyd started
 -------------------------------------------------------------------------------
 
 This is a log of changes that ncurses has gone through since Zeyd started
@@ -45,6 +45,14 @@ See the AUTHORS file for the corresponding full names.
 Changes through 1.9.9e did not credit all contributions;
 it is not possible to add this information.
 
 Changes through 1.9.9e did not credit all contributions;
 it is not possible to add this information.
 
+20111015
+       + improve description of --disable-tic-depends option to make it
+         clear that it may be useful whether or not the --with-termlib
+         option is also given (report by Sven Joachim).
+       + amend termcap equivalent for set_pglen_inch to use the X/Open
+         "YI" rather than the obsolete Solaris 2.5 "sL" (cf: 990109).
+       + improve manpage for tgetent differences from termcap library.
+
 20111008
        + moved static data from db_iterator.c to lib_data.c
        + modify db_iterator.c for memory-leak checking, fix one leak.
 20111008
        + moved static data from db_iterator.c to lib_data.c
        + modify db_iterator.c for memory-leak checking, fix one leak.
diff --git a/dist.mk b/dist.mk
index e5ee9afe603b088ca924da345b6a46033f545742..3b505c3bac50439be519d8bf1c2a860d9702f5fe 100644 (file)
--- a/dist.mk
+++ b/dist.mk
@@ -25,7 +25,7 @@
 # use or other dealings in this Software without prior written               #
 # authorization.                                                             #
 ##############################################################################
 # use or other dealings in this Software without prior written               #
 # authorization.                                                             #
 ##############################################################################
-# $Id: dist.mk,v 1.838 2011/10/08 15:25:29 tom Exp $
+# $Id: dist.mk,v 1.839 2011/10/15 20:34:38 tom Exp $
 # Makefile for creating ncurses distributions.
 #
 # This only needs to be used directly as a makefile by developers, but
 # Makefile for creating ncurses distributions.
 #
 # This only needs to be used directly as a makefile by developers, but
@@ -37,7 +37,7 @@ SHELL = /bin/sh
 # These define the major/minor/patch versions of ncurses.
 NCURSES_MAJOR = 5
 NCURSES_MINOR = 9
 # These define the major/minor/patch versions of ncurses.
 NCURSES_MAJOR = 5
 NCURSES_MINOR = 9
-NCURSES_PATCH = 20111008
+NCURSES_PATCH = 20111015
 
 # We don't append the patch to the version, since this only applies to releases
 VERSION = $(NCURSES_MAJOR).$(NCURSES_MINOR)
 
 # We don't append the patch to the version, since this only applies to releases
 VERSION = $(NCURSES_MAJOR).$(NCURSES_MINOR)
index f9a8ebd32aac389224283fdc2f9225a36dd8fa95..cb650a6be900c9d460498aa46d7843a11da57446 100644 (file)
@@ -1,5 +1,5 @@
 ##############################################################################
 ##############################################################################
-# Copyright (c) 1998-2006,2010 Free Software Foundation, Inc.                #
+# Copyright (c) 1998-2010,2011 Free Software Foundation, Inc.                #
 #                                                                            #
 # Permission is hereby granted, free of charge, to any person obtaining a    #
 # copy of this software and associated documentation files (the "Software"), #
 #                                                                            #
 # Permission is hereby granted, free of charge, to any person obtaining a    #
 # copy of this software and associated documentation files (the "Software"), #
@@ -29,7 +29,7 @@
 # Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1992,1995
 #    and: Eric S. Raymond <esr@snark.thyrsus.com>
 #
 # Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1992,1995
 #    and: Eric S. Raymond <esr@snark.thyrsus.com>
 #
-# $Id: Caps,v 1.37 2010/12/04 18:47:13 tom Exp $
+# $Id: Caps,v 1.38 2011/10/15 23:10:18 tom Exp $
 #
 # This is the master termcap/terminfo capability table.
 #
 #
 # This is the master termcap/terminfo capability table.
 #
@@ -738,11 +738,13 @@ alt_scancode_esc          scesa   str     S8      -               -       -----   Alternate escape for scancode emulatio
 #%.ad
 #%
 #%.in .8i
 #%.ad
 #%
 #%.in .8i
-#%The XSI Curses standard added these.  They are some post-4.1 
-#%versions of System V curses, e.g., Solaris 2.5 and IRIX 6.x.
-#%The \fBncurses\fR termcap names for them are invented; according to the
-#%XSI Curses standard, they have no termcap names.  If your compiled terminfo
-#%entries use these, they may not be binary-compatible with System V terminfo
+#%The XSI Curses standard added these hardcopy capabilities.
+#%They were used in some post-4.1 versions of System V curses,
+#%e.g., Solaris 2.5 and IRIX 6.x.
+#%Except for \fBYI\fP, the \fBncurses\fR termcap names for them are invented.
+#%According to the XSI Curses standard, they have no termcap names.
+#%If your compiled terminfo entries use these,
+#%they may not be binary-compatible with System V terminfo
 #%entries after SVr4.1; beware!
 #%
 #%.na
 #%entries after SVr4.1; beware!
 #%
 #%.na
@@ -760,7 +762,7 @@ enter_right_hl_mode         erhlm   str     Xr      -               -       -----   Enter right highlight mode
 enter_top_hl_mode              ethlm   str     Xt      -               -       -----   Enter top highlight mode
 enter_vertical_hl_mode         evhlm   str     Xv      -               -       -----   Enter vertical highlight mode
 set_a_attributes               sgr1    str     sA      -               -       -----   Define second set of video attributes #1-#6
 enter_top_hl_mode              ethlm   str     Xt      -               -       -----   Enter top highlight mode
 enter_vertical_hl_mode         evhlm   str     Xv      -               -       -----   Enter vertical highlight mode
 set_a_attributes               sgr1    str     sA      -               -       -----   Define second set of video attributes #1-#6
-set_pglen_inch                 slength str     sL      -               -       -----   YI Set page length to #1 hundredth of an inch
+set_pglen_inch                 slength str     YI      -               -       -----   Set page length to #1 hundredth of an inch (some implementations use sL for termcap).
 #%.TE
 #%.ad
 #
 #%.TE
 #%.ad
 #
index 5864d7b7afe6238d68b9cab82df539cf5510ed86..faa9822e59b2e251288fc6c0cc556cf2fee10763 100644 (file)
@@ -1,5 +1,5 @@
 ##############################################################################
 ##############################################################################
-# Copyright (c) 2001-2006,2010 Free Software Foundation, Inc.                #
+# Copyright (c) 2001-2010,2011 Free Software Foundation, Inc.                #
 #                                                                            #
 # Permission is hereby granted, free of charge, to any person obtaining a    #
 # copy of this software and associated documentation files (the "Software"), #
 #                                                                            #
 # Permission is hereby granted, free of charge, to any person obtaining a    #
 # copy of this software and associated documentation files (the "Software"), #
@@ -28,7 +28,7 @@
 #
 # Author: Thomas Dickey
 #
 #
 # Author: Thomas Dickey
 #
-# $Id: Caps.aix4,v 1.8 2010/12/04 18:47:13 tom Exp $
+# $Id: Caps.aix4,v 1.9 2011/10/15 23:19:16 tom Exp $
 #
 # This is an adaptation of ncurses' termcap/terminfo capability table, which
 # is designed to align with AIX 4.x's terminfo.
 #
 # This is an adaptation of ncurses' termcap/terminfo capability table, which
 # is designed to align with AIX 4.x's terminfo.
@@ -840,11 +840,13 @@ alt_scancode_esc          scesa   str     S8      -               -       -----   Alternate escape for scancode emulatio
 #%.ad
 #%
 #%.in .8i
 #%.ad
 #%
 #%.in .8i
-#%The XSI Curses standard added these.  They are some post-4.1 
-#%versions of System V curses, e.g., Solaris 2.5 and IRIX 6.x.
-#%The \fBncurses\fR termcap names for them are invented; according to the
-#%XSI Curses standard, they have no termcap names.  If your compiled terminfo
-#%entries use these, they may not be binary-compatible with System V terminfo
+#%The XSI Curses standard added these hardcopy capabilities.
+#%They were used in some post-4.1 versions of System V curses,
+#%e.g., Solaris 2.5 and IRIX 6.x.
+#%Except for \fBYI\fP, the \fBncurses\fR termcap names for them are invented.
+#%According to the XSI Curses standard, they have no termcap names.
+#%If your compiled terminfo entries use these,
+#%they may not be binary-compatible with System V terminfo
 #%entries after SVr4.1; beware!
 #%
 #%.na
 #%entries after SVr4.1; beware!
 #%
 #%.na
@@ -862,7 +864,7 @@ enter_right_hl_mode         erhlm   str     Xr      -               -       -----   Enter right highlight mode
 enter_top_hl_mode              ethlm   str     Xt      -               -       -----   Enter top highlight mode
 enter_vertical_hl_mode         evhlm   str     Xv      -               -       -----   Enter vertical highlight mode
 set_a_attributes               sgr1    str     sA      -               -       -----   Define second set of video attributes #1-#6
 enter_top_hl_mode              ethlm   str     Xt      -               -       -----   Enter top highlight mode
 enter_vertical_hl_mode         evhlm   str     Xv      -               -       -----   Enter vertical highlight mode
 set_a_attributes               sgr1    str     sA      -               -       -----   Define second set of video attributes #1-#6
-set_pglen_inch                 slength str     sL      -               -       -----   YI Set page length to #1 hundredth of an inch
+set_pglen_inch                 slength str     YI      -               -       -----   Set page length to #1 hundredth of an inch (some implementations use sL for termcap).
 #%.TE
 #%.ad
 #
 #%.TE
 #%.ad
 #
index 8dbe656cd617163c14210d48f93d45b1a37bf872..b7bb99872774996861e3316882297eb02fbb7072 100644 (file)
@@ -1,5 +1,5 @@
 ##############################################################################
 ##############################################################################
-# Copyright (c) 2002-2006,2010 Free Software Foundation, Inc.                #
+# Copyright (c) 2002-2010,2011 Free Software Foundation, Inc.                #
 #                                                                            #
 # Permission is hereby granted, free of charge, to any person obtaining a    #
 # copy of this software and associated documentation files (the "Software"), #
 #                                                                            #
 # Permission is hereby granted, free of charge, to any person obtaining a    #
 # copy of this software and associated documentation files (the "Software"), #
@@ -28,7 +28,7 @@
 #
 # Author: Thomas Dickey
 #
 #
 # Author: Thomas Dickey
 #
-# $Id: Caps.hpux11,v 1.5 2010/12/04 18:47:13 tom Exp $
+# $Id: Caps.hpux11,v 1.6 2011/10/15 23:20:04 tom Exp $
 #
 # This is an adaptation of ncurses' termcap/terminfo capability table, which
 # is designed to align with HPUX 11.x's terminfo.
 #
 # This is an adaptation of ncurses' termcap/terminfo capability table, which
 # is designed to align with HPUX 11.x's terminfo.
@@ -746,11 +746,13 @@ alt_scancode_esc          scesa   str     S8      -               -       -----   Alternate escape for scancode emulatio
 #%.ad
 #%
 #%.in .8i
 #%.ad
 #%
 #%.in .8i
-#%The XSI Curses standard added these.  They are some post-4.1 
-#%versions of System V curses, e.g., Solaris 2.5 and IRIX 6.x.
-#%The \fBncurses\fR termcap names for them are invented; according to the
-#%XSI Curses standard, they have no termcap names.  If your compiled terminfo
-#%entries use these, they may not be binary-compatible with System V terminfo
+#%The XSI Curses standard added these hardcopy capabilities.
+#%They were used in some post-4.1 versions of System V curses,
+#%e.g., Solaris 2.5 and IRIX 6.x.
+#%Except for \fBYI\fP, the \fBncurses\fR termcap names for them are invented.
+#%According to the XSI Curses standard, they have no termcap names.
+#%If your compiled terminfo entries use these,
+#%they may not be binary-compatible with System V terminfo
 #%entries after SVr4.1; beware!
 #%
 #%.na
 #%entries after SVr4.1; beware!
 #%
 #%.na
@@ -761,7 +763,7 @@ alt_scancode_esc            scesa   str     S8      -               -       -----   Alternate escape for scancode emulatio
 #%lw25 lw6 lw2 lw20.
 #%\fBVariable  Cap-    TCap    Description\fR
 #%\fBString    name    Code\fR
 #%lw25 lw6 lw2 lw20.
 #%\fBVariable  Cap-    TCap    Description\fR
 #%\fBString    name    Code\fR
-set_pglen_inch                 slength str     sL      -               -       -----   YI Set page length to #1 hundredth of an inch
+set_pglen_inch                 slength str     YI      -               -       -----   Set page length to #1 hundredth of an inch (some implementations use sL for termcap).
 enter_horizontal_hl_mode       ehhlm   str     Xh      -               -       -----   Enter horizontal highlight mode
 enter_left_hl_mode             elhlm   str     Xl      -               -       -----   Enter left highlight mode
 enter_low_hl_mode              elohlm  str     Xo      -               -       -----   Enter low highlight mode
 enter_horizontal_hl_mode       ehhlm   str     Xh      -               -       -----   Enter horizontal highlight mode
 enter_left_hl_mode             elhlm   str     Xl      -               -       -----   Enter left highlight mode
 enter_low_hl_mode              elohlm  str     Xo      -               -       -----   Enter low highlight mode
index 4d4fe30b8130def142204f5180aa53a8c431f17d..7f33d34d68e7b0e5a888b8919f700b9998b9b2a3 100644 (file)
@@ -1,5 +1,5 @@
 ##############################################################################
 ##############################################################################
-# Copyright (c) 2001-2006,2010 Free Software Foundation, Inc.                #
+# Copyright (c) 2001-2010,2011 Free Software Foundation, Inc.                #
 #                                                                            #
 # Permission is hereby granted, free of charge, to any person obtaining a    #
 # copy of this software and associated documentation files (the "Software"), #
 #                                                                            #
 # Permission is hereby granted, free of charge, to any person obtaining a    #
 # copy of this software and associated documentation files (the "Software"), #
@@ -29,7 +29,7 @@
 # Author: Thomas Dickey
 #    and: Ilya Zakharevich
 #
 # Author: Thomas Dickey
 #    and: Ilya Zakharevich
 #
-# $Id: Caps.keys,v 1.4 2010/12/04 18:47:13 tom Exp $
+# $Id: Caps.keys,v 1.5 2011/10/15 23:19:52 tom Exp $
 #
 # This is an adaptation of ncurses' termcap/terminfo capability table, which
 # is illustrates an experimental extension to describe alt-, shift- and
 #
 # This is an adaptation of ncurses' termcap/terminfo capability table, which
 # is illustrates an experimental extension to describe alt-, shift- and
@@ -828,11 +828,13 @@ alt_scancode_esc          scesa   str     S8      -               -       -----   Alternate escape for scancode emulatio
 #%.ad
 #%
 #%.in .8i
 #%.ad
 #%
 #%.in .8i
-#%The XSI Curses standard added these.  They are some post-4.1 
-#%versions of System V curses, e.g., Solaris 2.5 and IRIX 6.x.
-#%The \fBncurses\fR termcap names for them are invented; according to the
-#%XSI Curses standard, they have no termcap names.  If your compiled terminfo
-#%entries use these, they may not be binary-compatible with System V terminfo
+#%The XSI Curses standard added these hardcopy capabilities.
+#%They were used in some post-4.1 versions of System V curses,
+#%e.g., Solaris 2.5 and IRIX 6.x.
+#%Except for \fBYI\fP, the \fBncurses\fR termcap names for them are invented.
+#%According to the XSI Curses standard, they have no termcap names.
+#%If your compiled terminfo entries use these,
+#%they may not be binary-compatible with System V terminfo
 #%entries after SVr4.1; beware!
 #%
 #%.na
 #%entries after SVr4.1; beware!
 #%
 #%.na
@@ -850,7 +852,7 @@ enter_right_hl_mode         erhlm   str     Xr      -               -       -----   Enter right highlight mode
 enter_top_hl_mode              ethlm   str     Xt      -               -       -----   Enter top highlight mode
 enter_vertical_hl_mode         evhlm   str     Xv      -               -       -----   Enter vertical highlight mode
 set_a_attributes               sgr1    str     sA      -               -       -----   Define second set of video attributes #1-#6
 enter_top_hl_mode              ethlm   str     Xt      -               -       -----   Enter top highlight mode
 enter_vertical_hl_mode         evhlm   str     Xv      -               -       -----   Enter vertical highlight mode
 set_a_attributes               sgr1    str     sA      -               -       -----   Define second set of video attributes #1-#6
-set_pglen_inch                 slength str     sL      -               -       -----   YI Set page length to #1 hundredth of an inch
+set_pglen_inch                 slength str     YI      -               -       -----   Set page length to #1 hundredth of an inch (some implementations use sL for termcap).
 #%.TE
 #%.ad
 #
 #%.TE
 #%.ad
 #
index 79dbf50fd3db562a1a089a6cdd9314859948b509..b9400b97ea1a6631fb525ce27520795782397d1d 100644 (file)
@@ -1,5 +1,5 @@
 ##############################################################################
 ##############################################################################
-# Copyright (c) 2002-2006,2010 Free Software Foundation, Inc.                #
+# Copyright (c) 2002-2010,2011 Free Software Foundation, Inc.                #
 #                                                                            #
 # Permission is hereby granted, free of charge, to any person obtaining a    #
 # copy of this software and associated documentation files (the "Software"), #
 #                                                                            #
 # Permission is hereby granted, free of charge, to any person obtaining a    #
 # copy of this software and associated documentation files (the "Software"), #
@@ -28,7 +28,7 @@
 #
 # Author: Thomas Dickey
 #
 #
 # Author: Thomas Dickey
 #
-# $Id: Caps.osf1r5,v 1.5 2010/12/04 18:47:13 tom Exp $
+# $Id: Caps.osf1r5,v 1.6 2011/10/15 22:52:09 tom Exp $
 #
 # This is an adaptation of ncurses' termcap/terminfo capability table, which
 # is designed to align with OSF/1 version 5 (Tru64) terminfo.
 #
 # This is an adaptation of ncurses' termcap/terminfo capability table, which
 # is designed to align with OSF/1 version 5 (Tru64) terminfo.
@@ -769,7 +769,7 @@ wait_tone                   wait    str     WA      -               -       -----   wait for dial-tone
 xoff_character                 xoffc   str     XF      -               -       -----   XOFF character
 xon_character                  xonc    str     XN      -               -       -----   XON character
 zero_motion                    zerom   str     Zx      -               -       -----   No motion for subsequent character
 xoff_character                 xoffc   str     XF      -               -       -----   XOFF character
 xon_character                  xonc    str     XN      -               -       -----   XON character
 zero_motion                    zerom   str     Zx      -               -       -----   No motion for subsequent character
-set_pglen_inch                 slength str     sL      -               -       -----   YI Set page length to #1 hundredth of an inch
+set_pglen_inch                 slength str     YI      -               -       -----   Set page length to #1 hundredth of an inch (some implementations use sL for termcap).
 enter_horizontal_hl_mode       ehhlm   str     Xh      -               -       -----   Enter horizontal highlight mode
 enter_left_hl_mode             elhlm   str     Xl      -               -       -----   Enter left highlight mode
 enter_low_hl_mode              elohlm  str     Xo      -               -       -----   Enter low highlight mode
 enter_horizontal_hl_mode       ehhlm   str     Xh      -               -       -----   Enter horizontal highlight mode
 enter_left_hl_mode             elhlm   str     Xl      -               -       -----   Enter left highlight mode
 enter_low_hl_mode              elohlm  str     Xo      -               -       -----   Enter low highlight mode
index 70a6710ad6482ee80d7c37b0958a57bebbfa5ad1..4d8a62cd6c5c750ea1e862fdaec897336aef611c 100644 (file)
@@ -1,5 +1,5 @@
 .\"***************************************************************************
 .\"***************************************************************************
-.\" Copyright (c) 1998-2007,2010 Free Software Foundation, Inc.              *
+.\" Copyright (c) 1998-2010,2011 Free Software Foundation, Inc.              *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" copy of this software and associated documentation files (the            *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" copy of this software and associated documentation files (the            *
@@ -26,7 +26,7 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
-.\" $Id: curs_termcap.3x,v 1.26 2010/12/04 18:38:55 tom Exp $
+.\" $Id: curs_termcap.3x,v 1.27 2011/10/15 21:11:24 tom Exp $
 .TH curs_termcap 3X ""
 .na
 .hy 0
 .TH curs_termcap 3X ""
 .na
 .hy 0
@@ -77,9 +77,37 @@ can only be used to query the capabilities of entries for which a
 terminfo entry has been compiled.
 .PP
 The \fBtgetent\fR routine loads the entry for \fIname\fR.
 terminfo entry has been compiled.
 .PP
 The \fBtgetent\fR routine loads the entry for \fIname\fR.
-It returns 1 on success, 0 if there is no such entry, and \-1 if the
-terminfo database could not be found.
+It returns:
+.RS 3
+.TP 3
+1
+on success,
+.TP 3
+0
+if there is no such entry
+(or that it is a generic type, having too little information for curses
+applications to run), and
+.TP 3
+\-1
+if the terminfo database could not be found.
+.RE
+.PP
+This differs from the \fItermcap\fP library in two ways:
+.RS 3
+.TP 3
+-
 The emulation ignores the buffer pointer \fIbp\fR.
 The emulation ignores the buffer pointer \fIbp\fR.
+The \fItermcap\fP library would store a copy of the terminal
+description in the area referenced by this pointer.
+However, ncurses stores its terminal descriptions in compiled
+binary form, which is not the same thing.
+.TP 3
+-
+There is a difference in return codes.
+The \fItermcap\fP library does not check if the terminal
+description is marked with the \fIgeneric\fP capability,
+or if the terminal description has cursor-addressing.
+.RE
 .PP
 The \fBtgetflag\fR routine gets the boolean entry for \fIid\fR,
 or zero if it is not available.
 .PP
 The \fBtgetflag\fR routine gets the boolean entry for \fIid\fR,
 or zero if it is not available.