X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_extend.3x;h=6c5309ebc2d2a5ff1beeca0ee0b08210b80da526;hp=a5f187f0221748043e367a8408905740bac196bf;hb=3353ecc7ed0f1d3b4e6c7e8e98d92f469d593e35;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8 diff --git a/man/curs_extend.3x b/man/curs_extend.3x index a5f187f0..6c5309eb 100644 --- a/man/curs_extend.3x +++ b/man/curs_extend.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1999-2003,2004 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 * @@ -26,28 +26,30 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" Author: Thomas E. Dickey 1999 +.\" Author: Thomas E. Dickey 1999-on .\" -.\" $Id: curs_extend.3x,v 1.13 2004/07/05 13:16:08 tom Exp $ +.\" $Id: curs_extend.3x,v 1.20 2016/05/14 23:10:54 tom Exp $ .TH curs_extend 3X "" .SH NAME \fBcurses_version\fP, \fBuse_extended_names\fP \- miscellaneous curses extensions - +. .SH SYNOPSIS \fB#include \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. +.SS curses_version .PP Use .I curses_version() to get the version number, including patch level of the library, e.g., .B 5.0.19991023 +.SS use_extended_names .PP The .I use_extended_names() @@ -56,10 +58,17 @@ 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. +.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 @@ -68,6 +77,7 @@ any code depending on them be conditioned using NCURSES_VERSION. \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), @@ -76,9 +86,3 @@ any code depending on them be conditioned using NCURSES_VERSION. \fBwresize\fR(3X). .SH AUTHOR Thomas Dickey. -.\"# -.\"# The following sets edit modes for GNU EMACS -.\"# Local Variables: -.\"# mode:nroff -.\"# fill-column:79 -.\"# End: