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

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.