diff --git a/lib/libcurses/PSD.doc/Master b/lib/libcurses/PSD.doc/Master index d9e717106c31..12db62b9bfaf 100644 --- a/lib/libcurses/PSD.doc/Master +++ b/lib/libcurses/PSD.doc/Master @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)Master 8.1 (Berkeley) 6/8/93 +.\" @(#)Master 8.2 (Berkeley) 5/24/94 .\" .ds Ln Screen Package .so macros @@ -46,8 +46,8 @@ .bp .so appen.A .pn 2 -.oh '\*(Ln''PS1:19-%' -.eh 'PS1:19-%''\*(Ln' +.oh '\*(Ln''PSD:19-%' +.eh 'PSD:19-%''\*(Ln' .bp .bi Contents .sp diff --git a/lib/libcurses/PSD.doc/appenA b/lib/libcurses/PSD.doc/appenA new file mode 100644 index 000000000000..a40c95d7891c --- /dev/null +++ b/lib/libcurses/PSD.doc/appenA @@ -0,0 +1,77 @@ +.\" Copyright (c) 1980, 1993 +.\" The Regents of the University of California. 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. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``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 REGENTS OR CONTRIBUTORS 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. +.\" +.\" @(#)appen.A 8.1 (Berkeley) 6/8/93 +.\" +.ie t .oh '\*(Ln Appendix A''PS1:19-%' +.eh 'PS1:19-%''\*(Ln Appendix A' +.el .he ''\fIAppendix A\fR'' +.bp +.(x +.ti 0 +.b "Appendix A" +.)x +.sh 1 "Examples" 1 +.pp +Here we present a few examples +of how to use the package. +They attempt to be representative, +though not comprehensive. Further examples can be found in the games section +of the source tree and in various utilities that use the screen such as +.i systat(1) . +.pp +The following examples are intended to demonstrate +the basic structure of a program +using the package. An additional, more comprehensive, program can be found in +the source code in the +\fIexamples\fP subdirectory. +.sh 2 "Simple Character Output" +.pp +This program demonstrates how to set up a window and output characters to it. +Also, it demonstrates how one might control the output to the window. If +you run this program, you will get a demonstration of the character output +chracteristics discussed in the above Character Output section. +.(l I +.so ex1.gr +.)l +.sh 2 "Twinkle" +.pp +This is a moderately simple program which prints +patterns on the screen. +It switches between patterns of asterisks, +putting them on one by one in random order, +and then taking them off in the same fashion. +It is more efficient to write this +using only the motion optimization, +as is demonstrated below. +.(l I +.so twinkle1.gr +.)l diff --git a/lib/libcurses/PSD.doc/fns.doc b/lib/libcurses/PSD.doc/fns.doc index 30d5c4c971df..0fa89abd3f74 100644 --- a/lib/libcurses/PSD.doc/fns.doc +++ b/lib/libcurses/PSD.doc/fns.doc @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" @(#)fns.doc 8.1 (Berkeley) 6/4/93 +.\" @(#)fns.doc 8.2 (Berkeley) 6/1/94 .\" .Ds .Fn addch "char ch" \(dg @@ -307,6 +307,7 @@ This will eventually signal to .Fn refresh that it is all right to use the insert and delete line sequences when updating the window. +.ne 1i .Ds .Fn inch "" \(dg .De @@ -514,6 +515,7 @@ Turn echoing of characters off. .De Unset the terminal to from nl mode. See .Fn nl . +.ne 1i .Ds .Fn noraw "" \(dg .De @@ -635,6 +637,7 @@ It does this using consecutive calls to (or .Fn wgetch ). \*(Es +.ne 1i .Ds .Fn scroll "WINDOW *win" .De @@ -744,6 +747,7 @@ Characters are 8 bits long. .De Returns the length of the ASCII representation of .Vn ch . +.ne 1i .Ds .Fn vwprintw "WINDOW *win" "const char *fmt" "va_list ap" .De