X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_extend.3x;h=52ba27d07fb3c928f1eeb6e090da6ba788523314;hp=9a52f93080f41ce8482abf7dbe1c007c6600fb85;hb=42259b594b5dabd37fe2bc294051d2db82e873a2;hpb=96d6b16de0d487e5d3aed0302a179dbce11b5d96 diff --git a/man/curs_extend.3x b/man/curs_extend.3x index 9a52f930..52ba27d0 100644 --- a/man/curs_extend.3x +++ b/man/curs_extend.3x @@ -1,5 +1,6 @@ .\"*************************************************************************** -.\" Copyright (c) 1999-2006,2010 Free Software Foundation, Inc. * +.\" Copyright 2018,2020 Thomas E. Dickey * +.\" Copyright 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 * @@ -28,7 +29,7 @@ .\" .\" Author: Thomas E. Dickey 1999-on .\" -.\" $Id: curs_extend.3x,v 1.19 2010/12/04 18:36:44 tom Exp $ +.\" $Id: curs_extend.3x,v 1.24 2020/10/24 09:37:07 tom Exp $ .TH curs_extend 3X "" .SH NAME \fBcurses_version\fP, @@ -39,18 +40,18 @@ .sp \fBconst char * curses_version(void);\fP .br -\fBint use_extended_names(bool enable);\fP +\fBint use_extended_names(bool \fP\fIenable\fP\fB);\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() +Use \fBcurses_version\fP 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() +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 @@ -60,9 +61,18 @@ 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 +These routines are specific to ncurses. +They were not supported on +Version 7, BSD or System V implementations. +It is recommended that any code depending on them be conditioned using NCURSES_VERSION. .SH SEE ALSO \fBcurs_getch\fR(3X),