diff options
Diffstat (limited to 'doc/html/man/scr_dump.5.html')
| -rw-r--r-- | doc/html/man/scr_dump.5.html | 91 |
1 files changed, 46 insertions, 45 deletions
diff --git a/doc/html/man/scr_dump.5.html b/doc/html/man/scr_dump.5.html index e73ebc0..e01ea35 100644 --- a/doc/html/man/scr_dump.5.html +++ b/doc/html/man/scr_dump.5.html @@ -1,6 +1,6 @@ -<!-- +<!-- **************************************************************************** - * Copyright 2018,2020 Thomas E. Dickey * + * Copyright 2018-2020,2021 Thomas E. Dickey * * Copyright 2017 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,7 +27,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: scr_dump.5,v 1.16 2020/02/02 23:34:34 tom Exp @ + * @Id: scr_dump.5,v 1.17 2021/06/17 21:26:02 tom Exp @ --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML> @@ -60,8 +60,8 @@ read it back using <STRONG>scr_restore</STRONG> or <STRONG>getwin</STRONG>. The <STRONG>putwin</STRONG> and <STRONG>getwin</STRONG> functions do the work; while <STRONG>scr_dump</STRONG> and - <STRONG>scr_restore</STRONG> conveniently save and restore the whole screen, i.e., <STRONG>std-</STRONG> - <STRONG>scr</STRONG>. + <STRONG>scr_restore</STRONG> conveniently save and restore the whole screen, i.e., + <STRONG>stdscr</STRONG>. </PRE><H3><a name="h3-ncurses6">ncurses6</a></H3><PRE> @@ -72,8 +72,8 @@ allowing applications (such as <STRONG>file(1)</STRONG>) to recognize curses dump files. - Because ncurses6 uses a new format, that requires a new magic num- - ber was unused by other applications. This 16-bit number was + Because ncurses6 uses a new format, that requires a new magic + number was unused by other applications. This 16-bit number was unused: 0x8888 (octal "\210\210") @@ -82,8 +82,8 @@ 0x88888888 (octal "\210\210\210\210") - This is the pattern submitted to the maintainers of the <STRONG>file</STRONG> pro- - gram: + This is the pattern submitted to the maintainers of the <STRONG>file</STRONG> + program: # # ncurses5 (and before) did not use a magic number, @@ -95,17 +95,17 @@ <STRONG>o</STRONG> The screen dumps are written in textual form, so that internal data sizes are not directly related to the dump-format, and enabling the - library to read dumps from either narrow- or wide-character- con- - figurations. + library to read dumps from either narrow- or wide-character- + configurations. The <EM>narrow</EM> library configuration holds characters and video attributes in a 32-bit <STRONG>chtype</STRONG>, while the <EM>wide-character</EM> library stores this information in the <STRONG>cchar_t</STRONG> structure, which is much larger than 32-bits. - <STRONG>o</STRONG> It is possible to read a screen dump into a terminal with a differ- - ent screen-size, because the library truncates or fills the screen - as necessary. + <STRONG>o</STRONG> It is possible to read a screen dump into a terminal with a + different screen-size, because the library truncates or fills the + screen as necessary. <STRONG>o</STRONG> The ncurses6 <STRONG>getwin</STRONG> reads the legacy screen dumps from ncurses5. @@ -139,8 +139,8 @@ X/Open's documentation for <EM>enhanced</EM> <EM>curses</EM> says only: The <EM>getwin(</EM> <EM>)</EM> function reads window-related data stored in the file - by <EM>putwin(</EM> <EM>)</EM>. The function then creates and initializes a new win- - dow using that data. + by <EM>putwin(</EM> <EM>)</EM>. The function then creates and initializes a new + window using that data. The <EM>putwin(</EM> <EM>)</EM> function writes all data associated with <EM>win</EM> into the <EM>stdio</EM> stream to which <EM>filep</EM> points, using an <STRONG>unspecified</STRONG> <STRONG>format</STRONG>. @@ -157,17 +157,17 @@ for applications originally written to be compiled on systems based on the UNIX operating system. Therefore, the features described may not be present on systems that conform to <STRONG>XPG4</STRONG> <STRONG>or</STRONG> - <STRONG>to</STRONG> <STRONG>earlier</STRONG> <STRONG>XPG</STRONG> <STRONG>releases</STRONG>. The relevant reference pages may pro- - vide additional or more specific portability warnings about use - of the material. + <STRONG>to</STRONG> <STRONG>earlier</STRONG> <STRONG>XPG</STRONG> <STRONG>releases</STRONG>. The relevant reference pages may + provide additional or more specific portability warnings about + use of the material. In the foregoing, emphasis was added to <STRONG>unspecified</STRONG> <STRONG>format</STRONG> and to <STRONG>XPG4</STRONG> <STRONG>or</STRONG> <STRONG>to</STRONG> <STRONG>earlier</STRONG> <STRONG>XPG</STRONG> <STRONG>releases</STRONG>, for clarity. </PRE><H3><a name="h3-Unix-SystemV">Unix SystemV</a></H3><PRE> - Unix SystemV curses identified the file format by writing a "magic num- - ber" at the beginning of the dump. The <STRONG>WINDOW</STRONG> data and the lines of + Unix SystemV curses identified the file format by writing a "magic + number" at the beginning of the dump. The <STRONG>WINDOW</STRONG> data and the lines of text follow, all in binary form. The Solaris curses source has these definitions: @@ -198,9 +198,10 @@ be seen using <STRONG>od(1)</STRONG>, none of the Unix systems documents the format used for screen-dumps. - The Unix systems do not use identical formats. While collecting infor- - mation for for this manual page, the <EM>savescreen</EM> test-program produced - dumps of different size (all on 64-bit hardware, on 40x80 screens): + The Unix systems do not use identical formats. While collecting + information for for this manual page, the <EM>savescreen</EM> test-program + produced dumps of different size (all on 64-bit hardware, on 40x80 + screens): <STRONG>o</STRONG> AIX (51817 bytes) @@ -212,27 +213,27 @@ </PRE><H3><a name="h3-Solaris">Solaris</a></H3><PRE> - As noted above, Solaris curses has no magic number corresponding to - SVr4 curses. This is odd since Solaris was the first operating system + As noted above, Solaris curses has no magic number corresponding to + SVr4 curses. This is odd since Solaris was the first operating system to pass the SVr4 guidelines. Solaris has two versions of curses: <STRONG>o</STRONG> The default curses library uses the SVr3 magic number. - <STRONG>o</STRONG> There is an alternate curses library in <STRONG>/usr/xpg4</STRONG>. This uses a + <STRONG>o</STRONG> There is an alternate curses library in <STRONG>/usr/xpg4</STRONG>. This uses a textual format with no magic number. - According to the copyright notice, the <EM>xpg4</EM> Solaris curses library + According to the copyright notice, the <EM>xpg4</EM> Solaris curses library was developed by MKS (Mortice Kern Systems) from 1990 to 1995. - Like ncurses6, there is a file-header with parameters. Unlike - ncurses6, the contents of the window are written piecemeal, with - coordinates and attributes for each chunk of text rather than writ- - ing the whole window from top to bottom. + Like ncurses6, there is a file-header with parameters. Unlike + ncurses6, the contents of the window are written piecemeal, with + coordinates and attributes for each chunk of text rather than + writing the whole window from top to bottom. </PRE><H3><a name="h3-PDCurses">PDCurses</a></H3><PRE> - PDCurses added support for screen dumps in version 2.7 (2005). Like - Unix SystemV and ncurses5, it writes the <STRONG>WINDOW</STRONG> structure in binary, + PDCurses added support for screen dumps in version 2.7 (2005). Like + Unix SystemV and ncurses5, it writes the <STRONG>WINDOW</STRONG> structure in binary, but begins the file with its three-byte identifier "PDC", followed by a one-byte version, e.g., @@ -243,7 +244,7 @@ As of April 2017, NetBSD curses does not support <STRONG>scr_dump</STRONG> and <STRONG>scr_restore</STRONG> (or <STRONG>scr_init</STRONG>, <STRONG>scr_set</STRONG>), although it has <STRONG>putwin</STRONG> and <STRONG>getwin</STRONG>. - Like ncurses5, NetBSD <STRONG>putwin</STRONG> does not identify its dumps with a useful + Like ncurses5, NetBSD <STRONG>putwin</STRONG> does not identify its dumps with a useful magic number. It writes <STRONG>o</STRONG> the curses shared library major and minor versions as the first two @@ -251,14 +252,14 @@ <STRONG>o</STRONG> followed by a binary dump of the <STRONG>WINDOW</STRONG>, - <STRONG>o</STRONG> some data for wide-characters referenced by the <STRONG>WINDOW</STRONG> structure, + <STRONG>o</STRONG> some data for wide-characters referenced by the <STRONG>WINDOW</STRONG> structure, and <STRONG>o</STRONG> finally, lines as done by other implementations. </PRE><H2><a name="h2-EXAMPLE">EXAMPLE</a></H2><PRE> - Given a simple program which writes text to the screen (and for the + Given a simple program which writes text to the screen (and for the sake of example, limiting the screen-size to 10x20): #include <curses.h> @@ -316,13 +317,13 @@ <STRONG>o</STRONG> The actual color pair values are not written to the file. - <STRONG>o</STRONG> All characters are shown in printable form; spaces are "\s" to + <STRONG>o</STRONG> All characters are shown in printable form; spaces are "\s" to ensure they are not overlooked. - <STRONG>o</STRONG> Attributes are written in escaped curly braces, e.g., "\{BOLD}", + <STRONG>o</STRONG> Attributes are written in escaped curly braces, e.g., "\{BOLD}", and may include a color-pair (C1 or C2 in this example). - <STRONG>o</STRONG> The parameters in the header are written out only if they are + <STRONG>o</STRONG> The parameters in the header are written out only if they are nonzero. When reading back, order does not matter. Running the same program with Solaris <EM>xpg4</EM> curses gives this dump: @@ -361,13 +362,13 @@ 9,19,0,0, CUR=11,5 - Solaris <STRONG>getwin</STRONG> requires that all parameters are present, and in the - same order. The <EM>xpg4</EM> curses library does not know about the <STRONG>bce</STRONG> (back + Solaris <STRONG>getwin</STRONG> requires that all parameters are present, and in the + same order. The <EM>xpg4</EM> curses library does not know about the <STRONG>bce</STRONG> (back color erase) capability, and does not color the window background. - On the other hand, the SVr4 curses library does know about the back- - ground color. However, its screen dumps are in binary. Here is the - corresponding dump (using "od -t x1"): + On the other hand, the SVr4 curses library does know about the + background color. However, its screen dumps are in binary. Here is + the corresponding dump (using "od -t x1"): 0000000 1c 01 c3 d6 f3 58 05 00 0b 00 0a 00 14 00 00 00 0000020 00 00 02 00 00 00 00 00 00 00 00 00 00 00 00 00 |