sergiotarxz/nuttx-apps
sergiotarxz/nuttx-apps
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Remove some dangling whitespace at the end of lines.

Browse Source
This commit is contained in:
Gregory Nutt 2017-11-17 13:23:02 -06:00
parent 7ba2110c83
commit 69bea27b20
43 changed files with 928 additions and 928 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

848
graphics/pdcurs34/HISTORY
View File

File diff suppressed because it is too large Load Diff

224
graphics/pdcurs34/IMPLEMNT
View File

@ -2,71 +2,71 @@ PDCurses Implementor's Guide
============================
Version 1.3 - 200?/??/?? - notes about official ports
Version 1.2 - 2007/07/11 - added PDC_init_pair(), PDC_pair_content(),
Version 1.2 - 2007/07/11 - added PDC_init_pair(), PDC_pair_content(),
version history; removed pdc_atrtab
Version 1.1 - 2007/06/06 - minor cosmetic change
Version 1.0 - 2007/04/01 - initial revision
This document is for those wishing to port PDCurses to a new platform,
or just wanting to better understand how it works. Nothing here should
be needed for application programming; for that, refer to PDCurses.txt,
as built in doc/, or distributed as a file separate from this source
package. This document assumes that you've read the user-level
documentation and are very familiar with application-level curses
This document is for those wishing to port PDCurses to a new platform,
or just wanting to better understand how it works. Nothing here should
be needed for application programming; for that, refer to PDCurses.txt,
as built in doc/, or distributed as a file separate from this source
package. This document assumes that you've read the user-level
documentation and are very familiar with application-level curses
programming.
If you want to submit your port for possible inclusion into the main
If you want to submit your port for possible inclusion into the main
PDCurses distribution, please follow these guidelines:
- Don't modify anything in the pdcurses directory or in other port
directories. Don't modify curses.h or curspriv.h unless absolutely
- Don't modify anything in the pdcurses directory or in other port
directories. Don't modify curses.h or curspriv.h unless absolutely
necessary. (And prefer modifying curspriv.h over curses.h.)
- Use the same indentation style, naming and scope conventions as the
- Use the same indentation style, naming and scope conventions as the
existing code.
- Release all your code to the public domain -- no copyright. Code
- Release all your code to the public domain -- no copyright. Code
under GPL, BSD, etc. will not be accepted.
DATA STRUCTURES
---------------
A port of PDCurses must provide acs_map[], a 128-element array of
chtypes, with values laid out based on the Alternate Character Set of
the VT100 (see curses.h). PDC_transform_line() must use this table; when
it encounters a chtype with the A_ALTCHARSET flag set, and an A_CHARTEXT
value in the range 0-127, it must render it using the A_CHARTEXT portion
of the corresponding value from this table, instead of the original
value. Also, values may be read from this table by apps, and passed
through functions such as waddch(), which does no special processing on
control characters (0-31 and 127) when the A_ALTCHARSET flag is set.
Thus, any control characters used in acs_map[] should also have the
A_ALTCHARSET flag set. Implementations should provide suitable values
for all the ACS_ macros defined in curses.h; other values in the table
should be filled with their own indices (e.g., acs_map['E'] == 'E'). The
table can be either hardwired, or filled by PDC_scr_open(). Existing
A port of PDCurses must provide acs_map[], a 128-element array of
chtypes, with values laid out based on the Alternate Character Set of
the VT100 (see curses.h). PDC_transform_line() must use this table; when
it encounters a chtype with the A_ALTCHARSET flag set, and an A_CHARTEXT
value in the range 0-127, it must render it using the A_CHARTEXT portion
of the corresponding value from this table, instead of the original
value. Also, values may be read from this table by apps, and passed
through functions such as waddch(), which does no special processing on
control characters (0-31 and 127) when the A_ALTCHARSET flag is set.
Thus, any control characters used in acs_map[] should also have the
A_ALTCHARSET flag set. Implementations should provide suitable values
for all the ACS_ macros defined in curses.h; other values in the table
should be filled with their own indices (e.g., acs_map['E'] == 'E'). The
table can be either hardwired, or filled by PDC_scr_open(). Existing
ports define it in pdcdisp.c, but this is not required.
FUNCTIONS
---------
A port of PDCurses must implement the following functions, with extern
scope. These functions are traditionally divided into several modules,
as indicated below; this division is not required (only the functions
are), but may make it easier to follow for someone familiar with the
A port of PDCurses must implement the following functions, with extern
scope. These functions are traditionally divided into several modules,
as indicated below; this division is not required (only the functions
are), but may make it easier to follow for someone familiar with the
existing ports.
Any other functions you create as part of your implementation should
have static scope, if possible. If they can't be static, they should be
named with the "PDC_" prefix. This minimizes the risk of collision with
Any other functions you create as part of your implementation should
have static scope, if possible. If they can't be static, they should be
named with the "PDC_" prefix. This minimizes the risk of collision with
an application's choices.
Current PDCurses style also uses a single leading underscore with the
name of any static function; and modified BSD/Allman-style indentation,
approximately equivalent to "indent -kr -i8 -bl -bli0", with adjustments
to keep every line under 80 columns. This isn't essential, but a
Current PDCurses style also uses a single leading underscore with the
name of any static function; and modified BSD/Allman-style indentation,
approximately equivalent to "indent -kr -i8 -bl -bli0", with adjustments
to keep every line under 80 columns. This isn't essential, but a
consistent style helps readability.
@ -75,17 +75,17 @@ pdcdisp.c:
void PDC_gotoyx(int y, int x);
Move the physical cursor (as opposed to the logical cursor affected by
wmove()) to the given location. This is called mainly from doupdate().
In general, this function need not compare the old location with the new
Move the physical cursor (as opposed to the logical cursor affected by
wmove()) to the given location. This is called mainly from doupdate().
In general, this function need not compare the old location with the new
one, and should just move the cursor unconditionally.
void PDC_transform_line(int lineno, int x, int len, const chtype *srcp);
The core output routine. It takes len chtype entities from srcp (a
pointer into curscr) and renders them to the physical screen at line
lineno, column x. It must also translate characters 0-127 via acs_map[],
if they're flagged with A_ALTCHARSET in the attribute portion of the
The core output routine. It takes len chtype entities from srcp (a
pointer into curscr) and renders them to the physical screen at line
lineno, column x. It must also translate characters 0-127 via acs_map[],
if they're flagged with A_ALTCHARSET in the attribute portion of the
chtype.
@ -94,22 +94,22 @@ pdcgetsc.c:
int PDC_get_columns(void);
Returns the size of the screen in columns. It's used in resize_term() to
set the new value of COLS. (Some existing implementations also call it
Returns the size of the screen in columns. It's used in resize_term() to
set the new value of COLS. (Some existing implementations also call it
internally from PDC_scr_open(), but this is not required.)
int PDC_get_cursor_mode(void);
Returns the size/shape of the cursor. The format of the result is
unspecified, except that it must be returned as an int. This function is
called from initscr(), and the result is stored in SP->orig_cursor,
which is used by PDC_curs_set() to determine the size/shape of the
Returns the size/shape of the cursor. The format of the result is
unspecified, except that it must be returned as an int. This function is
called from initscr(), and the result is stored in SP->orig_cursor,
which is used by PDC_curs_set() to determine the size/shape of the
cursor in normal visibility mode (curs_set(1)).
int PDC_get_rows(void);
Returns the size of the screen in rows. It's used in resize_term() to
set the new value of LINES. (Some existing implementations also call it
Returns the size of the screen in rows. It's used in resize_term() to
set the new value of LINES. (Some existing implementations also call it
internally from PDC_scr_open(), but this is not required.)
@ -148,23 +148,23 @@ true).
int PDC_modifiers_set(void);
Called from PDC_return_key_modifiers(). If your platform needs to do
anything in response to a change in SP->return_key_modifiers, do it
Called from PDC_return_key_modifiers(). If your platform needs to do
anything in response to a change in SP->return_key_modifiers, do it
here. Returns OK or ERR, which is passed on by the caller.
int PDC_mouse_set(void);
Called by mouse_set(), mouse_on(), and mouse_off() -- all the functions
that modify SP->_trap_mbe. If your platform needs to do anything in
response to a change in SP->_trap_mbe (for example, turning the mouse
cursor on or off), do it here. Returns OK or ERR, which is passed on by
Called by mouse_set(), mouse_on(), and mouse_off() -- all the functions
that modify SP->_trap_mbe. If your platform needs to do anything in
response to a change in SP->_trap_mbe (for example, turning the mouse
cursor on or off), do it here. Returns OK or ERR, which is passed on by
the caller.
void PDC_set_keyboard_binary(bool on);
Set keyboard input to "binary" mode. If you need to do something to keep
the OS from processing ^C, etc. on your platform, do it here. true turns
the mode on; false reverts it. This function is called from raw() and
Set keyboard input to "binary" mode. If you need to do something to keep
the OS from processing ^C, etc. on your platform, do it here. true turns
the mode on; false reverts it. This function is called from raw() and
noraw().
@ -173,90 +173,90 @@ pdcscrn.c:
bool PDC_can_change_color(void);
Returns true if init_color() and color_content() give meaningful
Returns true if init_color() and color_content() give meaningful
results, false otherwise. Called from can_change_color().
int PDC_color_content(short color, short *red, short *green, short *blue);
The core of color_content(). This does all the work of that function,
The core of color_content(). This does all the work of that function,
except checking for values out of range and null pointers.
int PDC_init_color(short color, short red, short green, short blue);
The core of init_color(). This does all the work of that function,
The core of init_color(). This does all the work of that function,
except checking for values out of range.
void PDC_init_pair(short pair, short fg, short bg);
The core of init_pair(). This does all the work of that function, except
checking for values out of range. The values passed to this function
should be returned by a call to PDC_pair_content() with the same pair
number. PDC_transform_line() should use the specified colors when
The core of init_pair(). This does all the work of that function, except
checking for values out of range. The values passed to this function
should be returned by a call to PDC_pair_content() with the same pair
number. PDC_transform_line() should use the specified colors when
rendering a chtype with the given pair number.
int PDC_pair_content(short pair, short *fg, short *bg);
The core of pair_content(). This does all the work of that function,
The core of pair_content(). This does all the work of that function,
except checking for values out of range and null pointers.
void PDC_reset_prog_mode(void);
The non-portable functionality of reset_prog_mode() is handled here --
whatever's not done in _restore_mode(). In current ports: In OS/2, this
sets the keyboard to binary mode; in Win32, it enables or disables the
The non-portable functionality of reset_prog_mode() is handled here --
whatever's not done in _restore_mode(). In current ports: In OS/2, this
sets the keyboard to binary mode; in Win32, it enables or disables the
mouse pointer to match the saved mode; in others it does nothing.
void PDC_reset_shell_mode(void);
The same thing, for reset_shell_mode(). In OS/2 and Win32, it restores
The same thing, for reset_shell_mode(). In OS/2 and Win32, it restores
the default console mode; in others it does nothing.
int PDC_resize_screen(int nlines, int ncols);
This does the main work of resize_term(). It may respond to non-zero
parameters, by setting the screen to the specified size; to zero
parameters, by setting the screen to a size chosen by the user at
runtime, in an unspecified way (e.g., by dragging the edges of the
window); or both. It may also do nothing, if there's no appropriate
This does the main work of resize_term(). It may respond to non-zero
parameters, by setting the screen to the specified size; to zero
parameters, by setting the screen to a size chosen by the user at
runtime, in an unspecified way (e.g., by dragging the edges of the
window); or both. It may also do nothing, if there's no appropriate
action for the platform.
void PDC_restore_screen_mode(int i);
Called from _restore_mode() in kernel.c, this function does the actual
Called from _restore_mode() in kernel.c, this function does the actual
mode changing, if applicable. Currently used only in DOS and OS/2.
void PDC_save_screen_mode(int i);
Called from _save_mode() in kernel.c, this function saves the actual
Called from _save_mode() in kernel.c, this function saves the actual
screen mode, if applicable. Currently used only in DOS and OS/2.
void PDC_scr_close(void);
The platform-specific part of endwin(). It may restore the image of the
original screen saved by PDC_scr_open(), if the PDC_RESTORE_SCREEN
environment variable is set; either way, if using an existing terminal,
this function should restore it to the mode it had at startup, and move
The platform-specific part of endwin(). It may restore the image of the
original screen saved by PDC_scr_open(), if the PDC_RESTORE_SCREEN
environment variable is set; either way, if using an existing terminal,
this function should restore it to the mode it had at startup, and move
the cursor to the lower left corner. (The X11 port does nothing.)
void PDC_scr_free(void);
Frees the memory for SP allocated by PDC_scr_open(). Called by
Frees the memory for SP allocated by PDC_scr_open(). Called by
delscreen().
int PDC_scr_open(int argc, char **argv);
The platform-specific part of initscr(). It's actually called from
Xinitscr(); the arguments, if present, correspond to those used with
main(), and may be used to set the title of the terminal window, or for
other, platform-specific purposes. (The arguments are currently used
only in X11.) PDC_scr_open() must allocate memory for SP, and must
initialize acs_map[] (unless it's preset) and several members of SP,
including lines, cols, mouse_wait, orig_attr (and if orig_attr is true,
orig_fore and orig_back), mono, _restore and _preserve. (Although SP is
used the same way in all ports, it's allocated here in order to allow
the X11 port to map it to a block of shared memory.) If using an
existing terminal, and the environment variable PDC_RESTORE_SCREEN is
set, this function may also store the existing screen image for later
The platform-specific part of initscr(). It's actually called from
Xinitscr(); the arguments, if present, correspond to those used with
main(), and may be used to set the title of the terminal window, or for
other, platform-specific purposes. (The arguments are currently used
only in X11.) PDC_scr_open() must allocate memory for SP, and must
initialize acs_map[] (unless it's preset) and several members of SP,
including lines, cols, mouse_wait, orig_attr (and if orig_attr is true,
orig_fore and orig_back), mono, _restore and _preserve. (Although SP is
used the same way in all ports, it's allocated here in order to allow
the X11 port to map it to a block of shared memory.) If using an
existing terminal, and the environment variable PDC_RESTORE_SCREEN is
set, this function may also store the existing screen image for later
restoration by PDC_scr_close().
@ -265,9 +265,9 @@ pdcsetsc.c:
int PDC_curs_set(int visibility);
Called from curs_set(). Changes the appearance of the cursor -- 0 turns
it off, 1 is normal (the terminal's default, if applicable, as
determined by SP->orig_cursor), and 2 is high visibility. The exact
Called from curs_set(). Changes the appearance of the cursor -- 0 turns
it off, 1 is normal (the terminal's default, if applicable, as
determined by SP->orig_cursor), and 2 is high visibility. The exact
appearance of these modes is not specified.
@ -276,30 +276,30 @@ pdcutil.c:
void PDC_beep(void);
Emits a short audible beep. If this is not possible on your platform,
you must set SP->audible to false during initialization (i.e., from
PDC_scr_open() -- not here); otherwise, set it to true. This function is
Emits a short audible beep. If this is not possible on your platform,
you must set SP->audible to false during initialization (i.e., from
PDC_scr_open() -- not here); otherwise, set it to true. This function is
called from beep().
void PDC_napms(int ms);
This is the core delay routine, called by napms(). It pauses for about
(the X/Open spec says "at least") ms milliseconds, then returns. High
degrees of accuracy and precision are not expected (though desirable, if
you can achieve them). More important is that this function gives back
the process' time slice to the OS, so that PDCurses idles at low CPU
This is the core delay routine, called by napms(). It pauses for about
(the X/Open spec says "at least") ms milliseconds, then returns. High
degrees of accuracy and precision are not expected (though desirable, if
you can achieve them). More important is that this function gives back
the process' time slice to the OS, so that PDCurses idles at low CPU
usage.
const char *PDC_sysname(void);
Returns a short string describing the platform, such as "DOS" or "X11".
This is used by longname(). It must be no more than 100 characters; it
Returns a short string describing the platform, such as "DOS" or "X11".
This is used by longname(). It must be no more than 100 characters; it
should be much, much shorter (existing platforms use no more than 5).
--------------------------------------------------------------------------
The following functions are implemented in the platform directories, but
are accessed directly by apps. Refer to the user documentation for their
The following functions are implemented in the platform directories, but
are accessed directly by apps. Refer to the user documentation for their
descriptions:

24
graphics/pdcurs34/README
View File

@ -1,7 +1,7 @@
Welcome to PDCurses!
====================
Public Domain Curses, aka PDCurses, is an implementation of X/Open
Public Domain Curses, aka PDCurses, is an implementation of X/Open
curses for multiple platforms. The latest version can be found at:
http://pdcurses.sourceforge.net/
@ -12,14 +12,14 @@ For changes, see the HISTORY file.
Legal Stuff
-----------
The core package is in the public domain, but small portions of PDCurses
are subject to copyright under various licenses. Each directory
contains a README file, with a section titled "Distribution Status"
The core package is in the public domain, but small portions of PDCurses
are subject to copyright under various licenses. Each directory
contains a README file, with a section titled "Distribution Status"
which describes the status of the files in that directory.
If you use PDCurses in an application, an acknowledgement would be
appreciated, but is not mandatory. If you make corrections or
enhancements to PDCurses, please forward them to the current maintainer
If you use PDCurses in an application, an acknowledgement would be
appreciated, but is not mandatory. If you make corrections or
enhancements to PDCurses, please forward them to the current maintainer
for the benefit of other users.
This software is provided AS IS with NO WARRANTY whatsoever.
@ -28,17 +28,17 @@ This software is provided AS IS with NO WARRANTY whatsoever.
Ports
-----
PDCurses has been ported to DOS, OS/2, Win32, X11 and SDL. A directory
containing the port-specific source files exists for each of these
PDCurses has been ported to DOS, OS/2, Win32, X11 and SDL. A directory
containing the port-specific source files exists for each of these
platforms. Build instructions are in the README file for each platform.
Distribution Status
-------------------
All files in this directory except configure, config.guess and
config.sub are released to the Public Domain. config.guess and
config.sub are under the GPL; configure is under a free license
All files in this directory except configure, config.guess and
config.sub are released to the Public Domain. config.guess and
config.sub are under the GPL; configure is under a free license
described within it.

8
graphics/pdcurs34/include/term.h
View File

@ -1,9 +1,9 @@
/****************************************************************************
* apps/graphics/pdcurses/term.h
* Public Domain Curses
* PDCurses doesn't operate with terminfo, but we need these functions for
* compatibility, to allow some things (notably, interface libraries for
* other languages) to be compiled. Anyone who tries to actually _use_
* PDCurses doesn't operate with terminfo, but we need these functions for
* compatibility, to allow some things (notably, interface libraries for
* other languages) to be compiled. Anyone who tries to actually _use_
* them will be disappointed, since they only return ERR.
* $Id: term.h,v 1.16 2008/07/13 16:08:16 wmcbrine Exp $
*
@ -92,7 +92,7 @@ char *tgoto(const char *, int, int);
int tigetflag(const char *);
int tigetnum(const char *);
char *tigetstr(const char *);
char *tparm(const char *, long, long, long, long, long,
char *tparm(const char *, long, long, long, long, long,
long, long, long, long);
int tputs(const char *, int, int (*)(int));

2
graphics/pdcurs34/nuttx/Make.defs
View File

@ -33,7 +33,7 @@
#
############################################################################
# CSRCS +=
# CSRCS +=
DEPPATH += --dep-path nuttx
VPATH += :nuttx

4
graphics/pdcurs34/pdcurses/README
View File

@ -1,14 +1,14 @@
PDCurses Portable Core
======================
This directory contains core PDCurses source code files common to all
This directory contains core PDCurses source code files common to all
platforms.
Building
--------
These modules are built by the platform-specific makefiles, in the
These modules are built by the platform-specific makefiles, in the
platform directories.

40
graphics/pdcurs34/pdcurses/pdc_addch.c
View File

@ -75,41 +75,41 @@
* mvaddch() moves the cursor to the specified (y, x) position, and
* adds ch to stdscr. mvadd_wch() is the wide version.
*
* mvwaddch() moves the cursor to the specified position and adds
* mvwaddch() moves the cursor to the specified position and adds
* ch to the specified window. mvwadd_wch() is the wide version.
*
* echochar() adds ch to stdscr at the current cursor position and
* echochar() adds ch to stdscr at the current cursor position and
* calls refresh(). echo_wchar() is the wide version.
*
* wechochar() adds ch to the specified window and calls
* wechochar() adds ch to the specified window and calls
* wrefresh(). wecho_wchar() is the wide version.
*
* addrawch(), waddrawch(), mvaddrawch() and mvwaddrawch() are
* PDCurses-specific wrappers for addch() etc. that disable the
* PDCurses-specific wrappers for addch() etc. that disable the
* translation of control characters.
*
* The following applies to all these functions:
*
* If the cursor moves on to the right margin, an automatic newline
* is performed. If scrollok is enabled, and a character is added
* to the bottom right corner of the window, the scrolling region
* will be scrolled up one line. If scrolling is not allowed, ERR
* If the cursor moves on to the right margin, an automatic newline
* is performed. If scrollok is enabled, and a character is added
* to the bottom right corner of the window, the scrolling region
* will be scrolled up one line. If scrolling is not allowed, ERR
* will be returned.
*
* If ch is a tab, newline, or backspace, the cursor will be moved
* appropriately within the window. If ch is a newline, the
* clrtoeol routine is called before the cursor is moved to the
* beginning of the next line. If newline mapping is off, the
* cursor will be moved to the next line, but the x coordinate will
* be unchanged. If ch is a tab the cursor is moved to the next
* tab position within the window. If ch is another control
* character, it will be drawn in the ^X notation. Calling the
* inch() routine after adding a control character returns the
* representation of the control character, not the control
* If ch is a tab, newline, or backspace, the cursor will be moved
* appropriately within the window. If ch is a newline, the
* clrtoeol routine is called before the cursor is moved to the
* beginning of the next line. If newline mapping is off, the
* cursor will be moved to the next line, but the x coordinate will
* be unchanged. If ch is a tab the cursor is moved to the next
* tab position within the window. If ch is another control
* character, it will be drawn in the ^X notation. Calling the
* inch() routine after adding a control character returns the
* representation of the control character, not the control
* character.
*
* Video attributes can be combined with a character by ORing them
* into the parameter. Text, including attributes, can be copied
* Video attributes can be combined with a character by ORing them
* into the parameter. Text, including attributes, can be copied
* from one place to another by using inch() and addch().
*
* Note that in PDCurses, for now, a cchar_t and a chtype are the

14
graphics/pdcurs34/pdcurses/pdc_addchstr.c
View File

@ -61,15 +61,15 @@
* int n);
*
* Description:
* These routines write a chtype or cchar_t string directly into
* the window structure, starting at the current or specified
* position. The four routines with n as the last argument copy at
* most n elements, but no more than will fit on the line. If n =
* -1 then the whole string is copied, up to the maximum number
* These routines write a chtype or cchar_t string directly into
* the window structure, starting at the current or specified
* position. The four routines with n as the last argument copy at
* most n elements, but no more than will fit on the line. If n =
* -1 then the whole string is copied, up to the maximum number
* that will fit on the line.
*
* The cursor position is not advanced. These routines do not check
* for newline or other special characters, nor does any line
* The cursor position is not advanced. These routines do not check
* for newline or other special characters, nor does any line
* wrapping occur.
*
* Return Value:

18
graphics/pdcurs34/pdcurses/pdc_attr.c
View File

@ -77,24 +77,24 @@
* chtype getattrs(WINDOW *win);
*
* Description:
* These functions manipulate the current attributes and/or colors
* of the named window. These attributes can be any combination
* These functions manipulate the current attributes and/or colors
* of the named window. These attributes can be any combination
* of A_STANDOUT, A_REVERSE, A_BOLD, A_DIM, A_BLINK, A_UNDERLINE.
*
* These constants are defined in curses.h and can be combined
* with the bitwise-OR operator (|).
*
* The current attributes of a window are applied to all chtypes
* that are written into the window with waddch(). Attributes are
* a property of the chtype, and move with the character through
* The current attributes of a window are applied to all chtypes
* that are written into the window with waddch(). Attributes are
* a property of the chtype, and move with the character through
* any scrolling or insert/delete operations.
*
* attrset() sets the current attributes of the given window to
* attrs. attroff() turns off the named attributes without
* affecting any other attributes; attron() turns them on.
* attrset() sets the current attributes of the given window to
* attrs. attroff() turns off the named attributes without
* affecting any other attributes; attron() turns them on.
* color_set() sets the window color to the value of color_pair.
*
* standout() is the same as attron(A_STANDOUT). standend() is the
* standout() is the same as attron(A_STANDOUT). standend() is the
* same as attrset(A_NORMAL); that is, it turns off all attributes.
*
* Return Value:

4
graphics/pdcurs34/pdcurses/pdc_bkgd.c
View File

@ -71,7 +71,7 @@
* there is a conflict (e.g., different color pairs).
*
* Return Value:
* bkgd() and wbkgd() return OK, unless the window is NULL, in
* bkgd() and wbkgd() return OK, unless the window is NULL, in
* which case they return ERR.
*
* Portability X/Open BSD SYS V
@ -173,7 +173,7 @@ int wbkgd(WINDOW * win, chtype ch)
attr ^= oldattr;
attr |= newattr;
/* Change character if it is there because it was the old background
/* Change character if it is there because it was the old background
* character.
*/

28
graphics/pdcurs34/pdcurses/pdc_border.c
View File

@ -41,9 +41,9 @@
/* Name: border
*
* Synopsis:
* int border(chtype ls, chtype rs, chtype ts, chtype bs, chtype tl,
* int border(chtype ls, chtype rs, chtype ts, chtype bs, chtype tl,
* chtype tr, chtype bl, chtype br);
* int wborder(WINDOW *win, chtype ls, chtype rs, chtype ts,
* int wborder(WINDOW *win, chtype ls, chtype rs, chtype ts,
* chtype bs, chtype tl, chtype tr, chtype bl, chtype br);
* int box(WINDOW *win, chtype verch, chtype horch);
* int hline(chtype ch, int n);
@ -74,8 +74,8 @@
* int mvwvline_set(WINDOW *win, int y, int x, const cchar_t *wch, int n);
*
* Description:
* border(), wborder(), and box() draw a border around the edge of
* the window. If any argument is zero, an appropriate default is
* border(), wborder(), and box() draw a border around the edge of
* the window. If any argument is zero, an appropriate default is
* used:
*
* ls left side of border ACS_VLINE
@ -87,14 +87,14 @@
* bl bottom left corner of border ACS_LLCORNER
* br bottom right corner of border ACS_LRCORNER
*
* hline() and whline() draw a horizontal line, using ch, starting
* from the current cursor position. The cursor position does not
* change. The line is at most n characters long, or as many as
* hline() and whline() draw a horizontal line, using ch, starting
* from the current cursor position. The cursor position does not
* change. The line is at most n characters long, or as many as
* will fit in the window.
*
* vline() and wvline() draw a vertical line, using ch, starting
* from the current cursor position. The cursor position does not
* change. The line is at most n characters long, or as many as
* vline() and wvline() draw a vertical line, using ch, starting
* from the current cursor position. The cursor position does not
* change. The line is at most n characters long, or as many as
* will fit in the window.
*
* Return Value:
@ -135,9 +135,9 @@
* Private Functions
****************************************************************************/
/* _attr_passthru() -- Takes a single chtype 'ch' and checks if the
* current attribute of window 'win', as set by wattrset(), and/or the
* current background of win, as set by wbkgd(), should by combined with
/* _attr_passthru() -- Takes a single chtype 'ch' and checks if the
* current attribute of window 'win', as set by wattrset(), and/or the
* current background of win, as set by wbkgd(), should by combined with
* it. Attributes set explicitly in ch take precedence.
*/
@ -159,7 +159,7 @@ static chtype _attr_passthru(WINDOW * win, chtype ch)
}
/* wrs (4/10/93) -- Apply the same sort of logic for the window background,
* in that it only takes precedence if other color attributes are not there.
* in that it only takes precedence if other color attributes are not there.
*/
if (!(attr & A_COLOR))

6
graphics/pdcurs34/pdcurses/pdc_clear.c
View File

@ -51,14 +51,14 @@
* int wclrtoeol(WINDOW *win);
*
* Description:
* erase() and werase() copy blanks (i.e. the background chtype) to
* erase() and werase() copy blanks (i.e. the background chtype) to
* every cell of the window.
*
* clear() and wclear() are similar to erase() and werase(), but
* they also call clearok() to ensure that the the window is
* they also call clearok() to ensure that the the window is
* cleared on the next wrefresh().
*
* clrtobot() and wclrtobot() clear the window from the current
* clrtobot() and wclrtobot() clear the window from the current
* cursor position to the end of the window.
*
* clrtoeol() and wclrtoeol() clear the window from the current

24
graphics/pdcurs34/pdcurses/pdc_color.c
View File

@ -56,10 +56,10 @@
*
* Description:
* To use these routines, start_color() must be called, usually
* immediately after initscr(). Colors are always used in pairs,
* referred to as color-pairs. A color-pair consists of a
* foreground color and a background color. A color-pair is
* initialized via init_pair(). After initialization, COLOR_PAIR(n)
* immediately after initscr(). Colors are always used in pairs,
* referred to as color-pairs. A color-pair consists of a
* foreground color and a background color. A color-pair is
* initialized via init_pair(). After initialization, COLOR_PAIR(n)
* can be used like any other video attribute.
*
* start_color() initializes eight basic colors (black, red, green,
@ -68,16 +68,16 @@
* maximum number of colors and color-pairs the terminal is capable
* of displaying).
*
* init_pair() changes the definition of a color-pair. It takes
* three arguments: the number of the color-pair to be redefined,
* and the new values of the foreground and background colors. The
* pair number must be between 0 and COLOR_PAIRS - 1, inclusive.
* The foreground and background must be between 0 and COLORS - 1,
* inclusive. If the color pair was previously initialized, the
* screen is refreshed, and all occurrences of that color-pair are
* init_pair() changes the definition of a color-pair. It takes
* three arguments: the number of the color-pair to be redefined,
* and the new values of the foreground and background colors. The
* pair number must be between 0 and COLOR_PAIRS - 1, inclusive.
* The foreground and background must be between 0 and COLORS - 1,
* inclusive. If the color pair was previously initialized, the
* screen is refreshed, and all occurrences of that color-pair are
* changed to the new definition.
*
* has_colors() indicates if the terminal supports, and can
* has_colors() indicates if the terminal supports, and can
* maniplulate color. It returns true or false.
*
* can_change_color() indicates if the terminal has the capability

8
graphics/pdcurs34/pdcurses/pdc_debug.c
View File

@ -46,12 +46,12 @@
* void PDC_debug(const char *, ...);
*
* Description:
* traceon() and traceoff() toggle the recording of debugging
* information to the file "trace". Although not standard, similar
* traceon() and traceoff() toggle the recording of debugging
* information to the file "trace". Although not standard, similar
* functions are in some other curses implementations.
*
* PDC_debug() is the function that writes to the file, based on
* whether traceon() has been called. It's used from the PDC_LOG()
* PDC_debug() is the function that writes to the file, based on
* whether traceon() has been called. It's used from the PDC_LOG()
* macro.
*
* Portability X/Open BSD SYS V

4
graphics/pdcurs34/pdcurses/pdc_deleteln.c
View File

@ -59,10 +59,10 @@
* current line are moved up one line. The bottom line of the
* window is cleared. The cursor position does not change.
*
* With the insertln() and winsertn() functions, a blank line is
* With the insertln() and winsertn() functions, a blank line is
* inserted above the current line and the bottom line is lost.
*
* mvdeleteln(), mvwdeleteln(), mvinsertln() and mvwinsertln()
* mvdeleteln(), mvwdeleteln(), mvinsertln() and mvwinsertln()
* allow moving the cursor and inserting/deleting in one call.
*
* Return Value:

34
graphics/pdcurs34/pdcurses/pdc_getch.c
View File

@ -59,13 +59,13 @@
* int PDC_return_key_modifiers(bool flag);
*
* Description:
* With the getch(), wgetch(), mvgetch(), and mvwgetch() functions,
* a character is read from the terminal associated with the window.
* In nodelay mode, if there is no input waiting, the value ERR is
* returned. In delay mode, the program will hang until the system
* passes text through to the program. Depending on the setting of
* cbreak(), this will be after one character or after the first
* newline. Unless noecho() has been set, the character will also
* With the getch(), wgetch(), mvgetch(), and mvwgetch() functions,
* a character is read from the terminal associated with the window.
* In nodelay mode, if there is no input waiting, the value ERR is
* returned. In delay mode, the program will hang until the system
* passes text through to the program. Depending on the setting of
* cbreak(), this will be after one character or after the first
* newline. Unless noecho() has been set, the character will also
* be echoed into the designated window.
*
* If keypad() is true, and a function key is pressed, the token for
@ -76,25 +76,25 @@
* If nodelay(win, true) has been called on the window and no input
* is waiting, the value ERR is returned.
*
* ungetch() places ch back onto the input queue to be returned by
* ungetch() places ch back onto the input queue to be returned by
* the next call to wgetch().
*
* flushinp() throws away any type-ahead that has been typed by the
* flushinp() throws away any type-ahead that has been typed by the
* user and has not yet been read by the program.
*
* PDC_get_key_modifiers() returns the keyboard modifiers (shift,
* control, alt, numlock) effective at the time of the last getch()
* call, if PDC_save_key_modifiers(true) has been called before the
* getch(). Use the macros PDC_KEY_MODIFIER_* to determine which
* modifier(s) were set. PDC_return_key_modifiers() tells getch()
* to return modifier keys pressed alone as keystrokes (KEY_ALT_L,
* PDC_get_key_modifiers() returns the keyboard modifiers (shift,
* control, alt, numlock) effective at the time of the last getch()
* call, if PDC_save_key_modifiers(true) has been called before the
* getch(). Use the macros PDC_KEY_MODIFIER_* to determine which
* modifier(s) were set. PDC_return_key_modifiers() tells getch()
* to return modifier keys pressed alone as keystrokes (KEY_ALT_L,
* etc.). These may not work on all platforms.
*
* NOTE: getch() and ungetch() are implemented as macros, to avoid
* NOTE: getch() and ungetch() are implemented as macros, to avoid
* conflict with many DOS compiler's runtime libraries.
*
* Return Value:
* These functions return ERR or the value of the character, meta
* These functions return ERR or the value of the character, meta
* character or function key token.
*
* Portability X/Open BSD SYS V

18
graphics/pdcurs34/pdcurses/pdc_getstr.c
View File

@ -60,20 +60,20 @@
* int mvwgetn_wstr(WINDOW *win, int y, int x, wint_t *wstr, int n);
*
* Description:
* These routines call wgetch() repeatedly to build a string,
* interpreting erase and kill characters along the way, until a
* newline or carriage return is received. When PDCurses is built
* with wide-character support enabled, the narrow-character
* functions convert the wgetch()'d values into a multibyte string
* in the current locale before returning it. The resulting string
* is placed in the area pointed to by *str. The routines with n as
* These routines call wgetch() repeatedly to build a string,
* interpreting erase and kill characters along the way, until a
* newline or carriage return is received. When PDCurses is built
* with wide-character support enabled, the narrow-character
* functions convert the wgetch()'d values into a multibyte string
* in the current locale before returning it. The resulting string
* is placed in the area pointed to by *str. The routines with n as
* the last argument read at most n characters.
*
* Note that there's no way to know how long the buffer passed to
* Note that there's no way to know how long the buffer passed to
* wgetstr() is, so use wgetnstr() to avoid buffer overflows.
*
* Return Value:
* This functions return ERR on failure or any other value on
* This functions return ERR on failure or any other value on
* success.
*
* Portability X/Open BSD SYS V

12
graphics/pdcurs34/pdcurses/pdc_getyx.c
View File

@ -59,12 +59,12 @@
* int getmaxx(WINDOW *win);
*
* Description:
* The getyx() macro (defined in curses.h -- the prototypes here
* are merely illustrative) puts the current cursor position of the
* specified window into y and x. getbegyx() and getmaxyx() return
* the starting coordinates and size of the specified window,
* respectively. getparyx() returns the starting coordinates of the
* parent's window, if the specified window is a subwindow;
* The getyx() macro (defined in curses.h -- the prototypes here
* are merely illustrative) puts the current cursor position of the
* specified window into y and x. getbegyx() and getmaxyx() return
* the starting coordinates and size of the specified window,
* respectively. getparyx() returns the starting coordinates of the
* parent's window, if the specified window is a subwindow;
* otherwise it sets y and x to -1. These are all macros.
*
* getsyx() gets the coordinates of the virtual screen cursor, and

12
graphics/pdcurs34/pdcurses/pdc_inch.c
View File

@ -52,14 +52,14 @@
* int mvwin_wch(WINDOW *win, int y, int x, cchar_t *wcval);
*
* Description:
* The inch() functions retrieve the character and attribute from
* the current or specified window position, in the form of a
* The inch() functions retrieve the character and attribute from
* the current or specified window position, in the form of a
* chtype. If a NULL window is specified, (chtype)ERR is returned.
*
* The in_wch() functions are the wide-character versions; instead
* of returning a chtype, they store a cchar_t at the address
* specified by wcval, and return OK or ERR. (No value is stored
* when ERR is returned.) Note that in PDCurses, chtype and cchar_t
* The in_wch() functions are the wide-character versions; instead
* of returning a chtype, they store a cchar_t at the address
* specified by wcval, and return OK or ERR. (No value is stored
* when ERR is returned.) Note that in PDCurses, chtype and cchar_t
* are the same.
*
* Portability X/Open BSD SYS V

6
graphics/pdcurs34/pdcurses/pdc_inchstr.c
View File

@ -60,12 +60,12 @@
* int mvwin_wchnstr(WINDOW *win, int y, int x, cchar_t *wch, int n);
*
* Description:
* These routines read a chtype or cchar_t string from the window,
* starting at the current or specified position, and ending at the
* These routines read a chtype or cchar_t string from the window,
* starting at the current or specified position, and ending at the
* right margin, or after n elements, whichever is less.
*
* Return Value:
* All functions return the number of elements read, or ERR on
* All functions return the number of elements read, or ERR on
* error.
*
* Portability X/Open BSD SYS V

54
graphics/pdcurs34/pdcurses/pdc_initscr.c
View File

@ -54,23 +54,23 @@
* const char *curses_version(void);
*
* Description:
* initscr() should be the first curses routine called. It will
* initialize all curses data structures, and arrange that the
* first call to refresh() will clear the screen. In case of
* error, initscr() will write a message to standard error and end
* initscr() should be the first curses routine called. It will
* initialize all curses data structures, and arrange that the
* first call to refresh() will clear the screen. In case of
* error, initscr() will write a message to standard error and end
* the program.
*
* endwin() should be called before exiting or escaping from curses
* mode temporarily. It will restore tty modes, move the cursor to
* the lower left corner of the screen and reset the terminal into
* the proper non-visual mode. To resume curses after a temporary
* endwin() should be called before exiting or escaping from curses
* mode temporarily. It will restore tty modes, move the cursor to
* the lower left corner of the screen and reset the terminal into
* the proper non-visual mode. To resume curses after a temporary
* escape, call refresh() or doupdate().
*
* isendwin() returns true if endwin() has been called without a
* isendwin() returns true if endwin() has been called without a
* subsequent refresh, unless SP is NULL.
*
* In some implementations of curses, newterm() allows the use of
* multiple terminals. Here, it's just an alternative interface for
* In some implementations of curses, newterm() allows the use of
* multiple terminals. Here, it's just an alternative interface for
* initscr(). It always returns SP, or NULL.
*
* delscreen() frees the memory allocated by newterm() or
@ -78,29 +78,29 @@
* usually not needed. In PDCurses, the parameter must be the
* value of SP, and delscreen() sets SP to NULL.
*
* set_term() does nothing meaningful in PDCurses, but is included
* set_term() does nothing meaningful in PDCurses, but is included
* for compatibility with other curses implementations.
*
* resize_term() is effectively two functions: When called with
* nonzero values for nlines and ncols, it attempts to resize the
* screen to the given size. When called with (0, 0), it merely
* adjusts the internal structures to match the current size after
* the screen is resized by the user. On the currently supported
* platforms, this functionality is mutually exclusive: X11 allows
* user resizing, while DOS, OS/2 and Win32 allow programmatic
* resizing. If you want to support user resizing, you should check
* for getch() returning KEY_RESIZE, and/or call is_termresized()
* at appropriate times; if either condition occurs, call
* resize_term(0, 0). Then, with either user or programmatic
* resizing, you'll have to resize any windows you've created, as
* resize_term() is effectively two functions: When called with
* nonzero values for nlines and ncols, it attempts to resize the
* screen to the given size. When called with (0, 0), it merely
* adjusts the internal structures to match the current size after
* the screen is resized by the user. On the currently supported
* platforms, this functionality is mutually exclusive: X11 allows
* user resizing, while DOS, OS/2 and Win32 allow programmatic
* resizing. If you want to support user resizing, you should check
* for getch() returning KEY_RESIZE, and/or call is_termresized()
* at appropriate times; if either condition occurs, call
* resize_term(0, 0). Then, with either user or programmatic
* resizing, you'll have to resize any windows you've created, as
* appropriate; resize_term() only handles stdscr and curscr.
*
* is_termresized() returns true if the curses screen has been
* resized by the user, and a call to resize_term() is needed.
* Checking for KEY_RESIZE is generally preferable, unless you're
* resized by the user, and a call to resize_term() is needed.
* Checking for KEY_RESIZE is generally preferable, unless you're
* not handling the keyboard.
*
* curses_version() returns a string describing the version of
* curses_version() returns a string describing the version of
* PDCurses.
*
* Return Value:

62
graphics/pdcurs34/pdcurses/pdc_inopts.c
View File

@ -65,57 +65,57 @@
* int nocrmode(void);
*
* Description:
* cbreak() and nocbreak() toggle cbreak mode. In cbreak mode,
* characters typed by the user are made available immediately, and
* erase/kill character processing is not performed. In nocbreak
* mode, typed characters are buffered until a newline or carriage
* return. Interrupt and flow control characters are unaffected by
* cbreak() and nocbreak() toggle cbreak mode. In cbreak mode,
* characters typed by the user are made available immediately, and
* erase/kill character processing is not performed. In nocbreak
* mode, typed characters are buffered until a newline or carriage
* return. Interrupt and flow control characters are unaffected by
* this mode. PDCurses always starts in cbreak mode.
*
* echo() and noecho() control whether typed characters are echoed
* by the input routine. Initially, input characters are echoed.
* echo() and noecho() control whether typed characters are echoed
* by the input routine. Initially, input characters are echoed.
* Subsequent calls to echo() and noecho() do not flush type-ahead.
*
* halfdelay() is similar to cbreak(), but allows for a time limit
* to be specified, in tenths of a second. This causes getch() to
* block for that period before returning ERR if no key has been
* halfdelay() is similar to cbreak(), but allows for a time limit
* to be specified, in tenths of a second. This causes getch() to
* block for that period before returning ERR if no key has been
* received. tenths must be between 1 and 255.
*
* keypad() controls whether getch() returns function/special keys
* as single key codes (e.g., the left arrow key as KEY_LEFT). Per
* X/Open, the default for keypad mode is OFF. You'll probably want
* it on. With keypad mode off, if a special key is pressed,
* keypad() controls whether getch() returns function/special keys
* as single key codes (e.g., the left arrow key as KEY_LEFT). Per
* X/Open, the default for keypad mode is OFF. You'll probably want
* it on. With keypad mode off, if a special key is pressed,
* getch() does nothing or returns ERR.
*
* nodelay() controls whether wgetch() is a non-blocking call. If
* the option is enabled, and no input is ready, wgetch() will
* return ERR. If disabled, wgetch() will hang until input is
* nodelay() controls whether wgetch() is a non-blocking call. If
* the option is enabled, and no input is ready, wgetch() will
* return ERR. If disabled, wgetch() will hang until input is
* ready.
*
* nl() enables the translation of a carriage return into a newline
* on input. nonl() disables this. Initially, the translation does
* nl() enables the translation of a carriage return into a newline
* on input. nonl() disables this. Initially, the translation does
* occur.
*
* raw() and noraw() toggle raw mode. Raw mode is similar to cbreak
* mode, in that characters typed are immediately passed through to
* the user program. The difference is that in raw mode, the INTR,
* QUIT, SUSP, and STOP characters are passed through without being
* raw() and noraw() toggle raw mode. Raw mode is similar to cbreak
* mode, in that characters typed are immediately passed through to
* the user program. The difference is that in raw mode, the INTR,
* QUIT, SUSP, and STOP characters are passed through without being
* interpreted, and without generating a signal.
*
* In PDCurses, the meta() function sets raw mode on or off.
*
* timeout() and wtimeout() set blocking or non-blocking reads for
* the specified window. The delay is measured in milliseconds. If
* it's negative, a blocking read is used; if zero, then non-
* blocking reads are done -- if no input is waiting, ERR is
* returned immediately. If the delay is positive, the read blocks
* timeout() and wtimeout() set blocking or non-blocking reads for
* the specified window. The delay is measured in milliseconds. If
* it's negative, a blocking read is used; if zero, then non-
* blocking reads are done -- if no input is waiting, ERR is
* returned immediately. If the delay is positive, the read blocks
* for the delay period; if the period expires, ERR is returned.
*
* intrflush(), notimeout(), noqiflush(), qiflush() and typeahead()
* do nothing in PDCurses, but are included for compatibility with
* do nothing in PDCurses, but are included for compatibility with
* other curses implementations.
*
* crmode() and nocrmode() are archaic equivalents to cbreak() and
* crmode() and nocrmode() are archaic equivalents to cbreak() and
* nocbreak(), respectively.
*
* Return Value:
@ -319,7 +319,7 @@ void wtimeout(WINDOW * win, int delay)
}
else if (!delay)
{
/* This causes a non-blocking read on the window, so turn off delay mode
/* This causes a non-blocking read on the window, so turn off delay mode
*/
win->_nodelay = true;

16
graphics/pdcurs34/pdcurses/pdc_insch.c
View File

@ -57,20 +57,20 @@
* int mvwins_wch(WINDOW *win, int y, int x, const cchar_t *wch);
*
* Description:
* The insch() functions insert a chtype into the window at the
* current or specified cursor position. The cursor is NOT
* advanced. A newline is equivalent to clrtoeol(); tabs are
* expanded; other control characters are converted as with
* The insch() functions insert a chtype into the window at the
* current or specified cursor position. The cursor is NOT
* advanced. A newline is equivalent to clrtoeol(); tabs are
* expanded; other control characters are converted as with
* unctrl().
*
* The ins_wch() functions are the wide-character
* equivalents, taking cchar_t pointers rather than chtypes.
*
* Video attributes can be combined with a character by ORing
* them into the parameter. Text, including attributes, can be
* them into the parameter. Text, including attributes, can be
* copied from one place to another using inch() and insch().
*
* insrawch() etc. are PDCurses-specific wrappers for insch() etc.
* insrawch() etc. are PDCurses-specific wrappers for insch() etc.
* that disable the translation of control characters.
*
* Return Value:
@ -171,7 +171,7 @@ int winsch(WINDOW * win, chtype ch)
int maxx;
chtype *temp;
/* If the incoming character doesn't have its own attribute, then use the
/* If the incoming character doesn't have its own attribute, then use the
* current attributes for the window. If it has attributes but not a
* color component, OR the attributes to the current attributes for the
* window. If it has a color component, use the attributes solely from
@ -182,7 +182,7 @@ int winsch(WINDOW * win, chtype ch)
attr |= win->_attrs;
}
/* wrs (4/10/93): Apply the same sort of logic for the window background,
/* wrs (4/10/93): Apply the same sort of logic for the window background,
* in that it only takes precedence if other color attributes are not
* there and that the background character will only print if the
* printing character is blank. */

12
graphics/pdcurs34/pdcurses/pdc_insstr.c
View File

@ -64,12 +64,12 @@
* at the current cursor position, by repeatedly calling winsch().
* When PDCurses is built with wide-character support enabled, the
* narrow-character functions treat the string as a multibyte
* string in the current locale, and convert it first. All
* characters to the right of the cursor are moved to the right,
* with the possibility of the rightmost characters on the line
* being lost. The cursor position does not change (after moving
* to y, x, if specified). The routines with n as the last
* argument insert at most n characters; if n is negative, then the
* string in the current locale, and convert it first. All
* characters to the right of the cursor are moved to the right,
* with the possibility of the rightmost characters on the line
* being lost. The cursor position does not change (after moving
* to y, x, if specified). The routines with n as the last
* argument insert at most n characters; if n is negative, then the
* entire string is inserted.
*
* Return Value:

12
graphics/pdcurs34/pdcurses/pdc_instr.c
View File

@ -60,16 +60,16 @@
* int mvwinnwstr(WINDOW *win, int y, int x, wchar_t *wstr, int n);
*
* Description:
* These functions take characters (or wide characters) from the
* current or specified position in the window, and return them as
* a string in str (or wstr). Attributes are ignored. The functions
* with n as the last argument return a string at most n characters
* These functions take characters (or wide characters) from the
* current or specified position in the window, and return them as
* a string in str (or wstr). Attributes are ignored. The functions
* with n as the last argument return a string at most n characters
* long.
*
* Return Value:
* Upon successful completion, innstr(), mvinnstr(), mvwinnstr()
* Upon successful completion, innstr(), mvinnstr(), mvwinnstr()
* and winnstr() return the number of characters actually read into
* the string; instr(), mvinstr(), mvwinstr() and winstr() return
* the string; instr(), mvinstr(), mvwinstr() and winstr() return
* OK. Otherwise, all these functions return ERR.
*
* Portability X/Open BSD SYS V

18
graphics/pdcurs34/pdcurses/pdc_kernel.c
View File

@ -77,17 +77,17 @@
* 0 makes it disappear; 1 makes it appear "normal" (usually an
* underline) and 2 makes it "highly visible" (usually a block).
*
* ripoffline() reduces the size of stdscr by one line. If the
* "line" parameter is positive, the line is removed from the top
* of the screen; if negative, from the bottom. Up to 5 lines can
* be ripped off stdscr by calling ripoffline() repeatedly. The
* function argument, init, is called from within initscr() or
* newterm(), so ripoffline() must be called before either of these
* functions. The init function receives a pointer to a one-line
* WINDOW, and the width of the window. Calling ripoffline() with a
* ripoffline() reduces the size of stdscr by one line. If the
* "line" parameter is positive, the line is removed from the top
* of the screen; if negative, from the bottom. Up to 5 lines can
* be ripped off stdscr by calling ripoffline() repeatedly. The
* function argument, init, is called from within initscr() or
* newterm(), so ripoffline() must be called before either of these
* functions. The init function receives a pointer to a one-line
* WINDOW, and the width of the window. Calling ripoffline() with a
* NULL init function pointer is an error.
*
* napms() suspends the program for the specified number of
* napms() suspends the program for the specified number of
* milliseconds. draino() is an archaic equivalent.
*
* resetterm(), fixterm() and saveterm() are archaic equivalents

6
graphics/pdcurs34/pdcurses/pdc_keyname.c
View File

@ -48,13 +48,13 @@
* bool has_key(int key);
*
* Description:
* keyname() returns a string corresponding to the argument key.
* keyname() returns a string corresponding to the argument key.
* key may be any key returned by wgetch().
*
* key_name() is the wide-character version. It takes a wchar_t
* key_name() is the wide-character version. It takes a wchar_t
* parameter, but still returns a char *.
*
* has_key() returns true for recognized keys, false otherwise.
* has_key() returns true for recognized keys, false otherwise.
* This function is an ncurses extension.
*
* Portability X/Open BSD SYS V

32
graphics/pdcurs34/pdcurses/pdc_mouse.c
View File

@ -123,9 +123,9 @@
* reported) through 1000ms. In x11, the timeout can also be set
* via the clickPeriod resource. The return value from
* mouseinterval() is the old timeout. To check the old value
* without setting a new one, call it with a parameter of -1. Note
* that although there's no classic equivalent for this function
* (apart from the clickPeriod resource), the value set applies in
* without setting a new one, call it with a parameter of -1. Note
* that although there's no classic equivalent for this function
* (apart from the clickPeriod resource), the value set applies in
* both interfaces.
*
* wenclose() reports whether the given screen-relative y, x
@ -143,23 +143,23 @@
* mousemask() is nearly equivalent to mouse_set(), but instead of
* OK/ERR, it returns the value of the mask after setting it. (This
* isn't necessarily the same value passed in, since the mask could
* be altered on some platforms.) And if the second parameter is a
* non-null pointer, mousemask() stores the previous mask value
* there. Also, since the ncurses interface doesn't work with
* be altered on some platforms.) And if the second parameter is a
* non-null pointer, mousemask() stores the previous mask value
* there. Also, since the ncurses interface doesn't work with
* PDCurses' BUTTON_MOVED events, mousemask() filters them out.
*
* nc_getmouse() returns the current mouse status in an MEVENT
* struct. This is equivalent to ncurses' getmouse(), renamed to
* avoid conflict with PDCurses' getmouse(). But if you define
* NCURSES_MOUSE_VERSION (preferably as 2) before including
* curses.h, it defines getmouse() to nc_getmouse(), along with a
* few other redefintions needed for compatibility with ncurses
* code. nc_getmouse() calls request_mouse_pos(), which (not
* nc_getmouse() returns the current mouse status in an MEVENT
* struct. This is equivalent to ncurses' getmouse(), renamed to
* avoid conflict with PDCurses' getmouse(). But if you define
* NCURSES_MOUSE_VERSION (preferably as 2) before including
* curses.h, it defines getmouse() to nc_getmouse(), along with a
* few other redefintions needed for compatibility with ncurses
* code. nc_getmouse() calls request_mouse_pos(), which (not
* getmouse()) is the classic equivalent.
*
* ungetmouse() is the mouse equivalent of ungetch(). However,
* PDCurses doesn't maintain a queue of mouse events; only one can
* be pushed back, and it can overwrite or be overwritten by real
* ungetmouse() is the mouse equivalent of ungetch(). However,
* PDCurses doesn't maintain a queue of mouse events; only one can
* be pushed back, and it can overwrite or be overwritten by real
* mouse events.
*
* Portability X/Open BSD SYS V

22
graphics/pdcurs34/pdcurses/pdc_outopts.c
View File

@ -53,12 +53,12 @@
* int raw_output(bool bf);
*
* Description:
* With clearok(), if bf is true, the next call to wrefresh() with
* this window will clear the screen completely and redraw the
* With clearok(), if bf is true, the next call to wrefresh() with
* this window will clear the screen completely and redraw the
* entire screen.
*
* immedok(), called with a second argument of true, causes an
* automatic wrefresh() every time a change is made to the
* immedok(), called with a second argument of true, causes an
* automatic wrefresh() every time a change is made to the
* specified window.
*
* Normally, the hardware cursor is left at the location of the
@ -68,17 +68,17 @@
* the need for cursor motions. If possible, the cursor is made
* invisible when this option is enabled.
*
* wsetscrreg() sets a scrolling region in a window; "top" and
* "bot" are the line numbers for the top and bottom margins. If
* this option and scrollok() are enabled, any attempt to move off
* the bottom margin will cause all lines in the scrolling region
* wsetscrreg() sets a scrolling region in a window; "top" and
* "bot" are the line numbers for the top and bottom margins. If
* this option and scrollok() are enabled, any attempt to move off
* the bottom margin will cause all lines in the scrolling region
* to scroll up one line. setscrreg() is the stdscr version.
*
* idlok() and idcok() do nothing in PDCurses, but are provided for
* idlok() and idcok() do nothing in PDCurses, but are provided for
* compatibility with other curses implementations.
*
* raw_output() enables the output of raw characters using the
* standard *add* and *ins* curses functions (that is, it disables
* raw_output() enables the output of raw characters using the
* standard *add* and *ins* curses functions (that is, it disables
* translation of control characters).
*
* Return Value:

2
graphics/pdcurs34/pdcurses/pdc_overlay.c
View File

@ -74,7 +74,7 @@
* copywin Y - 3.0
*
*
* Thanks to Andreas Otte <venn@@uni-paderborn.de> for the
* Thanks to Andreas Otte <venn@@uni-paderborn.de> for the
* corrected overlay()/overwrite() behavior.
*/

12
graphics/pdcurs34/pdcurses/pdc_pad.c
View File

@ -63,13 +63,13 @@
* to specify the part of the pad to be displayed, and the location
* to use on the screen.
*
* newpad() creates a new pad data structure.
* newpad() creates a new pad data structure.
*
* subpad() creates a new sub-pad within a pad, at position (begy,
* begx), with dimensions of nlines lines and ncols columns. This
* position is relative to the pad, and not to the screen as with
* subwin. Changes to either the parent pad or sub-pad will affect
* both. When using sub-pads, you may need to call touchwin()
* begx), with dimensions of nlines lines and ncols columns. This
* position is relative to the pad, and not to the screen as with
* subwin. Changes to either the parent pad or sub-pad will affect
* both. When using sub-pads, you may need to call touchwin()
* before calling prefresh().
*
* pnoutrefresh() copies the specified pad to the virtual screen.
@ -78,7 +78,7 @@
*
* These routines are analogous to wnoutrefresh() and wrefresh().
* (py, px) specifies the upper left corner of the part of the pad
* to be displayed; (sy1, sx1) and (sy2, sx2) describe the screen
* to be displayed; (sy1, sx1) and (sy2, sx2) describe the screen
* rectangle that will contain the selected part of the pad.
*
* pechochar() is functionally equivalent to addch() followed by

48
graphics/pdcurs34/pdcurses/pdc_panel.c
View File

@ -77,61 +77,61 @@
* panels, fetch and set their associated windows, shuffle panels
* in the deck, and manipulate panels in other ways.
*
* bottom_panel() places pan at the bottom of the deck. The size,
* bottom_panel() places pan at the bottom of the deck. The size,
* location and contents of the panel are unchanged.
*
* del_panel() deletes pan, but not its associated winwow.
*
* hide_panel() removes a panel from the deck and thus hides it
* hide_panel() removes a panel from the deck and thus hides it
* from view.
*
* move_panel() moves the curses window associated with pan, so
* that its upper lefthand corner is at the supplied coordinates.
* move_panel() moves the curses window associated with pan, so
* that its upper lefthand corner is at the supplied coordinates.
* (Do not use mvwin() on the window.)
*
* new_panel() creates a new panel associated with win and returns
* the panel pointer. The new panel is placed at the top of the
* new_panel() creates a new panel associated with win and returns
* the panel pointer. The new panel is placed at the top of the
* deck.
*
* panel_above() returns a pointer to the panel in the deck above
* pan, or NULL if pan is the top panel. If the value of pan passed
* is NULL, this function returns a pointer to the bottom panel in
* panel_above() returns a pointer to the panel in the deck above
* pan, or NULL if pan is the top panel. If the value of pan passed
* is NULL, this function returns a pointer to the bottom panel in
* the deck.
*
* panel_below() returns a pointer to the panel in the deck below
* pan, or NULL if pan is the bottom panel. If the value of pan
* passed is NULL, this function returns a pointer to the top panel
* panel_below() returns a pointer to the panel in the deck below
* pan, or NULL if pan is the bottom panel. If the value of pan
* passed is NULL, this function returns a pointer to the top panel
* in the deck.
*
* panel_hidden() returns OK if pan is hidden and ERR if it is not.
*
* panel_userptr() - Each panel has a user pointer available for
* maintaining relevant information. This function returns a
* pointer to that information previously set up by
* panel_userptr() - Each panel has a user pointer available for
* maintaining relevant information. This function returns a
* pointer to that information previously set up by
* set_panel_userptr().
*
* panel_window() returns a pointer to the curses window associated
* panel_window() returns a pointer to the curses window associated
* with the panel.
*
* replace_panel() replaces the current window of pan with win.
*
* set_panel_userptr() - Each panel has a user pointer available
* for maintaining relevant information. This function sets the
* set_panel_userptr() - Each panel has a user pointer available
* for maintaining relevant information. This function sets the
* value of that information.
*
* show_panel() makes a previously hidden panel visible and places
* show_panel() makes a previously hidden panel visible and places
* it back in the deck on top.
*
* top_panel() places pan on the top of the deck. The size,
* top_panel() places pan on the top of the deck. The size,
* location and contents of the panel are unchanged.
*
* update_panels() refreshes the virtual screen to reflect the
* depth relationships between the panels in the deck. The user
* update_panels() refreshes the virtual screen to reflect the
* depth relationships between the panels in the deck. The user
* must use doupdate() to refresh the physical screen.
*
* Return Value:
* Each routine that returns a pointer to an object returns NULL if
* an error occurs. Each panel routine that returns an integer,
* Each routine that returns a pointer to an object returns NULL if
* an error occurs. Each panel routine that returns an integer,
* returns OK if it executes successfully and ERR if it does not.
*
* Portability X/Open BSD SYS V

8
graphics/pdcurs34/pdcurses/pdc_printw.c
View File

@ -49,13 +49,13 @@
* int vw_printw(WINDOW *win, const char *fmt, va_list varglist);
*
* Description:
* The printw() functions add a formatted string to the window at
* the current or specified cursor position. The format strings are
* the same as used in the standard C library's printf(). (printw()
* The printw() functions add a formatted string to the window at
* the current or specified cursor position. The format strings are
* the same as used in the standard C library's printf(). (printw()
* can be used as a drop-in replacement for printf().)
*
* Return Value:
* All functions return the number of characters printed, or
* All functions return the number of characters printed, or
* ERR on error.
*
* Portability X/Open BSD SYS V

36
graphics/pdcurs34/pdcurses/pdc_refresh.c
View File

@ -49,28 +49,28 @@
* int wredrawln(WINDOW *win, int beg_line, int num_lines);
*
* Description:
* wrefresh() copies the named window to the physical terminal
* screen, taking into account what is already there in order to
* optimize cursor movement. refresh() does the same, using stdscr.
* These routines must be called to get any output on the terminal,
* as other routines only manipulate data structures. Unless
* leaveok() has been enabled, the physical cursor of the terminal
* wrefresh() copies the named window to the physical terminal
* screen, taking into account what is already there in order to
* optimize cursor movement. refresh() does the same, using stdscr.
* These routines must be called to get any output on the terminal,
* as other routines only manipulate data structures. Unless
* leaveok() has been enabled, the physical cursor of the terminal
* is left at the location of the window's cursor.
*
* wnoutrefresh() and doupdate() allow multiple updates with more
* efficiency than wrefresh() alone. wrefresh() works by first
* calling wnoutrefresh(), which copies the named window to the
* virtual screen. It then calls doupdate(), which compares the
* virtual screen to the physical screen and does the actual
* update. A series of calls to wrefresh() will result in
* alternating calls to wnoutrefresh() and doupdate(), causing
* several bursts of output to the screen. By first calling
* wnoutrefresh() for each window, it is then possible to call
* wnoutrefresh() and doupdate() allow multiple updates with more
* efficiency than wrefresh() alone. wrefresh() works by first
* calling wnoutrefresh(), which copies the named window to the
* virtual screen. It then calls doupdate(), which compares the
* virtual screen to the physical screen and does the actual
* update. A series of calls to wrefresh() will result in
* alternating calls to wnoutrefresh() and doupdate(), causing
* several bursts of output to the screen. By first calling
* wnoutrefresh() for each window, it is then possible to call
* doupdate() only once.
*
* In PDCurses, redrawwin() is equivalent to touchwin(), and
* wredrawln() is the same as touchline(). In some other curses
* implementations, there's a subtle distinction, but it has no
* In PDCurses, redrawwin() is equivalent to touchwin(), and
* wredrawln() is the same as touchline(). In some other curses
* implementations, there's a subtle distinction, but it has no
* meaning in PDCurses.
*
* Return Value:

32
graphics/pdcurs34/pdcurses/pdc_scrdump.c
View File

@ -49,32 +49,32 @@
* int scr_set(const char *filename);
*
* Description:
* getwin() reads window-related data previously stored in a file
* by putwin(). It then creates and initialises a new window using
* getwin() reads window-related data previously stored in a file
* by putwin(). It then creates and initialises a new window using
* that data.
*
* putwin() writes all data associated with a window into a file,
* using an unspecified format. This information can be retrieved
* putwin() writes all data associated with a window into a file,
* using an unspecified format. This information can be retrieved
* later using getwin().
*
* scr_dump() writes the current contents of the virtual screen to
* scr_dump() writes the current contents of the virtual screen to
* the file named by filename in an unspecified format.
*
* scr_restore() function sets the virtual screen to the contents
* of the file named by filename, which must have been written
* using scr_dump(). The next refresh operation restores the screen
* scr_restore() function sets the virtual screen to the contents
* of the file named by filename, which must have been written
* using scr_dump(). The next refresh operation restores the screen
* to the way it looked in the dump file.
*
* In PDCurses, scr_init() does nothing, and scr_set() is a synonym
* for scr_restore(). Also, scr_dump() and scr_restore() save and
* load from curscr. This differs from some other implementations,
* where scr_init() works with curscr, and scr_restore() works with
* newscr; but the effect should be the same. (PDCurses has no
* In PDCurses, scr_init() does nothing, and scr_set() is a synonym
* for scr_restore(). Also, scr_dump() and scr_restore() save and
* load from curscr. This differs from some other implementations,
* where scr_init() works with curscr, and scr_restore() works with
* newscr; but the effect should be the same. (PDCurses has no
* newscr.)
*
* Return Value:
* On successful completion, getwin() returns a pointer to the
* window it created. Otherwise, it returns a null pointer. Other
* On successful completion, getwin() returns a pointer to the
* window it created. Otherwise, it returns a null pointer. Other
* functions return OK or ERR.
*
* Portability X/Open BSD SYS V
@ -99,7 +99,7 @@
* Pre-processor Defintiions
****************************************************************************/
#define DUMPVER 1 /* Should be updated whenever the WINDOW struct
#define DUMPVER 1 /* Should be updated whenever the WINDOW struct
* is changed */
/****************************************************************************

12
graphics/pdcurs34/pdcurses/pdc_scroll.c
View File

@ -46,15 +46,15 @@
* int wscrl(WINDOW *win, int n);
*
* Description:
* scroll() causes the window to scroll up one line. This involves
* scroll() causes the window to scroll up one line. This involves
* moving the lines in the window data strcture.
*
* With a positive n, scrl() and wscrl() scroll the window up n
* lines (line i + n becomes i); otherwise they scroll the window
* With a positive n, scrl() and wscrl() scroll the window up n
* lines (line i + n becomes i); otherwise they scroll the window
* down n lines.
* For these functions to work, scrolling must be enabled via
* scrollok(). Note also that scrolling is not allowed if the
* For these functions to work, scrolling must be enabled via
* scrollok(). Note also that scrolling is not allowed if the
* supplied window is a pad.
*
* Return Value:

10
graphics/pdcurs34/pdcurses/pdc_slk.c
View File

@ -66,15 +66,15 @@
* wchar_t *slk_wlabel(int labnum)
*
* Description:
* These functions manipulate a window that contain Soft Label Keys
* (SLK). To use the SLK functions, a call to slk_init() must be
* made BEFORE initscr() or newterm(). slk_init() removes 1 or 2
* These functions manipulate a window that contain Soft Label Keys
* (SLK). To use the SLK functions, a call to slk_init() must be
* made BEFORE initscr() or newterm(). slk_init() removes 1 or 2
* lines from the useable screen, depending on the format selected.
*
* The line(s) removed from the screen are used as a separate
* The line(s) removed from the screen are used as a separate
* window, in which SLKs are displayed.
*
* slk_init() requires a single parameter which describes the
* slk_init() requires a single parameter which describes the
* format of the SLKs as follows:
*
* 0 3-2-3 format

16
graphics/pdcurs34/pdcurses/pdc_termattr.c
View File

@ -57,16 +57,16 @@
* char wordchar(void);
*
* Description:
* baudrate() is supposed to return the output speed of the
* baudrate() is supposed to return the output speed of the
* terminal. In PDCurses, it simply returns INT_MAX.
*
* has_ic and has_il() return true. These functions have meaning in
* has_ic and has_il() return true. These functions have meaning in
* some other implementations of curses.
*
* erasechar() and killchar() return ^H and ^U, respectively -- the
* ERASE and KILL characters. In other curses implementations,
* these may vary by terminal type. erasewchar() and killwchar()
* are the wide-character versions; they take a pointer to a
* erasechar() and killchar() return ^H and ^U, respectively -- the
* ERASE and KILL characters. In other curses implementations,
* these may vary by terminal type. erasewchar() and killwchar()
* are the wide-character versions; they take a pointer to a
* location in which to store the character, and return OK or ERR.
*
* longname() returns a pointer to a static area containing a
@ -80,8 +80,8 @@
* termattrs() returns a logical OR of all video attributes
* supported by the terminal.
*
* wordchar() is a PDCurses extension of the concept behind the
* functions erasechar() and killchar(), returning the "delete
* wordchar() is a PDCurses extension of the concept behind the
* functions erasechar() and killchar(), returning the "delete
* word" character, ^W.
*
* Portability X/Open BSD SYS V

4
graphics/pdcurs34/pdcurses/pdc_terminfo.c
View File

@ -67,10 +67,10 @@
* int tputs(const char *, int, int (*)(int));
*
* Description:
* mvcur() lets you move the physical cursor without updating any
* mvcur() lets you move the physical cursor without updating any
* window cursor positions. It returns OK or ERR.
*
* The rest of these functions are currently implemented as stubs,
* The rest of these functions are currently implemented as stubs,
* returning the appropriate errors and doing nothing else.
*
* Portability X/Open BSD SYS V

24
graphics/pdcurs34/pdcurses/pdc_touch.c
View File

@ -49,26 +49,26 @@
* bool is_wintouched(WINDOW *win);
*
* Description:
* touchwin() and touchline() throw away all information about
* which parts of the window have been touched, pretending that the
* entire window has been drawn on. This is sometimes necessary
* when using overlapping windows, since a change to one window
* will affect the other window, but the records of which lines
* have been changed in the other window will not reflect the
* touchwin() and touchline() throw away all information about
* which parts of the window have been touched, pretending that the
* entire window has been drawn on. This is sometimes necessary
* when using overlapping windows, since a change to one window
* will affect the other window, but the records of which lines
* have been changed in the other window will not reflect the
* change.
*
* untouchwin() marks all lines in the window as unchanged since
* untouchwin() marks all lines in the window as unchanged since
* the last call to wrefresh().
*
* wtouchln() makes n lines in the window, starting at line y, look
* as if they have (changed == 1) or have not (changed == 0) been
* wtouchln() makes n lines in the window, starting at line y, look
* as if they have (changed == 1) or have not (changed == 0) been
* changed since the last call to wrefresh().
*
* is_linetouched() returns true if the specified line in the
* specified window has been changed since the last call to
* is_linetouched() returns true if the specified line in the
* specified window has been changed since the last call to
* wrefresh().
*
* is_wintouched() returns true if the specified window
* is_wintouched() returns true if the specified window
* has been changed since the last call to wrefresh().
*
* Return Value:

26
graphics/pdcurs34/pdcurses/pdc_util.c
View File

@ -58,38 +58,38 @@
* size_t PDC_wcstombs(char *dest, const wchar_t *src, size_t n);
*
* Description:
* unctrl() expands the text portion of the chtype c into a
* printable string. Control characters are changed to the "^X"
* notation; others are passed through. wunctrl() is the wide-
* unctrl() expands the text portion of the chtype c into a
* printable string. Control characters are changed to the "^X"
* notation; others are passed through. wunctrl() is the wide-
* character version of the function.
*
* filter() and use_env() are no-ops in PDCurses.
*
* delay_output() inserts an ms millisecond pause in output.
*
* getcchar() works in two modes: When wch is not NULL, it reads
* the cchar_t pointed to by wcval and stores the attributes in
* getcchar() works in two modes: When wch is not NULL, it reads
* the cchar_t pointed to by wcval and stores the attributes in
* attrs, the color pair in color_pair, and the text in the
* wide-character string wch. When wch is NULL, getcchar() merely
* returns the number of wide characters in wcval. In either mode,
* wide-character string wch. When wch is NULL, getcchar() merely
* returns the number of wide characters in wcval. In either mode,
* the opts argument is unused.
*
* setcchar constructs a cchar_t at wcval from the wide-character
* text at wch, the attributes in attr and the color pair in
* setcchar constructs a cchar_t at wcval from the wide-character
* text at wch, the attributes in attr and the color pair in
* color_pair. The opts argument is unused.
*
* Currently, the length returned by getcchar() is always 1 or 0.
* Similarly, setcchar() will only take the first wide character
* from wch, and ignore any others that it "should" take (i.e.,
* combining characters). Nor will it correctly handle any
* combining characters). Nor will it correctly handle any
* character outside the basic multilingual plane (UCS-2).
*
* Return Value:
* unctrl() and wunctrl() return NULL on failure. delay_output()
* unctrl() and wunctrl() return NULL on failure. delay_output()
* always returns OK.
*
* getcchar() returns the number of wide characters wcval points to
* when wch is NULL; when it's not, getcchar() returns OK or ERR.
* getcchar() returns the number of wide characters wcval points to
* when wch is NULL; when it's not, getcchar() returns OK or ERR.
*
* setcchar() returns OK or ERR.
*

8
graphics/pdcurs34/pdcurses/pdc_window.c
View File

@ -68,8 +68,8 @@
* LINES - begy; ncols to COLS - begx. Create a new full-screen
* window by calling newwin(0, 0, 0, 0).
*
* delwin() deletes the named window, freeing all associated
* memory. In the case of overlapping windows, subwindows should be
* delwin() deletes the named window, freeing all associated
* memory. In the case of overlapping windows, subwindows should be
* deleted before the main window.
*
* mvwin() moves the window so that the upper left-hand corner is
@ -110,12 +110,12 @@
* wsyncdown() causes a touchwin() of the current window if any of
* its parent's windows have been touched.
*
* resize_window() allows the user to resize an existing window. It
* resize_window() allows the user to resize an existing window. It
* returns the pointer to the new window, or NULL on failure.
*
* wresize() is an ncurses-compatible wrapper for resize_window().
* Note that, unlike ncurses, it will NOT process any subwindows of
* the window. (However, you still can call it _on_ subwindows.) It
* the window. (However, you still can call it _on_ subwindows.) It
* returns OK or ERR.
*
* PDC_makenew() allocates all data for a new WINDOW * except the

46
include/graphics/curses.h
View File

@ -145,8 +145,8 @@
#define BUTTON3_TRIPLE_CLICKED 0x00004000L
#define BUTTON3_MOVED 0x00004000L /* PDCurses */
/* For the ncurses-compatible functions only, BUTTON4_PRESSED and
BUTTON5_PRESSED are returned for mouse scroll wheel up and down;
/* For the ncurses-compatible functions only, BUTTON4_PRESSED and
BUTTON5_PRESSED are returned for mouse scroll wheel up and down;
otherwise PDCurses doesn't support buttons 4 and 5 */
#define BUTTON4_RELEASED 0x00008000L
@ -182,13 +182,13 @@
/* PDCurses Text Attributes
*
* Originally, PDCurses used a short (16 bits) for its chtype. To include
* color, a number of things had to be sacrificed from the strict Unix and
* System V support. The main problem was fitting all character attributes
* Originally, PDCurses used a short (16 bits) for its chtype. To include
* color, a number of things had to be sacrificed from the strict Unix and
* System V support. The main problem was fitting all character attributes
* and color into an unsigned char (all 8 bits!).
*
* Today, PDCurses by default uses a long (32 bits) for its chtype, as in
* System V. The short chtype is still available, by undefining CHTYPE_LONG
* Today, PDCurses by default uses a long (32 bits) for its chtype, as in
* System V. The short chtype is still available, by undefining CHTYPE_LONG
* and rebuilding the library.
*
* The following is the structure of a win->_attrs chtype:
@ -200,20 +200,20 @@
* -------------------------------------------------
* color number | attrs | character eg 'a'
*
* The available non-color attributes are bold, reverse and blink. Others
* have no effect. The high order char is an index into an array of
* physical colors (defined in color.c) -- 32 foreground/background color
* The available non-color attributes are bold, reverse and blink. Others
* have no effect. The high order char is an index into an array of
* physical colors (defined in color.c) -- 32 foreground/background color
* pairs (5 bits) plus 3 bits for other attributes.
*
* long form:
*
*
* ----------------------------------------------------------------------------
* |31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|..| 3| 2| 1| 0|
* ----------------------------------------------------------------------------
* color number | modifiers | character eg 'a'
*
* The available non-color attributes are bold, underline, invisible,
* right-line, left-line, protect, reverse and blink. 256 color pairs (8
* The available non-color attributes are bold, underline, invisible,
* right-line, left-line, protect, reverse and blink. 256 color pairs (8
* bits), 8 bits for other attributes, and 16 bits for character data.
*/
@ -269,7 +269,7 @@
#define ATR_MSK A_ATTRIBUTES /* Obsolete */
#define ATR_NRM A_NORMAL /* Obsolete */
/* For use with attr_t -- X/Open says, "these shall be distinct", so
/* For use with attr_t -- X/Open says, "these shall be distinct", so
* this is a non-conforming implementation.
*/
@ -293,7 +293,7 @@
/* Alternate character set macros
*
* 'w' = 32-bit chtype; acs_map[] index | A_ALTCHARSET
* 'n' = 16-bit chtype; it gets the fallback set because no bit is
* 'n' = 16-bit chtype; it gets the fallback set because no bit is
* available for A_ALTCHARSET
*/
@ -804,7 +804,7 @@ typedef struct _win /* definition of a window */
struct _win *_parent; /* subwin's pointer to parent win */
} WINDOW;
/* Avoid using the SCREEN struct directly -- use the corresponding
/* Avoid using the SCREEN struct directly -- use the corresponding
* functions if possible. This struct may eventually be made private.
*/
@ -831,12 +831,12 @@ typedef struct
unsigned long _trap_mbe; /* trap these mouse button events */
unsigned long _map_mbe_to_key; /* map mouse buttons to slk */
int mouse_wait; /* time to wait (in ms) for a
* button release after a press, in
* button release after a press, in
* order to count it as a click */
int slklines; /* lines in use by slk_init() */
WINDOW *slk_winptr; /* window for slk */
int linesrippedoff; /* lines ripped off via ripoffline() */
int linesrippedoffontop; /* lines ripped off on
int linesrippedoffontop; /* lines ripped off on
* top via ripoffline() */
int delaytenths; /* 1/10ths second to wait block
* getch() for */
@ -894,7 +894,7 @@ void bkgdset(chtype);
int border(chtype, chtype, chtype, chtype, chtype, chtype, chtype, chtype);
int box(WINDOW *, chtype, chtype);
bool can_change_color(void);
int cbreak(void);
int cbreak(void);
int chgat(int, attr_t, short, const void *);
int clearok(WINDOW *, bool);
int clear(void);
@ -909,7 +909,7 @@ int def_shell_mode(void);
int delay_output(int);
int delch(void);
int deleteln(void);
void delscreen(SCREEN *);
void delscreen(SCREEN *);
int delwin(WINDOW *);
WINDOW *derwin(WINDOW *, int, int, int, int);
int doupdate(void);
@ -1147,8 +1147,8 @@ int addwstr(const wchar_t *);
int add_wch(const cchar_t *);
int add_wchnstr(const cchar_t *, int);
int add_wchstr(const cchar_t *);
int border_set(const cchar_t *, const cchar_t *, const cchar_t *,
const cchar_t *, const cchar_t *, const cchar_t *,
int border_set(const cchar_t *, const cchar_t *, const cchar_t *,
const cchar_t *, const cchar_t *, const cchar_t *,
const cchar_t *, const cchar_t *);
int box_set(WINDOW *, const cchar_t *, const cchar_t *);
int echo_wchar(const cchar_t *);
@ -1218,7 +1218,7 @@ int wadd_wchstr(WINDOW *, const cchar_t *);
int wbkgrnd(WINDOW *, const cchar_t *);
void wbkgrndset(WINDOW *, const cchar_t *);
int wborder_set(WINDOW *, const cchar_t *, const cchar_t *,
const cchar_t *, const cchar_t *, const cchar_t *,
const cchar_t *, const cchar_t *, const cchar_t *,
const cchar_t *, const cchar_t *, const cchar_t *);
int wecho_wchar(WINDOW *, const cchar_t *);
int wgetbkgrnd(WINDOW *, cchar_t *);