X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=docs%2Freference%2Fglk-display-style.sgml;h=110af535639f2a145ad6b824db215960953dd4a5;hb=f19a194bd066ea4320c1c6b6b8c5a375f7787af5;hp=d119c24636d135e68648f3aed361dfe399a0ec76;hpb=2da183ac47f1157560dcd2c417f7f6a24ae72352;p=projects%2Fchimara%2Fchimara.git diff --git a/docs/reference/glk-display-style.sgml b/docs/reference/glk-display-style.sgml index d119c24..110af53 100644 --- a/docs/reference/glk-display-style.sgml +++ b/docs/reference/glk-display-style.sgml @@ -15,13 +15,17 @@ Description -The way windows are displayed is, of course, entirely up to the Glk library; it depends on what is natural for the player's machine. The borders between windows may be black lines, 3-D bars, rows of # characters; there may even be no borders at all. +The way windows are displayed is, of course, entirely up to the Glk library; it depends on what is natural for the player's machine. The borders between windows may be black lines, 3-D bars, rows of # characters; there may even be no borders at all. +The library may not support the Border/NoBorder hint, in which case every pair of windows will have a visible border — or no border — between them. -This is an important possibility to keep in mind. +The Border/NoBorder was introduced in Glk 0.7.1. +Prior to that, all games used the Border hint, and this remains the default. +However, as noted, not all implementations display window borders. +Therefore, for existing implementations, Border may be understood as your normal style of window display; NoBorder may be understood as suppress any interwindow borders you may have. -There may be other decorations as well. A text buffer window will often have a scroll bar. The library (or player) may prefer wide margins around each text window. And so on. +There may be decorations within the windows as well. A text buffer window will often have a scroll bar. The library (or player) may prefer wide margins around each text window. And so on. The library is reponsible for handling these decorations, margins, spaces, and borders. You should never worry about them. You are guaranteed that if you request a fixed size of two rows, your text grid window will have room for two rows of characters — if there is enough total space. Any margins or borders will be allowed for already. If there isn't enough total space (as in stages 4 and 5 of this figure), you lose, of course.