X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_print.3x.html;h=24c62d2e59cb75c553c939f56d033236214ecf75;hp=1319ba6d35abec4f0939875e5adfdaf9bb800345;hb=HEAD;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34 diff --git a/doc/html/man/curs_print.3x.html b/doc/html/man/curs_print.3x.html index 1319ba6d..92fb48d4 100644 --- a/doc/html/man/curs_print.3x.html +++ b/doc/html/man/curs_print.3x.html @@ -1,80 +1,121 @@ + + +
+ + +- +curs_print(3x) Library calls curs_print(3x) --
- mcprint - ship binary data to printer --
- #include <curses.h> - int mcprint(char *data, int len); +
+ mcprint - write binary data to printer using terminfo capabilities --
- This function uses the mc5p or mc4 and mc5 capabilities, - if they are present, to ship given data to a printer - attached to the terminal. +
+ #include <curses.h> - Note that the mcprint code has no way to do flow control - with the printer 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 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. + int mcprint(char *data, int len); +
+ This function uses the mc5p or mc4 and mc5 capabilities, if they are + present, to ship given data to a printer attached to the terminal. --
- The mcprint function returns ERR if the write operation - aborted for some reason. In this case, errno will contain - either an error associated with write(2) or one of the - following: + Note that the mcprint code has no way to do flow control with the + printer 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 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. - ENODEV - Capabilities for printer redirection don't exist. - ENOMEM - Couldn't allocate sufficient memory to buffer the - printer write. +
+ The mcprint function returns ERR if the write operation aborted for + some reason. In this case, errno will contain either an error + associated with write(2) or one of the following: - When mcprint succeeds, it returns the number of char- - acters actually sent to the printer. + ENODEV + Capabilities for printer redirection do not exist. + ENOMEM + Couldn't allocate sufficient memory to buffer the printer write. --
- The mcprint call was designed for ncurses(3x), and is not - found in SVr4 curses, 4.4BSD curses, or any other previous - version of curses. + When mcprint succeeds, it returns the number of characters actually + sent to the printer. --
- Padding in the mc5p, mc4 and mc5 capabilities will not be - interpreted. +
+ mcprint was designed for ncurses(3x), and was not found in SVr4 curses, + 4.4BSD curses, or any other previous curses implementation. --
- curses(3x) +
+ Applications employing this ncurses extension should condition its use + on the visibility of the NCURSES_VERSION preprocessor macro. + + +
+ Padding in the mc5p, mc4, and mc5 capabilities is not interpreted. + +
+ curses(3x) +ncurses 6.5 2024-03-16 curs_print(3x)-