curses 1.4.4 → 1.4.6

Sign up to get free protection for your applications and to get access to all the features.
Files changed (258) hide show
  1. checksums.yaml +4 -4
  2. data/.github/dependabot.yml +6 -0
  3. data/.github/workflows/macos.yml +1 -1
  4. data/.github/workflows/push_gem.yml +48 -0
  5. data/.github/workflows/ubuntu.yml +2 -2
  6. data/.github/workflows/windows.yml +2 -2
  7. data/History.md +23 -0
  8. data/README.md +7 -0
  9. data/curses.gemspec +1 -1
  10. data/ext/curses/curses.c +7 -7
  11. data/sample/colors.rb +6 -1
  12. data/sample/form.rb +1 -1
  13. data/sample/menu.rb +2 -0
  14. metadata +9 -251
  15. data/vendor/PDCurses/.gitignore +0 -47
  16. data/vendor/PDCurses/.travis.yml +0 -49
  17. data/vendor/PDCurses/CMakeLists.txt +0 -68
  18. data/vendor/PDCurses/HISTORY.md +0 -2036
  19. data/vendor/PDCurses/IMPLEMNT.md +0 -327
  20. data/vendor/PDCurses/Makefile +0 -27
  21. data/vendor/PDCurses/README.md +0 -77
  22. data/vendor/PDCurses/acs_defs.h +0 -265
  23. data/vendor/PDCurses/appveyor.yml +0 -218
  24. data/vendor/PDCurses/cmake/README.md +0 -71
  25. data/vendor/PDCurses/cmake/build_dependencies.cmake +0 -178
  26. data/vendor/PDCurses/cmake/build_options.cmake +0 -25
  27. data/vendor/PDCurses/cmake/dll_version.cmake +0 -26
  28. data/vendor/PDCurses/cmake/gen_config_header.cmake +0 -43
  29. data/vendor/PDCurses/cmake/get_version.cmake +0 -17
  30. data/vendor/PDCurses/cmake/make_uninstall.cmake +0 -19
  31. data/vendor/PDCurses/cmake/project_common.cmake +0 -121
  32. data/vendor/PDCurses/cmake/resource.in.cmake +0 -52
  33. data/vendor/PDCurses/cmake/sdl2_ttf/CMakeLists.txt +0 -83
  34. data/vendor/PDCurses/cmake/target_arch.cmake +0 -36
  35. data/vendor/PDCurses/cmake/version.in.cmake +0 -73
  36. data/vendor/PDCurses/cmake/watcom_open_dos16_toolchain.cmake +0 -96
  37. data/vendor/PDCurses/cmake/watcom_open_dos32_toolchain.cmake +0 -106
  38. data/vendor/PDCurses/cmake/watcom_open_os2v2_toolchain.cmake +0 -105
  39. data/vendor/PDCurses/curses.h +0 -1846
  40. data/vendor/PDCurses/curspriv.h +0 -134
  41. data/vendor/PDCurses/demos/README.md +0 -25
  42. data/vendor/PDCurses/demos/firework.c +0 -144
  43. data/vendor/PDCurses/demos/newtest.c +0 -581
  44. data/vendor/PDCurses/demos/ozdemo.c +0 -447
  45. data/vendor/PDCurses/demos/ptest.c +0 -283
  46. data/vendor/PDCurses/demos/rain.c +0 -157
  47. data/vendor/PDCurses/demos/testcurs.c +0 -1607
  48. data/vendor/PDCurses/demos/tui.c +0 -1048
  49. data/vendor/PDCurses/demos/tui.h +0 -65
  50. data/vendor/PDCurses/demos/tuidemo.c +0 -233
  51. data/vendor/PDCurses/demos/version.c +0 -61
  52. data/vendor/PDCurses/demos/worm.c +0 -432
  53. data/vendor/PDCurses/demos/xmas.c +0 -955
  54. data/vendor/PDCurses/dos/CMakeLists.txt +0 -47
  55. data/vendor/PDCurses/dos/Makefile +0 -105
  56. data/vendor/PDCurses/dos/Makefile.bcc +0 -83
  57. data/vendor/PDCurses/dos/Makefile.dmc +0 -257
  58. data/vendor/PDCurses/dos/Makefile.msc +0 -113
  59. data/vendor/PDCurses/dos/Makefile.wcc +0 -107
  60. data/vendor/PDCurses/dos/README.md +0 -51
  61. data/vendor/PDCurses/dos/bccdos.lrf +0 -9
  62. data/vendor/PDCurses/dos/mscdos.lrf +0 -50
  63. data/vendor/PDCurses/dos/pdcclip.c +0 -132
  64. data/vendor/PDCurses/dos/pdcdisp.c +0 -135
  65. data/vendor/PDCurses/dos/pdcdos.h +0 -194
  66. data/vendor/PDCurses/dos/pdcgetsc.c +0 -98
  67. data/vendor/PDCurses/dos/pdckbd.c +0 -513
  68. data/vendor/PDCurses/dos/pdcscrn.c +0 -785
  69. data/vendor/PDCurses/dos/pdcsetsc.c +0 -101
  70. data/vendor/PDCurses/dos/pdcutil.c +0 -212
  71. data/vendor/PDCurses/libobjs.mif +0 -26
  72. data/vendor/PDCurses/makedist.mif +0 -20
  73. data/vendor/PDCurses/man/Makefile +0 -37
  74. data/vendor/PDCurses/man/README.md +0 -21
  75. data/vendor/PDCurses/man/intro.md +0 -361
  76. data/vendor/PDCurses/man/manext.c +0 -119
  77. data/vendor/PDCurses/man/sdl.md +0 -152
  78. data/vendor/PDCurses/man/sdl2.md +0 -58
  79. data/vendor/PDCurses/man/x11.md +0 -407
  80. data/vendor/PDCurses/ncurses/CMakeLists.txt +0 -66
  81. data/vendor/PDCurses/ncurses/README.md +0 -26
  82. data/vendor/PDCurses/ncurses/makefile +0 -29
  83. data/vendor/PDCurses/os2/CMakeLists.txt +0 -41
  84. data/vendor/PDCurses/os2/Makefile +0 -132
  85. data/vendor/PDCurses/os2/Makefile.bcc +0 -90
  86. data/vendor/PDCurses/os2/Makefile.wcc +0 -43
  87. data/vendor/PDCurses/os2/README.md +0 -43
  88. data/vendor/PDCurses/os2/iccos2.lrf +0 -50
  89. data/vendor/PDCurses/os2/iccos2.mak +0 -256
  90. data/vendor/PDCurses/os2/pdcclip.c +0 -188
  91. data/vendor/PDCurses/os2/pdcdisp.c +0 -93
  92. data/vendor/PDCurses/os2/pdcgetsc.c +0 -89
  93. data/vendor/PDCurses/os2/pdckbd.c +0 -521
  94. data/vendor/PDCurses/os2/pdcos2.h +0 -55
  95. data/vendor/PDCurses/os2/pdcscrn.c +0 -449
  96. data/vendor/PDCurses/os2/pdcsetsc.c +0 -112
  97. data/vendor/PDCurses/os2/pdcutil.c +0 -52
  98. data/vendor/PDCurses/panel.h +0 -56
  99. data/vendor/PDCurses/pdcurses/README.md +0 -25
  100. data/vendor/PDCurses/pdcurses/addch.c +0 -693
  101. data/vendor/PDCurses/pdcurses/addchstr.c +0 -245
  102. data/vendor/PDCurses/pdcurses/addstr.c +0 -240
  103. data/vendor/PDCurses/pdcurses/attr.c +0 -359
  104. data/vendor/PDCurses/pdcurses/beep.c +0 -68
  105. data/vendor/PDCurses/pdcurses/bkgd.c +0 -223
  106. data/vendor/PDCurses/pdcurses/border.c +0 -411
  107. data/vendor/PDCurses/pdcurses/clear.c +0 -159
  108. data/vendor/PDCurses/pdcurses/color.c +0 -298
  109. data/vendor/PDCurses/pdcurses/debug.c +0 -109
  110. data/vendor/PDCurses/pdcurses/delch.c +0 -96
  111. data/vendor/PDCurses/pdcurses/deleteln.c +0 -211
  112. data/vendor/PDCurses/pdcurses/deprec.c +0 -27
  113. data/vendor/PDCurses/pdcurses/getch.c +0 -417
  114. data/vendor/PDCurses/pdcurses/getstr.c +0 -474
  115. data/vendor/PDCurses/pdcurses/getyx.c +0 -139
  116. data/vendor/PDCurses/pdcurses/inch.c +0 -127
  117. data/vendor/PDCurses/pdcurses/inchstr.c +0 -214
  118. data/vendor/PDCurses/pdcurses/initscr.c +0 -367
  119. data/vendor/PDCurses/pdcurses/inopts.c +0 -324
  120. data/vendor/PDCurses/pdcurses/insch.c +0 -271
  121. data/vendor/PDCurses/pdcurses/insstr.c +0 -264
  122. data/vendor/PDCurses/pdcurses/instr.c +0 -246
  123. data/vendor/PDCurses/pdcurses/kernel.c +0 -259
  124. data/vendor/PDCurses/pdcurses/keyname.c +0 -157
  125. data/vendor/PDCurses/pdcurses/mouse.c +0 -438
  126. data/vendor/PDCurses/pdcurses/move.c +0 -57
  127. data/vendor/PDCurses/pdcurses/outopts.c +0 -159
  128. data/vendor/PDCurses/pdcurses/overlay.c +0 -214
  129. data/vendor/PDCurses/pdcurses/pad.c +0 -260
  130. data/vendor/PDCurses/pdcurses/panel.c +0 -633
  131. data/vendor/PDCurses/pdcurses/printw.c +0 -126
  132. data/vendor/PDCurses/pdcurses/refresh.c +0 -279
  133. data/vendor/PDCurses/pdcurses/scanw.c +0 -578
  134. data/vendor/PDCurses/pdcurses/scr_dump.c +0 -213
  135. data/vendor/PDCurses/pdcurses/scroll.c +0 -101
  136. data/vendor/PDCurses/pdcurses/slk.c +0 -591
  137. data/vendor/PDCurses/pdcurses/termattr.c +0 -182
  138. data/vendor/PDCurses/pdcurses/terminfo.c +0 -217
  139. data/vendor/PDCurses/pdcurses/touch.c +0 -163
  140. data/vendor/PDCurses/pdcurses/util.c +0 -312
  141. data/vendor/PDCurses/pdcurses/window.c +0 -569
  142. data/vendor/PDCurses/sdl1/Makefile +0 -129
  143. data/vendor/PDCurses/sdl1/Makefile.mng +0 -110
  144. data/vendor/PDCurses/sdl1/README.md +0 -31
  145. data/vendor/PDCurses/sdl1/deffont.h +0 -385
  146. data/vendor/PDCurses/sdl1/deficon.h +0 -23
  147. data/vendor/PDCurses/sdl1/pdcclip.c +0 -131
  148. data/vendor/PDCurses/sdl1/pdcdisp.c +0 -373
  149. data/vendor/PDCurses/sdl1/pdcgetsc.c +0 -30
  150. data/vendor/PDCurses/sdl1/pdckbd.c +0 -405
  151. data/vendor/PDCurses/sdl1/pdcscrn.c +0 -414
  152. data/vendor/PDCurses/sdl1/pdcsdl.h +0 -31
  153. data/vendor/PDCurses/sdl1/pdcsetsc.c +0 -64
  154. data/vendor/PDCurses/sdl1/pdcutil.c +0 -40
  155. data/vendor/PDCurses/sdl1/sdltest.c +0 -79
  156. data/vendor/PDCurses/sdl2/CMakeLists.txt +0 -76
  157. data/vendor/PDCurses/sdl2/Makefile +0 -135
  158. data/vendor/PDCurses/sdl2/Makefile.vc +0 -164
  159. data/vendor/PDCurses/sdl2/README.md +0 -34
  160. data/vendor/PDCurses/sdl2/deffont.h +0 -385
  161. data/vendor/PDCurses/sdl2/deficon.h +0 -23
  162. data/vendor/PDCurses/sdl2/pdcclip.c +0 -93
  163. data/vendor/PDCurses/sdl2/pdcdisp.c +0 -534
  164. data/vendor/PDCurses/sdl2/pdcgetsc.c +0 -30
  165. data/vendor/PDCurses/sdl2/pdckbd.c +0 -480
  166. data/vendor/PDCurses/sdl2/pdcscrn.c +0 -443
  167. data/vendor/PDCurses/sdl2/pdcsdl.h +0 -33
  168. data/vendor/PDCurses/sdl2/pdcsetsc.c +0 -67
  169. data/vendor/PDCurses/sdl2/pdcutil.c +0 -39
  170. data/vendor/PDCurses/sdl2/sdltest.c +0 -81
  171. data/vendor/PDCurses/term.h +0 -48
  172. data/vendor/PDCurses/version.mif +0 -7
  173. data/vendor/PDCurses/vt/CMakeLists.txt +0 -28
  174. data/vendor/PDCurses/vt/Makefile +0 -135
  175. data/vendor/PDCurses/vt/Makefile.bcc +0 -111
  176. data/vendor/PDCurses/vt/Makefile.dmc +0 -258
  177. data/vendor/PDCurses/vt/Makefile.vc +0 -144
  178. data/vendor/PDCurses/vt/Makefile.wcc +0 -107
  179. data/vendor/PDCurses/vt/README.md +0 -64
  180. data/vendor/PDCurses/vt/pdcclip.c +0 -20
  181. data/vendor/PDCurses/vt/pdcdisp.c +0 -284
  182. data/vendor/PDCurses/vt/pdcgetsc.c +0 -27
  183. data/vendor/PDCurses/vt/pdckbd.c +0 -394
  184. data/vendor/PDCurses/vt/pdcscrn.c +0 -434
  185. data/vendor/PDCurses/vt/pdcsetsc.c +0 -45
  186. data/vendor/PDCurses/vt/pdcutil.c +0 -43
  187. data/vendor/PDCurses/vt/pdcvt.h +0 -16
  188. data/vendor/PDCurses/watcom.mif +0 -68
  189. data/vendor/PDCurses/wincon/CMakeLists.txt +0 -27
  190. data/vendor/PDCurses/wincon/Makefile.bcc +0 -88
  191. data/vendor/PDCurses/wincon/Makefile.dmc +0 -256
  192. data/vendor/PDCurses/wincon/Makefile.lcc +0 -273
  193. data/vendor/PDCurses/wincon/Makefile.mng +0 -176
  194. data/vendor/PDCurses/wincon/Makefile.vc +0 -144
  195. data/vendor/PDCurses/wincon/Makefile.wcc +0 -51
  196. data/vendor/PDCurses/wincon/README.md +0 -85
  197. data/vendor/PDCurses/wincon/pdcclip.c +0 -174
  198. data/vendor/PDCurses/wincon/pdcdisp.c +0 -143
  199. data/vendor/PDCurses/wincon/pdcgetsc.c +0 -55
  200. data/vendor/PDCurses/wincon/pdckbd.c +0 -786
  201. data/vendor/PDCurses/wincon/pdcscrn.c +0 -717
  202. data/vendor/PDCurses/wincon/pdcsetsc.c +0 -91
  203. data/vendor/PDCurses/wincon/pdcurses.ico +0 -0
  204. data/vendor/PDCurses/wincon/pdcurses.rc +0 -28
  205. data/vendor/PDCurses/wincon/pdcutil.c +0 -41
  206. data/vendor/PDCurses/wincon/pdcwin.h +0 -31
  207. data/vendor/PDCurses/wingui/CMakeLists.txt +0 -27
  208. data/vendor/PDCurses/wingui/Makefile.bcc +0 -85
  209. data/vendor/PDCurses/wingui/Makefile.dmc +0 -259
  210. data/vendor/PDCurses/wingui/Makefile.lcc +0 -273
  211. data/vendor/PDCurses/wingui/Makefile.mng +0 -171
  212. data/vendor/PDCurses/wingui/Makefile.vc +0 -144
  213. data/vendor/PDCurses/wingui/Makefile.wcc +0 -51
  214. data/vendor/PDCurses/wingui/README.md +0 -93
  215. data/vendor/PDCurses/wingui/pdcclip.c +0 -174
  216. data/vendor/PDCurses/wingui/pdcdisp.c +0 -718
  217. data/vendor/PDCurses/wingui/pdcgetsc.c +0 -30
  218. data/vendor/PDCurses/wingui/pdckbd.c +0 -143
  219. data/vendor/PDCurses/wingui/pdcscrn.c +0 -2797
  220. data/vendor/PDCurses/wingui/pdcsetsc.c +0 -89
  221. data/vendor/PDCurses/wingui/pdcurses.ico +0 -0
  222. data/vendor/PDCurses/wingui/pdcurses.rc +0 -28
  223. data/vendor/PDCurses/wingui/pdcutil.c +0 -61
  224. data/vendor/PDCurses/wingui/pdcwin.h +0 -122
  225. data/vendor/PDCurses/x11/Makefile.in +0 -754
  226. data/vendor/PDCurses/x11/PDCurses.spec +0 -82
  227. data/vendor/PDCurses/x11/README.md +0 -62
  228. data/vendor/PDCurses/x11/ScrollBox.c +0 -319
  229. data/vendor/PDCurses/x11/ScrollBox.h +0 -51
  230. data/vendor/PDCurses/x11/ScrollBoxP.h +0 -70
  231. data/vendor/PDCurses/x11/aclocal.m4 +0 -994
  232. data/vendor/PDCurses/x11/big_icon.xbm +0 -46
  233. data/vendor/PDCurses/x11/compose.h +0 -201
  234. data/vendor/PDCurses/x11/config.guess +0 -1500
  235. data/vendor/PDCurses/x11/config.h.in +0 -100
  236. data/vendor/PDCurses/x11/config.sub +0 -1616
  237. data/vendor/PDCurses/x11/configure +0 -6700
  238. data/vendor/PDCurses/x11/configure.ac +0 -295
  239. data/vendor/PDCurses/x11/debian/changelog +0 -6
  240. data/vendor/PDCurses/x11/debian/compat +0 -1
  241. data/vendor/PDCurses/x11/debian/control +0 -11
  242. data/vendor/PDCurses/x11/debian/copyright +0 -27
  243. data/vendor/PDCurses/x11/debian/rules +0 -98
  244. data/vendor/PDCurses/x11/install-sh +0 -253
  245. data/vendor/PDCurses/x11/little_icon.xbm +0 -14
  246. data/vendor/PDCurses/x11/ncurses_cfg.h +0 -45
  247. data/vendor/PDCurses/x11/pdcclip.c +0 -173
  248. data/vendor/PDCurses/x11/pdcdisp.c +0 -85
  249. data/vendor/PDCurses/x11/pdcgetsc.c +0 -28
  250. data/vendor/PDCurses/x11/pdckbd.c +0 -104
  251. data/vendor/PDCurses/x11/pdcscrn.c +0 -258
  252. data/vendor/PDCurses/x11/pdcsetsc.c +0 -95
  253. data/vendor/PDCurses/x11/pdcutil.c +0 -52
  254. data/vendor/PDCurses/x11/pdcx11.c +0 -316
  255. data/vendor/PDCurses/x11/pdcx11.h +0 -191
  256. data/vendor/PDCurses/x11/sb.c +0 -155
  257. data/vendor/PDCurses/x11/x11.c +0 -3686
  258. data/vendor/PDCurses/x11/xcurses-config.in +0 -81
@@ -1,327 +0,0 @@
1
- PDCurses Implementor's Guide
2
- ============================
3
-
4
- - Version 1.3 - 20??/??/?? - notes about official ports, new indentation
5
- style; markdown
6
- - Version 1.2 - 2007/07/11 - added PDC_init_pair(), PDC_pair_content(),
7
- version history; removed pdc_atrtab
8
- - Version 1.1 - 2007/06/06 - minor cosmetic change
9
- - Version 1.0 - 2007/04/01 - initial revision
10
-
11
- This document is for those wishing to port PDCurses to a new platform,
12
- or just wanting to better understand how it works. Nothing here should
13
- be needed for application programming; for that, refer to PDCurses.md,
14
- as built in doc/, or distributed as a file separate from this source
15
- package. This document assumes that you've read the user-level
16
- documentation and are very familiar with application-level curses
17
- programming.
18
-
19
- If you want to submit your port for possible inclusion into the main
20
- PDCurses distribution, please follow these guidelines:
21
-
22
- - Don't modify anything in the pdcurses directory or in other port
23
- directories. Don't modify curses.h or curspriv.h unless absolutely
24
- necessary. (And prefer modifying curspriv.h over curses.h.)
25
-
26
- - Use the same indentation style, naming and scope conventions as the
27
- existing code.
28
-
29
- - Release all your code to the public domain -- no copyright. Code
30
- under GPL, BSD, etc. will not be accepted.
31
-
32
-
33
- Data Structures
34
- ===============
35
-
36
- A port of PDCurses must provide acs_map[], a 128-element array of
37
- chtypes, with values laid out based on the Alternate Character Set of
38
- the VT100 (see curses.h). PDC_transform_line() must use this table; when
39
- it encounters a chtype with the A_ALTCHARSET flag set, and an A_CHARTEXT
40
- value in the range 0-127, it must render it using the A_CHARTEXT portion
41
- of the corresponding value from this table, instead of the original
42
- value. Also, values may be read from this table by apps, and passed
43
- through functions such as waddch(), which does no special processing on
44
- control characters (0-31 and 127) when the A_ALTCHARSET flag is set.
45
- Thus, any control characters used in acs_map[] should also have the
46
- A_ALTCHARSET flag set. Implementations should provide suitable values
47
- for all the ACS_ macros defined in curses.h; other values in the table
48
- should be filled with their own indices (e.g., acs_map['E'] == 'E'). The
49
- table can be either hardwired, or filled by PDC_scr_open(). Existing
50
- ports define it in pdcdisp.c, but this is not required.
51
-
52
-
53
- Functions
54
- =========
55
-
56
- A port of PDCurses must implement the following functions, with extern
57
- scope. These functions are traditionally divided into several modules,
58
- as indicated below; this division is not required (only the functions
59
- are), but may make it easier to follow for someone familiar with the
60
- existing ports.
61
-
62
- Any other functions you create as part of your implementation should
63
- have static scope, if possible. If they can't be static, they should be
64
- named with the "PDC_" prefix. This minimizes the risk of collision with
65
- an application's choices.
66
-
67
- Current PDCurses style also uses a single leading underscore with the
68
- name of any static function; and modified BSD/Allman-style indentation,
69
- approximately equivalent to "indent -kr -nut -bl -bli0", with
70
- adjustments to keep every line under 80 columns.
71
-
72
-
73
- pdcdisp.c:
74
- ----------
75
-
76
- ### void PDC_gotoyx(int y, int x);
77
-
78
- Move the physical cursor (as opposed to the logical cursor affected by
79
- wmove()) to the given location. This is called mainly from doupdate().
80
- In general, this function need not compare the old location with the new
81
- one, and should just move the cursor unconditionally.
82
-
83
- ### void PDC_transform_line(int lineno, int x, int len, const chtype *srcp);
84
-
85
- The core output routine. It takes len chtype entities from srcp (a
86
- pointer into curscr) and renders them to the physical screen at line
87
- lineno, column x. It must also translate characters 0-127 via acs_map[],
88
- if they're flagged with A_ALTCHARSET in the attribute portion of the
89
- chtype.
90
-
91
-
92
- pdcgetsc.c:
93
- -----------
94
-
95
- ### int PDC_get_columns(void);
96
-
97
- Returns the size of the screen in columns. It's used in resize_term() to
98
- set the new value of COLS. (Some existing implementations also call it
99
- internally from PDC_scr_open(), but this is not required.)
100
-
101
- ### int PDC_get_cursor_mode(void);
102
-
103
- Returns the size/shape of the cursor. The format of the result is
104
- unspecified, except that it must be returned as an int. This function is
105
- called from initscr(), and the result is stored in SP->orig_cursor,
106
- which is used by PDC_curs_set() to determine the size/shape of the
107
- cursor in normal visibility mode (curs_set(1)).
108
-
109
- ### int PDC_get_rows(void);
110
-
111
- Returns the size of the screen in rows. It's used in resize_term() to
112
- set the new value of LINES. (Some existing implementations also call it
113
- internally from PDC_scr_open(), but this is not required.)
114
-
115
-
116
- pdckbd.c:
117
- ---------
118
-
119
- ### bool PDC_check_key(void);
120
-
121
- Keyboard/mouse event check, called from wgetch(). Returns TRUE if
122
- there's an event ready to process. This function must be non-blocking.
123
-
124
- ### void PDC_flushinp(void);
125
-
126
- This is the core of flushinp(). It discards any pending key or mouse
127
- events, removing them from any internal queue and from the OS queue, if
128
- applicable.
129
-
130
- ### int PDC_get_key(void);
131
-
132
- Get the next available key, or mouse event (indicated by a return of
133
- KEY_MOUSE), and remove it from the OS' input queue, if applicable. This
134
- function is called from wgetch(). This function may be blocking, and
135
- traditionally is; but it need not be. If a valid key or mouse event
136
- cannot be returned, for any reason, this function returns -1. Valid keys
137
- are those that fall within the appropriate character set, or are in the
138
- list of special keys found in curses.h (KEY_MIN through KEY_MAX). When
139
- returning a special key code, this routine must also set SP->key_code to
140
- TRUE; otherwise it must set it to FALSE. If SP->return_key_modifiers is
141
- TRUE, this function may return modifier keys (shift, control, alt),
142
- pressed alone, as special key codes; if SP->return_key_modifiers is
143
- FALSE, it must not. If modifier keys are returned, it should only happen
144
- if no other keys were pressed in the meantime; i.e., the return should
145
- happen on key up. But if this is not possible, it may return the
146
- modifier keys on key down (if and only if SP->return_key_modifiers is
147
- TRUE).
148
-
149
- ### int PDC_modifiers_set(void);
150
-
151
- Called from PDC_return_key_modifiers(). If your platform needs to do
152
- anything in response to a change in SP->return_key_modifiers, do it
153
- here. Returns OK or ERR, which is passed on by the caller.
154
-
155
- ### int PDC_mouse_set(void);
156
-
157
- Called by mouse_set(), mouse_on(), and mouse_off() -- all the functions
158
- that modify SP->_trap_mbe. If your platform needs to do anything in
159
- response to a change in SP->_trap_mbe (for example, turning the mouse
160
- cursor on or off), do it here. Returns OK or ERR, which is passed on by
161
- the caller.
162
-
163
- ### void PDC_set_keyboard_binary(bool on);
164
-
165
- Set keyboard input to "binary" mode. If you need to do something to keep
166
- the OS from processing ^C, etc. on your platform, do it here. TRUE turns
167
- the mode on; FALSE reverts it. This function is called from raw() and
168
- noraw().
169
-
170
-
171
- pdcscrn.c:
172
- ----------
173
-
174
- ### bool PDC_can_change_color(void);
175
-
176
- Returns TRUE if init_color() and color_content() give meaningful
177
- results, FALSE otherwise. Called from can_change_color().
178
-
179
- ### int PDC_color_content(short color, short *red, short *green, short *blue);
180
-
181
- The core of color_content(). This does all the work of that function,
182
- except checking for values out of range and null pointers.
183
-
184
- ### int PDC_init_color(short color, short red, short green, short blue);
185
-
186
- The core of init_color(). This does all the work of that function,
187
- except checking for values out of range.
188
-
189
- ### void PDC_init_pair(short pair, short fg, short bg);
190
-
191
- The core of init_pair(). This does all the work of that function, except
192
- checking for values out of range. The values passed to this function
193
- should be returned by a call to PDC_pair_content() with the same pair
194
- number. PDC_transform_line() should use the specified colors when
195
- rendering a chtype with the given pair number.
196
-
197
- ### int PDC_pair_content(short pair, short *fg, short *bg);
198
-
199
- The core of pair_content(). This does all the work of that function,
200
- except checking for values out of range and null pointers.
201
-
202
- ### void PDC_reset_prog_mode(void);
203
-
204
- The non-portable functionality of reset_prog_mode() is handled here --
205
- whatever's not done in _restore_mode(). In current ports: In OS/2, this
206
- sets the keyboard to binary mode; in Win32, it enables or disables the
207
- mouse pointer to match the saved mode; in others it does nothing.
208
-
209
- ### void PDC_reset_shell_mode(void);
210
-
211
- The same thing, for reset_shell_mode(). In OS/2 and Win32, it restores
212
- the default console mode; in others it does nothing.
213
-
214
- ### int PDC_resize_screen(int nlines, int ncols);
215
-
216
- This does the main work of resize_term(). It may respond to non-zero
217
- parameters, by setting the screen to the specified size; to zero
218
- parameters, by setting the screen to a size chosen by the user at
219
- runtime, in an unspecified way (e.g., by dragging the edges of the
220
- window); or both. It may also do nothing, if there's no appropriate
221
- action for the platform.
222
-
223
- ### void PDC_restore_screen_mode(int i);
224
-
225
- Called from _restore_mode() in kernel.c, this function does the actual
226
- mode changing, if applicable. Currently used only in DOS and OS/2.
227
-
228
- ### void PDC_save_screen_mode(int i);
229
-
230
- Called from _save_mode() in kernel.c, this function saves the actual
231
- screen mode, if applicable. Currently used only in DOS and OS/2.
232
-
233
- ### void PDC_scr_close(void);
234
-
235
- The platform-specific part of endwin(). It may restore the image of the
236
- original screen saved by PDC_scr_open(), if the PDC_RESTORE_SCREEN
237
- environment variable is set; either way, if using an existing terminal,
238
- this function should restore it to the mode it had at startup, and move
239
- the cursor to the lower left corner. (The X11 port does nothing.)
240
-
241
- ### void PDC_scr_free(void);
242
-
243
- Frees the memory for SP allocated by PDC_scr_open(). Called by
244
- delscreen().
245
-
246
- ### int PDC_scr_open(int argc, char **argv);
247
-
248
- The platform-specific part of initscr(). It's actually called from
249
- Xinitscr(); the arguments, if present, correspond to those used with
250
- main(), and may be used to set the title of the terminal window, or for
251
- other, platform-specific purposes. (The arguments are currently used
252
- only in X11.) PDC_scr_open() must allocate memory for SP, and must
253
- initialize acs_map[] (unless it's preset) and several members of SP,
254
- including lines, cols, mouse_wait, orig_attr (and if orig_attr is TRUE,
255
- orig_fore and orig_back), mono, _restore and _preserve. (Although SP is
256
- used the same way in all ports, it's allocated here in order to allow
257
- the X11 port to map it to a block of shared memory.) If using an
258
- existing terminal, and the environment variable PDC_RESTORE_SCREEN is
259
- set, this function may also store the existing screen image for later
260
- restoration by PDC_scr_close().
261
-
262
-
263
- pdcsetsc.c:
264
- -----------
265
-
266
- ### int PDC_curs_set(int visibility);
267
-
268
- Called from curs_set(). Changes the appearance of the cursor -- 0 turns
269
- it off, 1 is normal (the terminal's default, if applicable, as
270
- determined by SP->orig_cursor), and 2 is high visibility. The exact
271
- appearance of these modes is not specified.
272
-
273
-
274
- pdcutil.c:
275
- ----------
276
-
277
- ### void PDC_beep(void);
278
-
279
- Emits a short audible beep. If this is not possible on your platform,
280
- you must set SP->audible to FALSE during initialization (i.e., from
281
- PDC_scr_open() -- not here); otherwise, set it to TRUE. This function is
282
- called from beep().
283
-
284
- ### void PDC_napms(int ms);
285
-
286
- This is the core delay routine, called by napms(). It pauses for about
287
- (the X/Open spec says "at least") ms milliseconds, then returns. High
288
- degrees of accuracy and precision are not expected (though desirable, if
289
- you can achieve them). More important is that this function gives back
290
- the process' time slice to the OS, so that PDCurses idles at low CPU
291
- usage.
292
-
293
- ### const char *PDC_sysname(void);
294
-
295
- Returns a short string describing the platform, such as "DOS" or "X11".
296
- This is used by longname(). It must be no more than 100 characters; it
297
- should be much, much shorter (existing platforms use no more than 5).
298
-
299
-
300
- More functions
301
- ==============
302
-
303
- The following functions are implemented in the platform directories, but
304
- are accessed directly by apps. Refer to the user documentation for their
305
- descriptions:
306
-
307
-
308
- pdcclip.c:
309
- ----------
310
-
311
- ### int PDC_clearclipboard(void);
312
- ### int PDC_freeclipboard(char *contents);
313
- ### int PDC_getclipboard(char **contents, long *length);
314
- ### int PDC_setclipboard(const char *contents, long length);
315
-
316
-
317
- pdckbd.c:
318
- ---------
319
-
320
- ### unsigned long PDC_get_input_fd(void);
321
-
322
-
323
- pdcsetsc.c:
324
- -----------
325
-
326
- ### int PDC_set_blink(bool blinkon);
327
- ### void PDC_set_title(const char *title);
@@ -1,27 +0,0 @@
1
- # Make archives for distribution
2
-
3
- include version.mif
4
-
5
- PDC_DIR=PDCurses-$(VERDOT)
6
-
7
- ZIPFILE = pdcurs$(VER).zip
8
- TARBALL = $(PDC_DIR).tar.gz
9
-
10
- all:
11
- @echo Look in folders for platform-specific build instructions.
12
-
13
- manual:
14
- cd man; $(MAKE) $(MFLAGS) $@
15
-
16
- $(ZIPFILE):
17
- zip -9ory $(ZIPFILE) *
18
-
19
- zip: $(ZIPFILE)
20
-
21
- ../$(TARBALL):
22
- (cd ..; tar cvf - $(PDC_DIR)/* | gzip -9 > $(TARBALL))
23
-
24
- dist: ../$(TARBALL)
25
-
26
- rpm: ../$(TARBALL)
27
- rpmbuild -ba x11/PDCurses.spec
@@ -1,77 +0,0 @@
1
- Welcome to PDCurses!
2
- ====================
3
-
4
- Public Domain Curses, aka PDCurses, is an implementation of X/Open
5
- curses for multiple platforms. Relative to the 'official' PDCurses
6
- project, this has a variety of improvements, adding a Windows GUI
7
- and a VT-like console "flavor" of Curses and expanding the
8
- capabilities of the other flavors (SDL1, SDL2, X11, Win32 console,
9
- OS/2, and DOS). Some details and screen shots at
10
-
11
- https://www.projectpluto.com/win32a.htm
12
-
13
- Much of this was done during a long period in which 'official'
14
- PDCurses was inactive. It is hoped that the changes in this fork
15
- can be merged into the 'official' PDCurses, and a pull request has
16
- been made. But the split is looking increasingly permanent.
17
-
18
- Legal Stuff
19
- -----------
20
-
21
- The core package is in the public domain, but small portions of PDCurses
22
- are subject to copyright under various licenses. Each directory
23
- contains a README file, with a section titled "Distribution Status"
24
- which describes the status of the files in that directory.
25
-
26
- If you use PDCurses in an application, an acknowledgement would be
27
- appreciated, but is not mandatory. If you make corrections or
28
- enhancements to PDCurses, please forward them to the current maintainer
29
- for the benefit of other users.
30
-
31
- This software is provided AS IS with NO WARRANTY whatsoever.
32
-
33
-
34
- Ports
35
- -----
36
-
37
- PDCurses has been ported to DOS, OS/2, Win32, X11 and SDL1 and SDL2,
38
- and this version adds a Windows graphical and VT-like console
39
- flavor. A directory containing the port-specific source files exists
40
- for each of these platforms.
41
-
42
- Build instructions are in the README file for each platform:
43
-
44
- - [DOS](dos/README.md) for use on DOS
45
- - [OS/2](os2/README.md) for use on OS/2
46
- - [SDL 1.x](sdl1/README.md) for use as separate SDL version 1 window
47
- - [SDL 2.x](sdl2/README.md) for use as separate SDL version 2 window
48
- - [wincon](wincon/README.md) (formerly win32) for use on Windows Console
49
- - [WinGUI](wingui/README.md) for use on Windows Graphics Mode
50
- - [X11](x11/README.md) (also called XCurses) for use as separate X11 window
51
- - [VT](vt/README.md) for use on terminal
52
-
53
- Distribution Status
54
- -------------------
55
-
56
- All files in this directory except configure, config.guess and
57
- config.sub are released to the Public Domain. config.guess and
58
- config.sub are under the GPL; configure is under a free license
59
- described within it.
60
-
61
- Build Status
62
- -------------------
63
-
64
- PDCurses is automatically build in multiple environments:
65
-
66
- [![Build status Travis-CI](https://api.travis-ci.com/Bill-Gray/PDCurses.svg?branch=master)](https://travis-ci.com/Bill-Gray/PDCurses)
67
- , also providing artifacts: [![Build status Appveyor](https://ci.appveyor.com/api/projects/status/github/Bill-Gray/PDCurses?branch=master&svg=true)](https://ci.appveyor.com/project/Bill-Gray/PDCurses)
68
-
69
-
70
- Maintainer
71
- ----------
72
-
73
- William McBrine <wmcbrine@gmail.com> ("official" PDCurses)
74
-
75
- Bill Gray
76
- p&#x202e;&ocirc;&#xe7;.&ouml;tulp&#x165;c&eacute;j&ocirc;&#x159;p&#x40;ot&uacute;l&#x202c;m
77
- (this fork)