Return to doc.II CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / doc / ps1 / 18.curses

Annotation of 43BSDReno/share/doc/ps1/18.curses/doc.II, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1980 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted
        !             5: .\" provided that the above copyright notice and this paragraph are
        !             6: .\" duplicated in all such forms and that any documentation,
        !             7: .\" advertising materials, and other materials related to such
        !             8: .\" distribution and use acknowledge that the software was developed
        !             9: .\" by the University of California, Berkeley.  The name of the
        !            10: .\" University may not be used to endorse or promote products derived
        !            11: .\" from this software without specific prior written permission.
        !            12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
        !            13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
        !            14: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            15: .\"
        !            16: .\"    @(#)doc.II      6.2 (Berkeley) 3/17/89
        !            17: .\"
        !            18: .Ds
        !            19: .Fd cbreak "" \*m
        !            20: .Fd nocbreak "" \*m
        !            21: .Fd crmode "" \*m
        !            22: .Fd nocrmode "" \*m
        !            23: .De
        !            24: Set or unset the terminal to/from cbreak mode.
        !            25: The misnamed macros
        !            26: .Fn crmode
        !            27: and
        !            28: .Fn nocrmode
        !            29: are retained for backwards compatibility
        !            30: with ealier versions of the library.
        !            31: .Ds
        !            32: .Fd echo "" \*m
        !            33: .Fd noecho "" \*m
        !            34: .De
        !            35: Sets the terminal to echo or not echo characters.
        !            36: .Ds
        !            37: .Fd getch "" \*m
        !            38: .Fd wgetch win
        !            39: WINDOW *win;
        !            40: .De
        !            41: Gets a character from the terminal and (if necessary)
        !            42: echos it on the window.
        !            43: \*(Es
        !            44: Otherwise, the character gotten is returned.
        !            45: If
        !            46: .i noecho
        !            47: has been set, then the window is left unaltered.
        !            48: In order to retain control of the terminal,
        !            49: it is necessary to have one of
        !            50: .i noecho ,
        !            51: .i cbreak ,
        !            52: or
        !            53: .i rawmode
        !            54: set.
        !            55: If you do not set one,
        !            56: whatever routine you call to read characters will set
        !            57: .i cbreak
        !            58: for you,
        !            59: and then reset to the original mode when finished.
        !            60: .Ds
        !            61: .Fd getstr str \*m
        !            62: char   *str;
        !            63: .Fd wgetstr win\*,str
        !            64: WINDOW *win;
        !            65: char   *str;
        !            66: .De
        !            67: Get a string through the window
        !            68: and put it in the location pointed to by
        !            69: .Vn str ,
        !            70: which is assumed to be large enough to handle it.
        !            71: It sets tty modes if necessary,
        !            72: and then calls
        !            73: .Fn getch
        !            74: (or
        !            75: .Fn wgetch ) "" win
        !            76: to get the characters needed to fill in the string
        !            77: until a newline or EOF is encountered.
        !            78: The newline stripped off the string.
        !            79: \*(Es
        !            80: .Ds
        !            81: .Fd \*_putchar c
        !            82: char   c;
        !            83: .De
        !            84: Put out a character using the
        !            85: .Fn putchar
        !            86: macro.
        !            87: This function is used to output every character
        !            88: that
        !            89: .b curses
        !            90: generates.
        !            91: Thus,
        !            92: it can be redefined by the user who wants to do non-standard things
        !            93: with the output.
        !            94: It is named with an initial \*(lq\*_\*(rq
        !            95: because it usually should be invisible to the programmer.
        !            96: .Ds
        !            97: .Fd raw "" \*m
        !            98: .Fd noraw "" \*m
        !            99: .De
        !           100: Set or unset the terminal to/from raw mode.
        !           101: On version 7
        !           102: .Un \**
        !           103: .(f
        !           104: \**
        !           105: .Un
        !           106: is a trademark of Bell Laboratories.
        !           107: .)f
        !           108: this also turns of newline mapping
        !           109: (see
        !           110: .Fn nl ).
        !           111: .Ds
        !           112: .Fd scanw fmt\*,arg1\*,arg2\*,...
        !           113: char   *fmt;
        !           114: .Fd wscanw win\*,fmt\*,arg1\*,arg2\*,...
        !           115: WINDOW *win;
        !           116: char   *fmt;
        !           117: .De
        !           118: Perform a
        !           119: .Fn scanf
        !           120: through the window using
        !           121: .Vn fmt .
        !           122: It does this using consecutive
        !           123: .Fn getch 's
        !           124: (or
        !           125: .Fn wgetch 's). "" win
        !           126: \*(Es

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.