SCCS-vsn: lib/libcurses/PSD.doc/fns.doc 1.4
.\"
.\" %sccs.include.redist.roff%
.\"
.\"
.\" %sccs.include.redist.roff%
.\"
-.\" @(#)fns.doc 1.3 (Berkeley) %G%
+.\" @(#)fns.doc 1.4 (Berkeley) %G%
.\"
.Ds
.Fn addch "char ch" \(dg
.\"
.Ds
.Fn addch "char ch" \(dg
this will force a clear-screen to be printed on the next
.Fn refresh ,
or stop it from doing so if
.Vn boolf
this will force a clear-screen to be printed on the next
.Fn refresh ,
or stop it from doing so if
.Vn boolf
This only works on screens,
and,
unlike
This only works on screens,
and,
unlike
allows you to control this.
if
.Vn boolf
allows you to control this.
if
.Vn boolf
(\c
.i i.e. ,
non-zero)
it will do the
(\c
.i i.e. ,
non-zero)
it will do the
-.Fn fflush ;
-if it is FALSE.
-it will not.
+.Fn fflush ,
+otherwise it will not.
.Ds
.Fn getch "" \(dg
.De
.Ds
.Fn getch "" \(dg
.De
it sets the specifications to the terminal
whose name is pointed to by
.Vn Def\*_term
it sets the specifications to the terminal
whose name is pointed to by
.Vn Def\*_term
If the boolean
.Vn My\*_term
If the boolean
.Vn My\*_term
.Vn Def\*_term
is always used.
If the system supports the
.b TIOCGWINSZ
.Vn Def\*_term
is always used.
If the system supports the
.b TIOCGWINSZ
call,
it is used to get the number of lines and columns for the terminal,
otherwise it is taken from the
call,
it is used to get the number of lines and columns for the terminal,
otherwise it is taken from the
Sets the boolean flag for leaving the cursor after the last change.
If
.Vn boolf
Sets the boolean flag for leaving the cursor after the last change.
If
.Vn boolf
the cursor will be left after the last update on the terminal,
and the current \*y for
.Vn win
will be changed accordingly.
the cursor will be left after the last update on the terminal,
and the current \*y for
.Vn win
will be changed accordingly.
-If it is FALSE,
-it will be moved to the current \*y.
+If
+.Vn boolf
+ is 0 the cursor will be moved to the current \*y.
retains its value until changed by the user.
.Ds
.Fn move "int y" "int x"
retains its value until changed by the user.
.Ds
.Fn move "int y" "int x"
.Vn win1
leave the contents of the space on
.Vn win2
.Vn win1
leave the contents of the space on
.Vn win2
+untouched. Note that all non-blank characters are overwritten
+destructively in the overlay.
.Ds
.Fn overwrite "WINDOW *win1" "WINDOW *win2"
.De
.Ds
.Fn overwrite "WINDOW *win1" "WINDOW *win2"
.De
Set the scroll flag for the given window.
If
.Vn boolf
Set the scroll flag for the given window.
If
.Vn boolf
-is FALSE, scrolling is not allowed.
+is 0, scrolling is not allowed.
This is its default setting.
.Ds
.Fn standend "" \(dg
This is its default setting.
.Ds
.Fn standend "" \(dg
and then calls
.Fn wrefresh "curscr"
to redraw the screen.
and then calls
.Fn wrefresh "curscr"
to redraw the screen.
sets the signal
SIGTSTP
to trap to this routine.
sets the signal
SIGTSTP
to trap to this routine.