Module Name: src
Committed By: uwe
Date: Tue Oct 27 23:13:18 UTC 2015
Modified Files:
src/lib/libpanel: Makefile
Added Files:
src/lib/libpanel: panel.3
Log Message:
Manual page for libpanel.
To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 src/lib/libpanel/Makefile
cvs rdiff -u -r0 -r1.1 src/lib/libpanel/panel.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libpanel/Makefile
diff -u src/lib/libpanel/Makefile:1.1 src/lib/libpanel/Makefile:1.2
--- src/lib/libpanel/Makefile:1.1 Mon Oct 26 23:09:49 2015
+++ src/lib/libpanel/Makefile Tue Oct 27 23:13:18 2015
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.1 2015/10/26 23:09:49 uwe Exp $
+# $NetBSD: Makefile,v 1.2 2015/10/27 23:13:18 uwe Exp $
WARNS= 4
@@ -28,4 +28,6 @@ SRCS+= window.c
#LIBDPLIBS+= curses ${.CURDIR}/../libcurses
+MAN= panel.3
+
.include <bsd.lib.mk>
Added files:
Index: src/lib/libpanel/panel.3
diff -u /dev/null src/lib/libpanel/panel.3:1.1
--- /dev/null Tue Oct 27 23:13:18 2015
+++ src/lib/libpanel/panel.3 Tue Oct 27 23:13:18 2015
@@ -0,0 +1,73 @@
+.\" $NetBSD: panel.3,v 1.1 2015/10/27 23:13:18 uwe Exp $
+.\"
+.\" Copyright (c) 2015 Valery Ushakov
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd October 28, 2015
+.Dt PANEL 3
+.Os
+.Sh NAME
+.Nm panel
+.Nd z-order for curses windows
+.Sh LIBRARY
+.Lb libpanel
+.Sh SYNOPSIS
+.In panel.h
+.Sh DESCRIPTION
+Overlapping curses windows have no notion of z-order,
+what you see on the screen depends on the order of updates.
+.Nm
+library is an extension built on top of
+.Xr curses(3)
+that adds z-order to curses windows.
+.Pp
+Each panel has an associated curses window.
+All currently visible panels form a
+.Dq deck .
+Panels have z-order only relative to other panels in the deck and to
+.Xr stdscr(3) .
+The latter doesn't have a panel of its own but implicitly lies below
+all other panels in the deck.
+If you mix plain curses windows and panels the visual results are
+undefined since panel library is not aware of windows that are not
+associated with panels.
+.Bl -column ".Xr set_panel_userptr 3"
+.It Sy "Function" Ta Sy "Summary"
+.It Xr bottom_panel 3 Ta move the panel to the bottom of the deck
+.It Xr del_panel 3 Ta delete the panel
+.It Xr hide_panel 3 Ta hide the panel, removing it from deck
+.It Xr move_panel 3 Ta move the panel to a new position on screen
+.It Xr new_panel 3 Ta create new panel
+.It Xr panel_above 3 Ta a panel above the given panel
+.It Xr panel_below 3 Ta a panel below the given panel
+.It Xr panel_hidden 3 Ta check if the panel is hidden
+.It Xr panel_userptr 3 Ta user data associated with the panel
+.It Xr panel_window 3 Ta curses window associated with the panel
+.It Xr replace_panel 3 Ta associate a different window with the panel
+.It Xr set_panel_userptr 3 Ta associate arbitrary user data with the panel
+.It Xr show_panel 3 Ta show hidden panel at the top of the deck
+.It Xr top_panel 3 Ta move the panel to the top of the deck
+.It Xr update_panels 3 Ta update terminal display
+.El
+.Sh SEE ALSO
+.Xr curses(3)
