X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fscr_dump.5;h=bb2d1c7ff10bf468e0972ac1bcc651bb80506322;hp=aff1fb5783deb0e5687b57f726b6a45e1c07f373;hb=cccf831ed7c83410c7f6cec2a43e71e9c4278b4c;hpb=a8e3f06ac309504143cd56ac9ec55889bfdf4914 diff --git a/man/scr_dump.5 b/man/scr_dump.5 index aff1fb57..bb2d1c7f 100644 --- a/man/scr_dump.5 +++ b/man/scr_dump.5 @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 2017 Free Software Foundation, Inc. * +.\" Copyright (c) 2017,2018 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,16 +26,16 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: scr_dump.5,v 1.9 2017/04/22 18:44:25 tom Exp $ +.\" $Id: scr_dump.5,v 1.13 2018/05/19 21:10:21 tom Exp $ .TH scr_dump 5 .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq .el .ds '' '' .de NS -.ie \n(.sp +.ie n .sp .el .sp .5 -.ie \n(.in +4 +.ie n .in +4 .el .in +2 .nf .ft C \" Courier @@ -46,10 +46,9 @@ .in -4 .. .de bP -.IP \(bu 4 +.ie n .IP \(bu 4 +.el .IP \(bu 2 .. -.ds n 5 -.ds d @TERMINFO@ .SH NAME scr_dump \- format of curses screen-dumps. .SH SYNOPSIS @@ -156,12 +155,14 @@ because it did not meet the criteria for \fIbase curses\fP). The document explained the term \*(``enhanced\*('' as follows: .RS 3 .bP -Shading is used to identify \fIX/Open Enhanced Curses\fP material, relating to interfaces -included to provide enhanced capabilities 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 \fBXPG4 or to earlier XPG releases\fP. -The relevant reference pages may provide additional or more specific portability warnings -about use of the material. +Shading is used to identify \fIX/Open Enhanced Curses\fP material, +relating to interfaces included to provide enhanced capabilities +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 \fBXPG4 or to earlier XPG releases\fP. +The relevant reference pages may provide additional +or more specific portability warnings about use of the material. .RE .PP In the foregoing, emphasis was added to \fBunspecified format\fP @@ -251,7 +252,23 @@ e.g., .NE .SS NetBSD .PP -As of April 2017, NetBSD curses does not yet support screen dumps. +As of April 2017, NetBSD curses does +not support \fBscr_dump\fP and \fBscr_restore\fP +(or \fBscr_init\fP, \fBscr_set\fP), +although it has \fBputwin\fP and \fBgetwin\fP. +.PP +Like ncurses5, NetBSD \fBputwin\fP does not identify its dumps with a +useful magic number. +It writes +.bP +the curses shared library major and minor versions +as the first two bytes (e.g., 7 and 1), +.bP +followed by a binary dump of the \fBWINDOW\fP, +.bP +some data for wide-characters referenced by the \fBWINDOW\fP structure, and +.bP +finally, lines as done by other implementations. .SH EXAMPLE .PP Given a simple program which writes text to the screen