- The border, wborder and box routines draw a box around the
- edges of a window. Other than the window, each argument
- is a character with attributes:
+ The border, wborder and box routines draw a box around the edges of a
+ window. Other than the window, each argument is a character with at-
+ tributes:
ls - left side,
rs - right side,
@@ -83,8 +84,8 @@
bl - bottom left-hand corner, and
br - bottom right-hand corner.
- If any of these arguments is zero, then the corresponding
- default values (defined in curses.h) are used instead:
+ If any of these arguments is zero, then the corresponding default val-
+ ues (defined in curses.h) are used instead:
ACS_VLINE,
ACS_VLINE,
@@ -95,48 +96,43 @@
ACS_LLCORNER,
ACS_LRCORNER.
- box(win,verch,horch) is a shorthand for the following
- call: wborder(win,verch,verch,horch,horch,0,0,0,
- 0).
+ box(win,verch,horch) is a shorthand for the following call: wbor-
+ der(win,verch,verch,horch,horch,0,0,0,0).
- The hline and whline functions draw a horizontal (left to
- right) line using ch starting at the current cursor posi-
- tion in the window. The current cursor position is not
- changed. The line is at most n characters long, or as
- many as fit into the window.
+ The hline and whline functions draw a horizontal (left to right) line
+ using ch starting at the current cursor position in the window. The
+ current cursor position is not changed. The line is at most n charac-
+ ters long, or as many as fit into the window.
- The vline and wvline functions draw a vertical (top to
- bottom) line using ch starting at the current cursor posi-
- tion in the window. The current cursor position is not
- changed. The line is at most n characters long, or as
- many as fit into the window.
+ The vline and wvline functions draw a vertical (top to bottom) line us-
+ ing ch starting at the current cursor position in the window. The cur-
+ rent cursor position is not changed. The line is at most n characters
+ long, or as many as fit into the window.
- All routines return the integer OK. The SVr4.0 manual
- says "or a non-negative integer if immedok is set", but
- this appears to be an error.
+ All routines return the integer OK. The SVr4.0 manual says "or a non-
+ negative integer if immedok is set", but this appears to be an error.
- X/Open does not define any error conditions. This imple-
- mentation returns an error if the window pointer is null.
+ X/Open does not define any error conditions. This implementation re-
+ turns an error if the window pointer is null.
- Functions with a "mv" prefix first perform a cursor move-
- ment using wmove, and return an error if the position is
- outside the window, or if the window pointer is null.
+ Functions with a "mv" prefix first perform a cursor movement using
+ wmove, and return an error if the position is outside the window, or if
+ the window pointer is null.
- The borders generated by these functions are inside bor-
- ders (this is also true of SVr4 curses, though the fact is
- not documented).
+ The borders generated by these functions are inside borders (this is
+ also true of SVr4 curses, though the fact is not documented).
Note that border and box may be macros.
- These functions are described in the XSI Curses standard,
- Issue 4. The standard specifies that they return ERR on
- failure, but specifies no error conditions.
+ These functions are described in the XSI Curses standard, Issue 4. The
+ standard specifies that they return ERR on failure, but specifies no
+ error conditions.