home *** CD-ROM | disk | FTP | other *** search
/ Serving the Web / ServingTheWeb1995.disc1of1.iso / linux / slacksrce / d / libc / libc-4.6 / libc-4 / libc-linux / curses-bsd4.4 / PSD.doc / intro.5 < prev    next >
Encoding:
Text File  |  1994-06-01  |  4.1 KB  |  88 lines
  1. .\" Copyright (c) 1980, 1993
  2. .\"    The Regents of the University of California.  All rights reserved.
  3. .\"
  4. .\" Redistribution and use in source and binary forms, with or without
  5. .\" modification, are permitted provided that the following conditions
  6. .\" are met:
  7. .\" 1. Redistributions of source code must retain the above copyright
  8. .\"    notice, this list of conditions and the following disclaimer.
  9. .\" 2. Redistributions in binary form must reproduce the above copyright
  10. .\"    notice, this list of conditions and the following disclaimer in the
  11. .\"    documentation and/or other materials provided with the distribution.
  12. .\" 3. All advertising materials mentioning features or use of this software
  13. .\"    must display the following acknowledgement:
  14. .\"    This product includes software developed by the University of
  15. .\"    California, Berkeley and its contributors.
  16. .\" 4. Neither the name of the University nor the names of its contributors
  17. .\"    may be used to endorse or promote products derived from this software
  18. .\"    without specific prior written permission.
  19. .\"
  20. .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21. .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22. .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23. .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24. .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25. .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26. .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27. .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28. .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29. .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30. .\" SUCH DAMAGE.
  31. .\"
  32. .\"    @(#)intro.5    8.1 (Berkeley) 6/4/93
  33. .\"
  34. .sh 1 "Character Output and Scrolling"
  35. .pp
  36. The character output policy deals with the following problems.  First,
  37. where is the location of the cursor after a character is printed, and 
  38. secondly, when does the screen scroll if scrolling is enabled.
  39. .pp
  40. In the normal case the characters are output as expected, with the cursor 
  41. occupying the position of the next character to be output.  However, when the
  42. cursor is on the last column of the line, the cursor will remain on that 
  43. position after the last character on the line is output and will only assume
  44. the position on the next line when the next character (the first on the next
  45. line) is output.
  46. .pp
  47. Likewise, if scrolling is enabled, a scroll will be invoked only when the
  48. first character on he first line past the bottom line of the window is
  49. output.  If scrolling is not enabled the chracters will to be output to the
  50. bottom right corner of the window which is the cursor location.
  51. .pp
  52. This policy allows consistent behavior of the cursor at the boundary 
  53. conditions.  Furthermore, it prevents a scroll from happening before it is
  54. actually needed (the old package used to scroll when the bottom right position
  55. was output a character).  As a precendent, it models the 
  56. .i xterm
  57. character output conventions.
  58. .sh 1 "Terminal State Handling"
  59. .pp
  60. The variable
  61. .Vn curses_termios
  62. contains the terminal state of the terminal.  Certain historical routines 
  63. return information:
  64. .Fn baudrate , 
  65. .Fn erasechar ,
  66. .Fn killchar ,
  67. and 
  68. .Fn ospeed .
  69. These routines are obsolete and exist only for backward compatibility.  If
  70. you wish to use the information in the 
  71. .Vn curses_termios
  72. structure, you should use the
  73. \fItsetattr\fP(3) 
  74. routines.
  75. .sh 1 "Subwindows"
  76. .pp
  77. Subwindows are windows which do not have an independent text structure, 
  78. .i i.e. , 
  79. they are windows whose text is a subset of the text of a larger window: the
  80. .i parent 
  81. window.  One consequence of this is that changes to either the parent or the
  82. child window are destructive to the other, 
  83. .i i.e. , 
  84. a change to the subwindow is also a change to the parent window and a change 
  85. to the parent window in the region defined by the subwindow is implicitly a 
  86. change to the subwindow as well.
  87. Apart from this detail, subwindows function like any other window.
  88.