Technical Standard
Total Page:16
File Type:pdf, Size:1020Kb
Technical Standard X/Open Curses, Issue 7 The Open Group ©November 2009, The Open Group All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior permission of the copyright owners. Technical Standard X/Open Curses, Issue 7 ISBN: 1-931624-83-6 Document Number: C094 Published in the U.K. by The Open Group, November 2009. This standardhas been prepared by The Open Group Base Working Group. Feedback relating to the material contained within this standardmay be submitted by using the web site at http://austingroupbugs.net with the Project field set to "Xcurses Issue 7". ii Technical Standard 2009 Contents Chapter 1 Introduction........................................................................................... 1 1.1 This Document ........................................................................................ 1 1.1.1 Relationship to Previous Issues ......................................................... 1 1.1.2 Features Introduced in Issue 7 ........................................................... 2 1.1.3 Features Withdrawn in Issue 7........................................................... 2 1.1.4 Features Introduced in Issue 4 ........................................................... 2 1.2 Conformance............................................................................................ 3 1.2.1 Base Curses Conformance .................................................................. 3 1.2.2 Enhanced Curses Conformance......................................................... 4 1.3 Terminology ............................................................................................. 4 1.3.1 Shaded Text ........................................................................................... 5 1.4 Format of Entries..................................................................................... 6 Chapter 2 General Information ......................................................................... 9 2.1 Use and Implementation of Interfaces................................................. 9 2.1.1 Use and Implementation of Functions.............................................. 9 2.1.2 Use and Implementation of Macros .................................................. 9 2.2 The Compilation Environment ............................................................. 10 2.2.1 The X/Open Name Space (ENHANCED CURSES) ....................... 10 2.3 Data Types ................................................................................................ 12 Chapter 3 Interface Overview ............................................................................ 13 3.1 Components............................................................................................. 13 3.1.1 Relationship to the XSH Specification............................................... 13 3.1.2 Relationship to the XBD Specification .............................................. 13 3.2 Screens, Windows, and Terminals ........................................................ 14 3.3 Characters................................................................................................. 15 3.3.1 Character Storage Size......................................................................... 15 3.3.2 Multi-Column Characters ................................................................... 16 3.3.3 Attributes............................................................................................... 16 3.3.4 Rendition ............................................................................................... 16 3.3.5 Non-Spacing Characters ..................................................................... 16 3.3.6 Window Properties .............................................................................. 17 3.4 Conceptual Operations ........................................................................... 18 3.4.1 Screen Addressing ............................................................................... 18 3.4.2 Basic Character Operations ................................................................ 18 3.4.3 Special Characters ................................................................................ 20 3.4.4 Rendition of Characters Placed into a Window ............................... 21 3.5 Input Processing ...................................................................................... 22 3.5.1 Keypad Processing ............................................................................... 22 3.5.2 Input Mode ........................................................................................... 23 3.5.3 Delay Mode ........................................................................................... 24 3.5.4 Echo Processing .................................................................................... 24 3.6 The Set of Curses Functions .................................................................. 24 3.6.1 Function Name Conventions.............................................................. 24 X/Open Curses, Issue 7 iii Contents 3.6.2 Function Families Provided ................................................................ 25 3.7 Interfaces Implemented as Macros ....................................................... 26 3.8 Initialized Curses Environment ............................................................ 27 3.9 Synchronous and Networked Asynchronous Terminals .................. 27 Chapter 4 Curses Interfaces................................................................................. 29 Chapter 5 Headers .................................................................................................... 305 <curses.h>................................................................................................... 306 <term.h>...................................................................................................... 320 <unctrl.h> ................................................................................................... 321 Chapter 6 Utilities..................................................................................................... 323 infocmp ......................................................................................................... 324 tic .................................................................................................................. 328 tput ............................................................................................................... 330 untic .............................................................................................................. 335 Chapter 7 Terminfo Source Format (ENHANCED CURSES) ........... 337 7.1 Source File Syntax ................................................................................... 337 7.1.1 Minimum Guaranteed Limits ............................................................ 338 7.1.2 Formal Grammar .................................................................................. 338 7.1.3 Defined Capabilities ............................................................................ 340 7.1.4 Sample Entry ......................................................................................... 349 7.1.5 Types of Capabilities in the Sample Entry........................................ 349 Appendix A Application Usage.............................................................................. 353 A.1 Device Capabilities ................................................................................. 353 A.1.1 Basic Capabilities ................................................................................. 353 A.1.2 Parameterized Strings ......................................................................... 354 A.1.3 Cursor Motions ..................................................................................... 355 A.1.4 Area Clears............................................................................................ 356 A.1.5 Insert/Delete Line ................................................................................ 356 A.1.6 Insert/Delete Character ...................................................................... 357 A.1.7 Highlighting, Underlining, and Visible Bells................................... 358 A.1.8 Keypad................................................................................................... 360 A.1.9 Tabs and Initialization ......................................................................... 360 A.1.10 Delays .................................................................................................... 361 A.1.11Status Lines ........................................................................................... 361 A.1.12 Line Graphics ........................................................................................ 361 A.1.13 Color Manipulation ............................................................................. 363 A.1.14 Miscellaneous ....................................................................................... 364 A.1.15 Special Cases ......................................................................................... 365 A.1.16 Similar Terminals ................................................................................. 366 A.2 Printer Capabilities ................................................................................. 366 A.2.1