Return to bputchar.3l CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / p_man / man3

Annotation of researchv10dc/630/man/src/p_man/man3/bputchar.3l, revision 1.1

1.1     ! root        1: .TH BPUTCHAR 3L "630 MTG"
        !             2: .SH NAME
        !             3: bputchar \- 630 MTG debugging putchar function
        !             4: .SH SYNOPSIS
        !             5: .ft B
        !             6: void bputchar (c)
        !             7: .br
        !             8: \f3char c;\f1
        !             9: .ft R
        !            10: .SH DESCRIPTION
        !            11: \fIBputchar\fR is
        !            12: syntactically equivalent to the UNIX standard I/O putchar function.
        !            13: It can be called by downloaded application programs who
        !            14: want to display characters but do not want them displayed in their window.
        !            15: When first called, the bottom third of the 630 MTG's screen is cleared.
        !            16: All characters to be printed are displayed in this area as if it was
        !            17: a window. This will corrupt any windows already in this area. Therefore,
        !            18: this routine is only useful for debugging.
        !            19: .PP
        !            20: How characters are eventually
        !            21: displayed on a user's terminal when using the UNIX putchar function
        !            22: is affected by the UNIX host \fIstty\fR(1) settings
        !            23: and the user's terminal characteristics.
        !            24: Since \fIbputchar\fR displays directly onto the 630 MTG
        !            25: screen, it makes assumptions about desired \fIstty\fR
        !            26: settings. In general, \fIbputchar\fR does as little processing of
        !            27: the output stream as practical. 
        !            28: .P
        !            29: The following are the only control characters processed by \fIbputchar\fR.
        !            30: All other characters will be displayed as \fBASCII\fR characters:
        !            31: .TP
        !            32: .B \er
        !            33: Carriage Return. Move the current point to the left edge of the screen.
        !            34: .TP
        !            35: .B \en
        !            36: Newline. Move the current point down one line and to the left edge of the 
        !            37: window. Scroll the display area if necessary.
        !            38: .TP
        !            39: .B \et
        !            40: Horizontal tab. Tab characters are expanded to spaces with tab stops at every
        !            41: eighth space.
        !            42: .SH EXAMPLE
        !            43: .LP
        !            44: If a programmer wanted a record of every character it sends to the printer,
        !            45: he can replace every call to \fIpsendchar\fR with \fIdpsendchar\fR shown below.
        !            46: .PP
        !            47: .RS 3
        !            48: .ft CM
        !            49: .nf
        !            50: 
        !            51: int psendchar();
        !            52: 
        !            53: int
        !            54: dpsendchar(c)
        !            55: char c;
        !            56: {
        !            57:        int retval;
        !            58: 
        !            59:        retval = psendchar(c);
        !            60:        if(retval)
        !            61:                bputchar(c);
        !            62:        return(retval);
        !            63: }
        !            64: 
        !            65: 
        !            66: .fi
        !            67: .ft R
        !            68: .RE
        !            69: .SH SEE ALSO
        !            70: lputchar(3L), printf(3L), psendchar(3R).
        !            71: .br
        !            72: putc(3S) in the \fIUNIX System V Programmer's Reference Manual\fR.

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