X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_deleteln.3x;h=91415ac8a764ff34fc563d142b0c19da32974c70;hp=6a340b157109f6af8460eb27b87cce5e0cc374e8;hb=6b99a559185b3b8fad80b56bc2070b08101c33d1;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8 diff --git a/man/curs_deleteln.3x b/man/curs_deleteln.3x index 6a340b15..91415ac8 100644 --- a/man/curs_deleteln.3x +++ b/man/curs_deleteln.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2003,2005 Free Software Foundation, Inc. * +.\" Copyright (c) 1998-2010,2018 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -26,7 +26,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_deleteln.3x,v 1.9 2005/05/15 16:53:35 tom Exp $ +.\" $Id: curs_deleteln.3x,v 1.14 2018/07/28 21:34:06 tom Exp $ .TH curs_deleteln 3X "" .SH NAME \fBdeleteln\fR, @@ -34,10 +34,10 @@ \fBinsdelln\fR, \fBwinsdelln\fR, \fBinsertln\fR, -\fBwinsertln\fR - delete and insert lines in a \fBcurses\fR window +\fBwinsertln\fR \- delete and insert lines in a \fBcurses\fR window .SH SYNOPSIS \fB#include \fR - +.sp \fBint deleteln(void);\fR .br \fBint wdeleteln(WINDOW *win);\fR @@ -53,14 +53,19 @@ .SH DESCRIPTION The \fBdeleteln\fR and \fBwdeleteln\fR routines delete the line under the cursor in the window; all lines below the current line are moved up one line. -The bottom line of the window is cleared. The cursor position does not change. - +The bottom line of the window is cleared. +The cursor position does not change. +.PP The \fBinsdelln\fR and \fBwinsdelln\fR routines, for positive \fIn\fR, insert -\fIn\fR lines into the specified window above the current line. The \fIn\fR -bottom lines are lost. For negative \fIn\fR, delete \fIn\fR lines (starting -with the one under the cursor), and move the remaining lines up. The bottom -\fIn\fR lines are cleared. The current cursor position remains the same. - +\fIn\fR lines into the specified window above the current line. +The \fIn\fR +bottom lines are lost. +For negative \fIn\fR, delete \fIn\fR lines (starting +with the one under the cursor), and move the remaining lines up. +The bottom +\fIn\fR lines are cleared. +The current cursor position remains the same. +.PP The \fBinsertln\fR and \fBwinsertln\fR routines insert a blank line above the current line and the bottom line is lost. .SH RETURN VALUE @@ -72,20 +77,16 @@ X/Open defines no error conditions. In this implementation, if the window parameter is null, an error is returned. .SH PORTABILITY -These functions are described in the XSI Curses standard, Issue 4. The +These functions are described in the XSI Curses standard, Issue 4. +The standard specifies that they return \fBERR\fR on failure, but specifies no error conditions. .SH NOTES Note that all but \fBwinsdelln\fR may be macros. - +.PP These routines do not require a hardware line delete or insert feature in the -terminal. In fact, they won't use hardware line delete/insert unless +terminal. +In fact, they will not use hardware line delete/insert unless \fBidlok(..., TRUE)\fR has been set on the current window. .SH SEE ALSO \fBcurses\fR(3X) -.\"# -.\"# The following sets edit modes for GNU EMACS -.\"# Local Variables: -.\"# mode:nroff -.\"# fill-column:79 -.\"# End: