ncurses 6.0 - patch 20161112

[ncurses.git] / man / curs_extend.3x

diff --git a/man/curs_extend.3x b/man/curs_extend.3x
index 8e992e749d89964347f9464fec4e80e6e9be55dc..cfb64ed34770ee0cba05376892a2c7ca33382313 100644 (file)
--- a/man/curs_extend.3x
+++ b/man/curs_extend.3x
@@ -1,5 +1,5 @@
 .\"***************************************************************************
 .\"***************************************************************************

-.\" Copyright (c) 1999-2002,2003 Free Software Foundation, Inc.              *
+.\" Copyright (c) 1999-2010,2016 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,40 +26,47 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"

-.\" Author: Thomas E. Dickey 1999
+.\" Author: Thomas E. Dickey 1999-on

 .\"
 .\"

-.\" $Id: curs_extend.3x,v 1.12 2003/10/25 20:33:16 tom Exp $
+.\" $Id: curs_extend.3x,v 1.21 2016/10/15 16:52:48 tom Exp $

 .TH curs_extend 3X ""
 .SH NAME
 \fBcurses_version\fP,
 \fBuse_extended_names\fP \- miscellaneous curses extensions
 .TH curs_extend 3X ""
 .SH NAME
 \fBcurses_version\fP,
 \fBuse_extended_names\fP \- miscellaneous curses extensions

-
+.

 .SH SYNOPSIS
 \fB#include <curses.h>\fP
 .SH SYNOPSIS
 \fB#include <curses.h>\fP

-
+.sp

 \fBconst char * curses_version(void);\fP
 .br
 \fBint use_extended_names(bool enable);\fP
 .SH DESCRIPTION
 These functions are extensions to the curses library
 which do not fit easily into other categories.
 \fBconst char * curses_version(void);\fP
 .br
 \fBint use_extended_names(bool enable);\fP
 .SH DESCRIPTION
 These functions are extensions to the curses library
 which do not fit easily into other categories.

+.SS curses_version

 .PP
 .PP

-Use
-.I curses_version()
+Use \fBcurses_version\fP

 to get the version number, including patch level of the library, e.g.,
 .B 5.0.19991023
 to get the version number, including patch level of the library, e.g.,
 .B 5.0.19991023

+.SS use_extended_names

 .PP
 .PP

-The
-.I use_extended_names()
+The \fBuse_extended_names\fP

 function controls whether the calling application
 is able to use user-defined or nonstandard names
 which may be compiled into the terminfo
 description, i.e., via the terminfo or termcap interfaces.
 Normally these names are available for use, since the essential decision
 function controls whether the calling application
 is able to use user-defined or nonstandard names
 which may be compiled into the terminfo
 description, i.e., via the terminfo or termcap interfaces.
 Normally these names are available for use, since the essential decision

-is made by using the \fB\-x\fP option of \fItic\fP to compile
+is made by using the \fB\-x\fP option of \fB@TIC@\fP to compile

 extended terminal definitions.
 However you can disable this feature
 to ensure compatibility with other implementations of curses.
 extended terminal definitions.
 However you can disable this feature
 to ensure compatibility with other implementations of curses.

+.SH RETURN VALUE
+.PP
+\fBcurses_version\fP returns a pointer to static memory; you should not free
+this in your application.
+.PP
+\fBuse_extended_names\fP returns the previous state, allowing you to
+save this and restore it.

 .SH PORTABILITY
 These routines are specific to ncurses.  They were not supported on
 Version 7, BSD or System V implementations.  It is recommended that
 .SH PORTABILITY
 These routines are specific to ncurses.  They were not supported on
 Version 7, BSD or System V implementations.  It is recommended that


@@ -68,6 +75,7 @@ any code depending on them be conditioned using NCURSES_VERSION.
 \fBcurs_getch\fR(3X),
 \fBcurs_mouse\fR(3X),
 \fBcurs_print\fR(3X),
 \fBcurs_getch\fR(3X),
 \fBcurs_mouse\fR(3X),
 \fBcurs_print\fR(3X),

+\fBcurs_util\fR(3X),

 \fBdefault_colors\fR(3X),
 \fBdefine_key\fR(3X),
 \fBkeybound\fR(3X),
 \fBdefault_colors\fR(3X),
 \fBdefine_key\fR(3X),
 \fBkeybound\fR(3X),


@@ -76,9 +84,3 @@ any code depending on them be conditioned using NCURSES_VERSION.
 \fBwresize\fR(3X).
 .SH AUTHOR
 Thomas Dickey.
 \fBwresize\fR(3X).
 .SH AUTHOR
 Thomas Dickey.

-.\"#
-.\"# The following sets edit modes for GNU EMACS
-.\"# Local Variables:
-.\"# mode:nroff
-.\"# fill-column:79
-.\"# End: