← Back to branch summary

~ubuntu-branches/ubuntu/natty/ncurses/natty

« back to all changes in this revision

Viewing changes to man/curs_terminfo.3x

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2007-05-17 09:00:42 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20070517090042-86fgxrr6j5jzagot
Tags: 5.6-0ubuntu1
* New upstream version.
  - Remove patches applied upstream: ncurses.upstream, signed-chars.
  - Update patches: debian-backspace.
* Build-depend on g++-multilib instead of lib{32,64}c*-dev-*.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/curs_terminfo.3x
1
1
.\"***************************************************************************
2
 
.\" Copyright (c) 1999-2003,2005 Free Software Foundation, Inc.              *
 
2
.\" Copyright (c) 1999-2005,2006 Free Software Foundation, Inc.              *
3
3
.\"                                                                          *
4
4
.\" Permission is hereby granted, free of charge, to any person obtaining a  *
5
5
.\" copy of this software and associated documentation files (the            *
26
26
.\" authorization.                                                           *
27
27
.\"***************************************************************************
28
28
.\"
29
 
.\" $Id: curs_terminfo.3x,v 1.20 2005/05/15 16:19:13 tom Exp $
 
29
.\" $Id: curs_terminfo.3x,v 1.24 2006/11/04 21:50:03 tom Exp $
30
30
.TH curs_terminfo 3X ""
31
31
.ds n 5
32
32
.na
154
154
If \fIerrret\fR is
155
155
null, \fBsetupterm\fR prints an error message upon finding an error
156
156
and exits.  Thus, the simplest call is:
157
 
 
 
157
.sp
158
158
      \fBsetupterm((char *)0, 1, (int *)0);\fR,
159
 
 
 
159
.sp
160
160
which uses all the defaults and sends the output to \fBstdout\fR.
161
161
.PP
162
162
The \fBsetterm\fR routine is being replaced by \fBsetupterm\fR.  The call:
163
 
 
 
163
.sp
164
164
      \fBsetupterm(\fR\fIterm\fR\fB, 1, (int *)0)\fR
165
 
 
 
165
.sp
166
166
provides the same functionality as \fBsetterm(\fR\fIterm\fR\fB)\fR.
167
167
The \fBsetterm\fR routine is included here for BSD compatibility, and
168
168
is not recommended for new programs.
240
240
.PP
241
241
The \fIcapname\fR for each capability is given in the table column entitled
242
242
\fIcapname\fR code in the capabilities section of \fBterminfo\fR(\*n).
243
 
 
244
 
\fBchar *boolnames\fR, \fB*boolcodes\fR, \fB*boolfnames\fR
245
 
 
246
 
\fBchar *numnames\fR, \fB*numcodes\fR, \fB*numfnames\fR
247
 
 
248
 
\fBchar *strnames\fR, \fB*strcodes\fR, \fB*strfnames\fR
249
 
 
 
243
.sp
 
244
.RS
 
245
\fBchar *boolnames[]\fR, \fB*boolcodes[]\fR, \fB*boolfnames[]\fR
 
246
.sp
 
247
\fBchar *numnames[]\fR, \fB*numcodes[]\fR, \fB*numfnames[]\fR
 
248
.sp
 
249
\fBchar *strnames[]\fR, \fB*strcodes[]\fR, \fB*strfnames[]\fR
 
250
.RE
 
251
.PP
250
252
These null-terminated arrays contain the \fIcapnames\fR, the
251
253
\fBtermcap\fR codes, and the full C names, for each of the
252
254
\fBterminfo\fR variables.
306
308
the SCREEN data allocated in either \fBinitscr\fR or \fBnewterm\fR.
307
309
So though it is documented as a terminfo function,
308
310
\fBmvcur\fR is really a curses function which is not well specified.
 
311
.PP
 
312
XSI states that the old location must be given.
 
313
This implementation allows the caller to use -1's for the old ordinates.
 
314
In that case, the old location is unknown.
 
315
.PP
 
316
Extended terminal capability names, e.g., as defined by \fBtic\ -x\fP,
 
317
are not stored in the arrays described in this section.
309
318
.SH SEE ALSO
310
319
\fBcurses\fR(3X), \fBcurs_initscr\fR(3X), \fBcurs_kernel\fR(3X), \fBcurs_termcap\fR(3X),
311
320
\fBputc\fR(3S), \fBterminfo\fR(\*n)