X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_print.3x;h=0f526f8c42a38651a633dc05b15b4849310c8bf3;hp=1d17add974c2f913bb256119990b5202d8fdc18e;hb=349761f30e7fc0b4bf2718f7fc3da34e09ea6735;hpb=8d3ea9021573747ecd129228ba7782a03243f62c;ds=sidebyside diff --git a/man/curs_print.3x b/man/curs_print.3x index 1d17add9..0f526f8c 100644 --- a/man/curs_print.3x +++ b/man/curs_print.3x @@ -1,5 +1,6 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2010,2017 Free Software Foundation, Inc. * +.\" Copyright 2018,2020 Thomas E. Dickey * +.\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -26,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_print.3x,v 1.12 2017/11/20 01:27:30 tom Exp $ +.\" $Id: curs_print.3x,v 1.15 2020/03/28 19:06:28 tom Exp $ .TH curs_print 3X "" .SH NAME \fBmcprint\fR \- ship binary data to printer @@ -39,15 +40,18 @@ This function uses the \fBmc5p\fR or \fBmc4\fR and \fBmc5\fR capabilities, if they are present, to ship given data to a printer attached to the terminal. .PP Note that the \fBmcprint\fR code has no way to do flow control with the printer -or to know how much buffering it has. Your application is responsible for +or to know how much buffering it has. +Your application is responsible for keeping the rate of writes to the printer below its continuous throughput rate -(typically about half of its nominal cps rating). Dot-matrix printers and +(typically about half of its nominal cps rating). +Dot-matrix printers and 6-page-per-minute lasers can typically handle 80cps, so a good conservative rule of thumb is to sleep for a second after shipping each 80-character line. . .SH RETURN VALUE The \fBmcprint\fR function returns \fBERR\fR if the write operation aborted -for some reason. In this case, errno will contain either an error associated +for some reason. +In this case, \fBerrno\fP will contain either an error associated with \fBwrite\fP(2) or one of the following: .TP 5 ENODEV