ncurses 6.3 - patch 20211225

[ncurses.git] / man / curs_border_set.3x

diff --git a/man/curs_border_set.3x b/man/curs_border_set.3x
index b156b77dab95a7f2153f724ff03a26edf876d373..9d52ca5a1d7ba5c16412f5a8dcf1718b6b34ce13 100644 (file)
--- a/man/curs_border_set.3x
+++ b/man/curs_border_set.3x
@@ -1,5 +1,5 @@
 .\"***************************************************************************
 .\"***************************************************************************

-.\" Copyright 2019,2020 Thomas E. Dickey                                     *
+.\" Copyright 2019-2020,2021 Thomas E. Dickey                                *

 .\" Copyright 2002-2011,2012 Free Software Foundation, Inc.                  *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" Copyright 2002-2011,2012 Free Software Foundation, Inc.                  *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *


@@ -27,7 +27,7 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"

-.\" $Id: curs_border_set.3x,v 1.13 2020/02/02 23:34:34 tom Exp $
+.\" $Id: curs_border_set.3x,v 1.15 2021/12/25 21:41:58 tom Exp $

 .TH curs_border_set 3X ""
 .ie \n(.g .ds `` \(lq
 .el       .ds `` ``
 .TH curs_border_set 3X ""
 .ie \n(.g .ds `` \(lq
 .el       .ds `` ``


@@ -36,168 +36,168 @@
 .na
 .hy 0
 .SH NAME
 .na
 .hy 0
 .SH NAME

-\fBborder_set\fR,
-\fBwborder_set\fR,
-\fBbox_set\fR,
-\fBhline_set\fR,
-\fBwhline_set\fR,
-\fBmvhline_set\fR,
-\fBmvwhline_set\fR,
-\fBvline_set\fR,
-\fBwvline_set\fR,
-\fBmvvline_set\fR,
-\fBmvwvline_set\fR \- create \fBcurses\fR borders or lines using complex characters and renditions
+\fBborder_set\fP,
+\fBwborder_set\fP,
+\fBbox_set\fP,
+\fBhline_set\fP,
+\fBwhline_set\fP,
+\fBmvhline_set\fP,
+\fBmvwhline_set\fP,
+\fBvline_set\fP,
+\fBwvline_set\fP,
+\fBmvvline_set\fP,
+\fBmvwvline_set\fP \- create \fBcurses\fP borders or lines using complex characters and renditions

 .ad
 .hy
 .SH SYNOPSIS
 .PP
 .ad
 .hy
 .SH SYNOPSIS
 .PP

-\fB#include <curses.h>\fR
+\fB#include <curses.h>\fP

 .sp
 .sp

-\fBint border_set(\fR
-   \fBconst cchar_t *\fR\fIls\fR, \fBconst cchar_t *\fR\fIrs\fR,
-   \fBconst cchar_t *\fR\fIts\fR, \fBconst cchar_t *\fR\fIbs\fR,
-   \fBconst cchar_t *\fR\fItl\fR, \fBconst cchar_t *\fR\fItr\fR,
-   \fBconst cchar_t *\fR\fIbl\fR, \fBconst cchar_t *\fR\fIbr\fR
-\fB);\fR
-.br
-\fBint wborder_set(\fR
-   \fBWINDOW *win\fR,
-   \fBconst cchar_t *\fR\fIls\fR, \fBconst cchar_t *\fR\fIrs\fR,
-   \fBconst cchar_t *\fR\fIts\fR, \fBconst cchar_t *\fR\fIbs\fR,
-   \fBconst cchar_t *\fR\fItl\fR, \fBconst cchar_t *\fR\fItr\fR,
-   \fBconst cchar_t *\fR\fIbl\fR, \fBconst cchar_t *\fR\fIbr\fR\fB);\fR
-.br
-\fBint box_set(\fR
-   \fBWINDOW *win\fR,
-   \fBconst cchar_t *\fR\fIverch\fR,
-   \fBconst cchar_t *\fR\fIhorch\fR\fB);\fR
-.br
-\fBint hline_set(\fR
-   \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR
-.br
-\fBint whline_set(\fR
-   \fBWINDOW *\fR\fIwin\fR,
-   \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR
-.br
-\fBint mvhline_set(\fR
-   \fBint \fR\fIy\fR, \fBint \fR\fIx\fR,
-   \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR
-.br
-\fBint mvwhline_set(\fR
-   \fBWINDOW *\fR\fIwin\fR,
-   \fBint \fR\fIy\fR, \fBint \fR\fIx\fR,
-   \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR
-.br
-\fBint vline_set(\fR
-   \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR
-.br
-\fBint wvline_set(\fR
-   \fBWINDOW *\fR\fIwin\fR,
-   \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR
-.br
-\fBint mvvline_set(\fR
-   \fBint \fR\fIy\fR, \fBint \fR\fIx\fR,
-   \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR
-.br
-\fBint mvwvline_set(\fR
-   \fBWINDOW *\fR\fIwin\fR,
-   \fBint \fR\fIy\fR, \fBint \fR\fIx\fR,
-   \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR
+\fBint border_set(\fP
+   \fBconst cchar_t *\fP\fIls\fP, \fBconst cchar_t *\fP\fIrs\fP,
+   \fBconst cchar_t *\fP\fIts\fP, \fBconst cchar_t *\fP\fIbs\fP,
+   \fBconst cchar_t *\fP\fItl\fP, \fBconst cchar_t *\fP\fItr\fP,
+   \fBconst cchar_t *\fP\fIbl\fP, \fBconst cchar_t *\fP\fIbr\fP
+\fB);\fP
+.br
+\fBint wborder_set(\fP
+   \fBWINDOW *win\fP,
+   \fBconst cchar_t *\fP\fIls\fP, \fBconst cchar_t *\fP\fIrs\fP,
+   \fBconst cchar_t *\fP\fIts\fP, \fBconst cchar_t *\fP\fIbs\fP,
+   \fBconst cchar_t *\fP\fItl\fP, \fBconst cchar_t *\fP\fItr\fP,
+   \fBconst cchar_t *\fP\fIbl\fP, \fBconst cchar_t *\fP\fIbr\fP\fB);\fP
+.br
+\fBint box_set(\fP
+   \fBWINDOW *win\fP,
+   \fBconst cchar_t *\fP\fIverch\fP,
+   \fBconst cchar_t *\fP\fIhorch\fP\fB);\fP
+.br
+\fBint hline_set(\fP
+   \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP
+.br
+\fBint whline_set(\fP
+   \fBWINDOW *\fP\fIwin\fP,
+   \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP
+.br
+\fBint mvhline_set(\fP
+   \fBint \fP\fIy\fP, \fBint \fP\fIx\fP,
+   \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP
+.br
+\fBint mvwhline_set(\fP
+   \fBWINDOW *\fP\fIwin\fP,
+   \fBint \fP\fIy\fP, \fBint \fP\fIx\fP,
+   \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP
+.br
+\fBint vline_set(\fP
+   \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP
+.br
+\fBint wvline_set(\fP
+   \fBWINDOW *\fP\fIwin\fP,
+   \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP
+.br
+\fBint mvvline_set(\fP
+   \fBint \fP\fIy\fP, \fBint \fP\fIx\fP,
+   \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP
+.br
+\fBint mvwvline_set(\fP
+   \fBWINDOW *\fP\fIwin\fP,
+   \fBint \fP\fIy\fP, \fBint \fP\fIx\fP,
+   \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP

 .br
 .SH DESCRIPTION
 .PP
 The
 .br
 .SH DESCRIPTION
 .PP
 The

-\fBborder_set\fR
+\fBborder_set\fP

 and
 and

-\fBwborder_set\fR
+\fBwborder_set\fP

 functions draw a border around the edges of the current or specified window.
 These functions do not change the cursor position, and do not wrap.
 .PP
 Other than the window, each argument is a complex character with attributes:
 .RS
 functions draw a border around the edges of the current or specified window.
 These functions do not change the cursor position, and do not wrap.
 .PP
 Other than the window, each argument is a complex character with attributes:
 .RS

-\fIls\fR \- left side,
+\fIls\fP \- left side,

 .br
 .br

-\fIrs\fR \- right side,
+\fIrs\fP \- right side,

 .br
 .br

-\fIts\fR \- top side,
+\fIts\fP \- top side,

 .br
 .br

-\fIbs\fR \- bottom side,
+\fIbs\fP \- bottom side,

 .br
 .br

-\fItl\fR \- top left-hand corner,
+\fItl\fP \- top left-hand corner,

 .br
 .br

-\fItr\fR \- top right-hand corner,
+\fItr\fP \- top right-hand corner,

 .br
 .br

-\fIbl\fR \- bottom left-hand corner, and
+\fIbl\fP \- bottom left-hand corner, and

 .br
 .br

-\fIbr\fR \- bottom right-hand corner.
+\fIbr\fP \- bottom right-hand corner.

 .RE
 .PP
 If any of these arguments is zero, then the corresponding
 .RE
 .PP
 If any of these arguments is zero, then the corresponding

-default values (defined in \fBcurses.h\fR) are used instead:
+default values (defined in \fBcurses.h\fP) are used instead:

 .RS
 .RS

-\fBWACS_VLINE\fR,
+\fBWACS_VLINE\fP,

 .br
 .br

-\fBWACS_VLINE\fR,
+\fBWACS_VLINE\fP,

 .br
 .br

-\fBWACS_HLINE\fR,
+\fBWACS_HLINE\fP,

 .br
 .br

-\fBWACS_HLINE\fR,
+\fBWACS_HLINE\fP,

 .br
 .br

-\fBWACS_ULCORNER\fR,
+\fBWACS_ULCORNER\fP,

 .br
 .br

-\fBWACS_URCORNER\fR,
+\fBWACS_URCORNER\fP,

 .br
 .br

-\fBWACS_LLCORNER\fR, and
+\fBWACS_LLCORNER\fP, and

 .br
 .br

-\fBWACS_LRCORNER\fR.
+\fBWACS_LRCORNER\fP.

 .RE
 .PP
 .RE
 .PP

-\fBbox_set(\fR\fIwin\fR, \fIverch\fR\fB, \fR\fIhorch\fR\fB);\fR
+\fBbox_set(\fP\fIwin\fP, \fIverch\fP\fB, \fP\fIhorch\fP\fB);\fP

 is a shorthand for the following call:
 .PP
 is a shorthand for the following call:
 .PP

-\fBwborder_set(\fR\fIwin\fR\fB, \fR\fIverch\fR\fB, \fR\fIverch\fR\fB,\fR
-    \fIhorch\fR\fB, \fR\fIhorch\fR\fB, NULL, NULL, NULL, NULL);\fR
+\fBwborder_set(\fP\fIwin\fP\fB, \fP\fIverch\fP\fB, \fP\fIverch\fP\fB,\fP
+    \fIhorch\fP\fB, \fP\fIhorch\fP\fB, NULL, NULL, NULL, NULL);\fP

 .PP
 The
 .PP
 The

-\fB*line_set\fR
+\fB*line_set\fP

 functions use
 functions use

-\fIwch\fR
+\fIwch\fP

 to draw a line starting at the current cursor position in the window.
 to draw a line starting at the current cursor position in the window.

-The line is at most \fIn\fR characters long or as many as fit into the window.
+The line is at most \fIn\fP characters long or as many as fit into the window.

 The current cursor position is not changed.
 .PP
 The
 The current cursor position is not changed.
 .PP
 The

-\fBhline_set\fR,
-\fBmvhline_set\fR,
-\fBmvwhline_set\fR, and
-\fBwhline_set\fR
+\fBhline_set\fP,
+\fBmvhline_set\fP,
+\fBmvwhline_set\fP, and
+\fBwhline_set\fP

 functions draw a line proceeding toward the last column of the same line.
 .PP
 The
 functions draw a line proceeding toward the last column of the same line.
 .PP
 The

-\fBvline_set\fR,
-\fBmvvline_set\fR,
-\fBmvwvline_set\fR, and
-\fBwvline_set\fR
+\fBvline_set\fP,
+\fBmvvline_set\fP,
+\fBmvwvline_set\fP, and
+\fBwvline_set\fP

 functions draw a line proceeding toward the last line of the window.
 .br
 .SH NOTES
 .PP
 Note that
 functions draw a line proceeding toward the last line of the window.
 .br
 .SH NOTES
 .PP
 Note that

-\fBborder_set\fR,
-\fBhline_set\fR,
-\fBmvhline_set\fR,
-\fBmvvline_set\fR,
-\fBmvwhline_set\fR,
-\fBmvwvline_set\fR, and
-\fBvline_set\fR
+\fBborder_set\fP,
+\fBhline_set\fP,
+\fBmvhline_set\fP,
+\fBmvvline_set\fP,
+\fBmvwhline_set\fP,
+\fBmvwvline_set\fP, and
+\fBvline_set\fP

 may be macros.
 .br
 .SH RETURN VALUE
 .PP
 Upon successful completion, these functions return
 may be macros.
 .br
 .SH RETURN VALUE
 .PP
 Upon successful completion, these functions return

-\fBOK\fR.
+\fBOK\fP.

 Otherwise, they return
 Otherwise, they return

-\fBERR\fR.
+\fBERR\fP.

 .PP
 Functions using a window parameter return an error if it is null.
 .PP
 .PP
 Functions using a window parameter return an error if it is null.
 .PP


@@ -205,7 +205,7 @@ Functions with a \*(``mv\*('' prefix first perform a cursor movement using
 \fBwmove\fP, and return an error if the position is outside the window,
 or if the window pointer is null.
 .SH SEE ALSO
 \fBwmove\fP, and return an error if the position is outside the window,
 or if the window pointer is null.
 .SH SEE ALSO

-\fBncurses\fR(3X),
-\fBcurs_add_wch\fR(3X),
-\fBcurs_border\fR(3X),
-\fBcurs_outopts\fR(3X)
+\fBncurses\fP(3X),
+\fBcurs_add_wch\fP(3X),
+\fBcurs_border\fP(3X),
+\fBcurs_outopts\fP(3X)