diff --git a/graphics/pdcurs34/HISTORY b/graphics/pdcurs34/HISTORY index 7f897fbd2..761f6dabb 100644 --- a/graphics/pdcurs34/HISTORY +++ b/graphics/pdcurs34/HISTORY @@ -1,8 +1,8 @@ PDCurses 3.4 - 2008/09/08 ========================= -Nothing much new this time, but I've been sitting on some bug fixes for -almost a year, so it's overdue. Apart from bugs, the main changes are in +Nothing much new this time, but I've been sitting on some bug fixes for +almost a year, so it's overdue. Apart from bugs, the main changes are in the documentation. New features: @@ -11,11 +11,11 @@ New features: Bug fixes and such: -- In x11, the xc_atrtab table size was under-calculated by half, - resulting in crashes at (oddly) certain line counts. (It should've +- In x11, the xc_atrtab table size was under-calculated by half, + resulting in crashes at (oddly) certain line counts. (It should've crashed a lot more.) Reported by Mark Hessling. -- Test for moved cursor was omitting the window origin offset. Reported +- Test for moved cursor was omitting the window origin offset. Reported by Carey Evans. - Is DOS and OS/2, the value for max items in key_table was still wrong. @@ -23,9 +23,9 @@ Bug fixes and such: - Changed isendwin() so it won't crash after delscreen(). -- Ensure zero-termination in PDC_mbstowcs() and PDC_wcstombs(). +- Ensure zero-termination in PDC_mbstowcs() and PDC_wcstombs(). -- Disable QuickEdit Mode when enabling mouse input for the Win32 +- Disable QuickEdit Mode when enabling mouse input for the Win32 console; reported by "Zalapkrakna". - Fix for building under Innotek C (I hope). Report by Elbert Pol, fix @@ -42,7 +42,7 @@ Bug fixes and such: - Export the terminfo stub functions from the DLLs, too. -- Added support for Apple's ".dylib" in configure. Suggested by Marc +- Added support for Apple's ".dylib" in configure. Suggested by Marc Vaillant (who says it's needed with OS 10.5.) - In sdl1/Makefile.mng, ensure that CC is set. @@ -53,9 +53,9 @@ Bug fixes and such: old version (?) of MinGW. So, revert to spelling out "tuidemo.o tui.o". Reported by "Howard L." -- Extensive documentation revision and reorganizing. More to do here. - For example, I moved the build instructions from INSTALL (which never - really described installation) to the platform-specific READMEs. +- Extensive documentation revision and reorganizing. More to do here. + For example, I moved the build instructions from INSTALL (which never + really described installation) to the platform-specific READMEs. - New indentation standard: four spaces, no tabs. @@ -64,7 +64,7 @@ Bug fixes and such: PDCurses 3.3 - 2007/07/11 ========================= -This release adds an SDL backend, refines the demos, and is faster in +This release adds an SDL backend, refines the demos, and is faster in some cases. New features: @@ -101,7 +101,7 @@ New features: Bug fixes and such: -- Implicit wrefresh() needs to be called from wgetch() when the window's +- Implicit wrefresh() needs to be called from wgetch() when the window's cursor position is changed, even if there are no other changes. - Set SP->audible on a per-platform basis, as was documented in @@ -126,7 +126,7 @@ Bug fixes and such: - Building the Win32 DLL with MinGW or Cygwin wouldn't work from outside the platform directory. -- Building the X11 port with Cygwin required manually editing the +- Building the X11 port with Cygwin required manually editing the Makefile after configuring; no longer. Reported by Warren W. Gay. - Minor tightening of configure and makefiles. @@ -150,7 +150,7 @@ Bug fixes and such: PDCurses 3.2 - 2007/06/06 ========================= -This release mainly covers changes to the build process, along with a +This release mainly covers changes to the build process, along with a few structural changes. New features: @@ -193,7 +193,7 @@ Bug fixes and such: curses.dll, builds either the static library or the DLL (not both at once), and links all the demos with the DLL when building it. -- In Win32, read the registry only when needed: when init_color() or +- In Win32, read the registry only when needed: when init_color() or color_content() is called, instead of at startup. - A few additional consts in declarations. @@ -206,7 +206,7 @@ Bug fixes and such: - Simplified Borland makefiles. - Makefile.aix.in depended on a file, xcurses.exp, that was never there. - This problem was fixed as part of the change to common .def files; + This problem was fixed as part of the change to common .def files; however, I still haven't been able to test building on AIX. ------------------------------------------------------------------------ @@ -241,9 +241,9 @@ Bug fixes and such: PDC_reset_shell_mode(), so it's properly turned off when returning from an endwin(). -- In 3.0, selection in X11 didn't work. (Well, the selecting worked, but - the pasting elsewhere didn't.) This was due to the attempted fix - "don't return selection start as a press event," so that's been +- In 3.0, selection in X11 didn't work. (Well, the selecting worked, but + the pasting elsewhere didn't.) This was due to the attempted fix + "don't return selection start as a press event," so that's been reverted for now. - PDC_setclipboard() was locking up in X11. Reported by Mark Hessling. @@ -265,7 +265,7 @@ Bug fixes and such: only shows up if the file is included multiple times, and then only in C++. Reported on the DOSBox forums. -- Use CF_OEMTEXT instead of CF_TEXT in the narrow versions of the +- Use CF_OEMTEXT instead of CF_TEXT in the narrow versions of the clipboard functions in Win32, to match the console. - Changed the format of the string returned from longname(). @@ -285,10 +285,10 @@ Bug fixes and such: PDCurses 3.0 - 2007/04/01 ========================= -The focuses for this release are X/Open conformance, i18n, better color +The focuses for this release are X/Open conformance, i18n, better color support, cleaner code, and more consistency across platforms. -This is only a brief summary of the changes. For more details, consult +This is only a brief summary of the changes. For more details, consult the CVS log. New features: @@ -305,15 +305,15 @@ New features: this way, the internal compose key support is disabled in favor of XIM's, which is a lot more complete, although you lose the box cursor. -- Multibyte character support in the non-wide string handling functions, - per X/Open. This only works when the library is built with wide- +- Multibyte character support in the non-wide string handling functions, + per X/Open. This only works when the library is built with wide- character support enabled. -- Mouse support for DOS and OS/2. The DOS version includes untested +- Mouse support for DOS and OS/2. The DOS version includes untested support for scroll wheels, via the "CuteMouse" driver. -- An ncurses-compatible mouse interface, which can work in parallel with - the traditional PDCurses mouse interface. See the man page (or +- An ncurses-compatible mouse interface, which can work in parallel with + the traditional PDCurses mouse interface. See the man page (or mouse.c) for details. - DOS and OS/2 can now return modifiers as keys, as in Win32 and X11. @@ -324,7 +324,7 @@ New features: background colors are used instead. On platforms where it can be changed, the mode is toggled by the new function PDC_set_blink(). PDCurses tries to set PDC_set_blink(false) at startup. (In Win32, it's - always set to false; in DOS, with other than an EGA or VGA card, it + always set to false; in DOS, with other than an EGA or VGA card, it can't be.) Also, COLORS is now set to 0 until start_color() is called. - Corresponding to the change in COLORS, COLOR_PAIRS is now 256. @@ -342,7 +342,7 @@ New features: - Added global int TABSIZE, after ncurses and Solaris curses; removed window-specific _tabsize. -- Logical extension to the wide-character slk_ funcs: slk_wlabel(), for +- Logical extension to the wide-character slk_ funcs: slk_wlabel(), for retrieving the label as a wide-character string. - A non-macro implementation of ncurses' wresize(). @@ -369,8 +369,8 @@ New features: - A new document, IMPLEMNT, describing PDCurses' internal functions for those wishing to port it to new platforms. -- Mark Hessling has released the X11 port to the public domain. - (However, x11/ScrollBox* retain their separate copyright and MIT-like +- Mark Hessling has released the X11 port to the public domain. + (However, x11/ScrollBox* retain their separate copyright and MIT-like license.) Bug fixes and such: @@ -389,7 +389,7 @@ Bug fixes and such: - Documentation revisions. -- When expanding control characters in addch() or insch(), retain the +- When expanding control characters in addch() or insch(), retain the attributes from the chtype. - Preserve the A_ALTCHARSET attribute in addch() and insch(). @@ -403,12 +403,12 @@ Bug fixes and such: line 6/7.) The shape is taken from SP->orig_cursor (the meaning of which is platform-specific). -- Stop updating the cursor position when the cursor is invisible (this - gives a huge performance boost in Win 9x); update the cursor position +- Stop updating the cursor position when the cursor is invisible (this + gives a huge performance boost in Win 9x); update the cursor position from curs_set() if changing from invisible to visible. -- Some tweaking of the behavior of def_prog_mode(), def_shell_mode(), - savetty(), reset_prog_mode(), reset_shell_mode() and resetty()... +- Some tweaking of the behavior of def_prog_mode(), def_shell_mode(), + savetty(), reset_prog_mode(), reset_shell_mode() and resetty()... still not quite right. - flash() was not implemented for Win32 or X. A portable implementation @@ -416,21 +416,21 @@ Bug fixes and such: old (DOS and OS/2) version, but this is only apparent on an extremely slow machine, such as an XT. -- In getstr(), backspacing on high-bit characters caused a double +- In getstr(), backspacing on high-bit characters caused a double backspace. -- hline() and vline() used an incorrect (off by one) interpretation of - _maxx and _maxy. If values of n greater than the max were specified, +- hline() and vline() used an incorrect (off by one) interpretation of + _maxx and _maxy. If values of n greater than the max were specified, these functions could access unallocated memory. -- innstr() is supposed to return the number of characters read, not just +- innstr() is supposed to return the number of characters read, not just OK or ERR. Reported by Mike Aubury. -- A proper implementation of insch() -- the PDC_chadd()-based version +- A proper implementation of insch() -- the PDC_chadd()-based version wasn't handling the control characters correctly. - Return ASCII and control key names from keyname() (problem revealed by - ncurses' movewindow test); also, per X/Open, return "UNKNOWN KEY" when + ncurses' movewindow test); also, per X/Open, return "UNKNOWN KEY" when appropriate, rather than "NO KEY NAME". - Turn off the cursor from leaveok(true), even in X11; leaveok(false) @@ -450,25 +450,25 @@ Bug fixes and such: - pair_content(0, ...) is valid. -- There was no check to ensure that the pnoutrefresh() window fit within +- There was no check to ensure that the pnoutrefresh() window fit within the screen. It now returns an ERR if it doesn't. -- In X11, resize_term() must be called with parameters (0, 0), and only +- In X11, resize_term() must be called with parameters (0, 0), and only when SP->resized is set, else it returns ERR. -- Copy _bkgd in resize_window(). Patch found on Frederic L. W. Meunier's +- Copy _bkgd in resize_window(). Patch found on Frederic L. W. Meunier's web site. - slk_clear() now removes the buttons completely, as in ncurses. - Use the current foreground color for the line attributes (underline, - left, right), unless PDC_set_line_color() is explicitly called. After - setting the line color, you can reset it to this mode via + left, right), unless PDC_set_line_color() is explicitly called. After + setting the line color, you can reset it to this mode via "PDC_set_line_color(-1)". - Removed non-macro implementations of COLOR_PAIR() and PAIR_NUMBER(). -- Dispensed with PDC_chadd() and PDC_chins() -- waddch() and winsch() +- Dispensed with PDC_chadd() and PDC_chins() -- waddch() and winsch() are now (again) the core functions. - Dropped or made static many obsolete, unused, and/or broken functions, @@ -478,21 +478,21 @@ Bug fixes and such: PDC_wunderline(), PDC_wleftline(), PDC_wrightline(), XCursesModifierPress() and XCurses_refresh_scrollbar(). -- Obsolete/unused defines: _BCHAR, _GOCHAR, _STOPCHAR, _PRINTCHAR +- Obsolete/unused defines: _BCHAR, _GOCHAR, _STOPCHAR, _PRINTCHAR _ENDLINE, _FULLWIN and _SCROLLWIN. -- Obsolete/unused elements of the WINDOW struct: _pmax*, _lastp*, +- Obsolete/unused elements of the WINDOW struct: _pmax*, _lastp*, _lasts*. - Obsolete/unused elements of the SCREEN struct: orgcbr, visible_cursor, sizeable, shell, blank, cursor, orig_emulation, font, orig_font, tahead, adapter, scrnmode, kbdinfo, direct_video, video_page, video_seg, video_ofs, bogus_adapter. (Some of these persist outside - the SCREEN struct, in the platform directories.) Added mouse_wait and + the SCREEN struct, in the platform directories.) Added mouse_wait and key_code. -- Removed all the EMALLOC stuff. Straight malloc calls were used - elsewhere; it was undocumented outside of comments in curspriv.h; and +- Removed all the EMALLOC stuff. Straight malloc calls were used + elsewhere; it was undocumented outside of comments in curspriv.h; and there are better ways to use a substitute malloc(). - Single mouse clicks are now reportable on all platforms (not just @@ -504,8 +504,8 @@ Bug fixes and such: - ALT-keypad input now works in Win32. -- In Win32, SetConsoleMode(ENABLE_WINDOW_INPUT) is not useful, and - appears to be the source of a four-year-old bug report (hanging in +- In Win32, SetConsoleMode(ENABLE_WINDOW_INPUT) is not useful, and + appears to be the source of a four-year-old bug report (hanging in THE) by Phil Smith. - Removed the PDC_THREAD_BUILD stuff, which has never worked. For the @@ -548,7 +548,7 @@ Bug fixes and such: since the key press. - In BIOS mode (in DOS), count successive identical output bytes, and - make only one BIOS call for all of them. This dramatically improves + make only one BIOS call for all of them. This dramatically improves performance. - The cursor position was not always updated correctly in BIOS mode. @@ -559,7 +559,7 @@ Bug fixes and such: - Better reporting of mouse events in testcurs. -- Blank out buffer and num before the scanw() test in testcurs, in case +- Blank out buffer and num before the scanw() test in testcurs, in case the user just hits enter or etc.; clear the screen after resizing. - Allow tuidemo to use the last line. @@ -567,7 +567,7 @@ Bug fixes and such: - Separate left/right modifier keys are now reported properly in Win32. (Everything was being reported as _R.) -- Attempts to redirect input in Win32 now cause program exit and an +- Attempts to redirect input in Win32 now cause program exit and an error message, instead of hanging. - Dropped support for the Microway NDP compiler. @@ -580,25 +580,25 @@ Bug fixes and such: - Complete export lists for DLLs. -- Simplified makefiles; moved common elements to .mif files; better +- Simplified makefiles; moved common elements to .mif files; better optimization; strip demos when possible. -- Changed makefile targets of "pdcurses.a/lib" and "panel.a/lib" to +- Changed makefile targets of "pdcurses.a/lib" and "panel.a/lib" to $(LIBCURSES) and $(LIBPANEL). Suggestion of Doug Kaufman. -- Changed "install" target in the makefile to a double-colon rule, to - get around a conflict with INSTALL on non-case-sensitive filesystems, +- Changed "install" target in the makefile to a double-colon rule, to + get around a conflict with INSTALL on non-case-sensitive filesystems, such as Mac OS X's HFS+. Reported by Douglas Godfrey et al. - Make PDCurses.man dependent on manext. Suggestion of Tiziano Mueller. -- Set up configure.ac so autoheader works; removed some obsolescent +- Set up configure.ac so autoheader works; removed some obsolescent macros. Partly the suggestion of T.M. - The X11 port now builds in the x11 directory (including the demos), as with other ports. -- The X11 port should now build on more 64-bit systems. Partly due to +- The X11 port should now build on more 64-bit systems. Partly due to M.H. - The default window title and icons for the X11 port are now "PDCurses" @@ -621,8 +621,8 @@ Bug fixes and such: PDCurses 2.8 - 2006/04/01 ========================= -As with the previous version, you should assume that apps linked against -older dynamic versions of the library won't work with this one until +As with the previous version, you should assume that apps linked against +older dynamic versions of the library won't work with this one until recompiled. New features: @@ -635,25 +635,25 @@ New features: before including curses.h (see xmas.c for an example). NOMACROS yields smaller but theoretically slower executables. -- New functions: vwprintw(), vwscanw(), vw_printw() and vw_scanw(). This - completes the list of X/Open 4.2 functions, except for those concerned - with attr_t and wide characters. Some (especially the terminfo/termcap +- New functions: vwprintw(), vwscanw(), vw_printw() and vw_scanw(). This + completes the list of X/Open 4.2 functions, except for those concerned + with attr_t and wide characters. Some (especially the terminfo/termcap functions) aren't yet fully fleshed out, though. -- Non-macro implementations for COLOR_PAIR(), PAIR_NUMBER(), getbkgd(), - mvgetnstr(), mvwgetnstr(), mvhline(), mvvline(), mvwhline(), and +- Non-macro implementations for COLOR_PAIR(), PAIR_NUMBER(), getbkgd(), + mvgetnstr(), mvwgetnstr(), mvhline(), mvvline(), mvwhline(), and mvwvline(). (The macros are still available, too.) -- newterm() works now, in a limited way -- the parameters are ignored, - and only the first invocation will work (i.e., only one SCREEN can be +- newterm() works now, in a limited way -- the parameters are ignored, + and only the first invocation will work (i.e., only one SCREEN can be used). -- start_color() works now -- which is to say, if you _don't_ call it, - you'll only get monochrome output. Also, without calling it, the - terminal's default colors will be used, where supported (currently - only in Win32). This is equivalent to the PDC_ORIGINAL_COLORS behavior - introduced in 2.7, except that _only_ the default colors will be used. - (PDC_ORIGINAL_COLORS is still available, if you want to combine the +- start_color() works now -- which is to say, if you _don't_ call it, + you'll only get monochrome output. Also, without calling it, the + terminal's default colors will be used, where supported (currently + only in Win32). This is equivalent to the PDC_ORIGINAL_COLORS behavior + introduced in 2.7, except that _only_ the default colors will be used. + (PDC_ORIGINAL_COLORS is still available, if you want to combine the use of specific colors and the default colors.) - New logic for termname() and longname(): termname() always returns @@ -661,41 +661,41 @@ New features: [COLOR/MONO]-YxX" (adapter is only defined for DOS and OS/2). This is the first time these functions return _anything_ in Win32. -- New installation method for XCurses: the header files are placed in a - subdirectory "xcurses" within the include directory, rather than being - renamed. (But the renamed xcurses.h and xpanel.h are also installed, +- New installation method for XCurses: the header files are placed in a + subdirectory "xcurses" within the include directory, rather than being + renamed. (But the renamed xcurses.h and xpanel.h are also installed, for backwards compatibility.) curspriv.h and term.h are now available, - and existing curses-based code need no longer be edited to use - XCurses' curses.h. And with no more need for explicit XCursesExit() - calls (see below), your code need not be changed at all to move from - another curses implementation to XCurses. It can be as simple as "gcc + and existing curses-based code need no longer be edited to use + XCurses' curses.h. And with no more need for explicit XCursesExit() + calls (see below), your code need not be changed at all to move from + another curses implementation to XCurses. It can be as simple as "gcc -I/usr/local/include/xcurses -lXCurses -oprogname progname.c". - Combined readme.* into this HISTORY file, and incorporated the old 1.x (PCcurses) history. -- New functionality for the testcurs demo: ACS character display; menu - support for PgUp, PgDn, Home and End; centered menu; and it can now +- New functionality for the testcurs demo: ACS character display; menu + support for PgUp, PgDn, Home and End; centered menu; and it can now be resized in X. - Added modified versions of the rain and worm demos from ncurses. Bug fixes and such: -- Big cleanup of dead and redundant code, including unneeded defines, +- Big cleanup of dead and redundant code, including unneeded defines, ifdefs, and structure elements. - flushinp() was not implemented for Win32. - resetty() was not restoring LINES and COLS. -- nonl() made '\n' print a line feed without carriage return. This was +- nonl() made '\n' print a line feed without carriage return. This was incorrect. - Removed bogus implementation of intrflush(). - The line-breakout optimization system, disabled by default in 2.7, is - removed in 2.8. It simply didn't work, and never has. (The typeahead() + removed in 2.8. It simply didn't work, and never has. (The typeahead() function remains, for compatibility, but does nothing.) - The declarations for the printw() and scanw() function families were @@ -711,8 +711,8 @@ Bug fixes and such: - XCURSES is now defined automatically if not DOS, OS2 or WIN32. -- The default icon for XCurses wasn't working (had to remove the focus - hint code to fix this). Also, the default title is now "XCurses" +- The default icon for XCurses wasn't working (had to remove the focus + hint code to fix this). Also, the default title is now "XCurses" instead of "main". - Incorrect dimensions (undercounting by two in each direction) were @@ -720,8 +720,8 @@ Bug fixes and such: - Scroll wheel events were not always correctly reported in X. -- 32 bits are enough for the "long" chtype, but 64 bits were used on a - 64-bit system, wasting memory. Now conditioned on _LP64. This could be +- 32 bits are enough for the "long" chtype, but 64 bits were used on a + 64-bit system, wasting memory. Now conditioned on _LP64. This could be faster, too. - The short, 16-bit chtype now works with XCurses. @@ -733,8 +733,8 @@ Bug fixes and such: - pair_content() takes a short. -- Replaced incorrect usages of attr_t with chtype. attr_t is still - typedef'd, for backwards compatibility. (It's supposed to be used for +- Replaced incorrect usages of attr_t with chtype. attr_t is still + typedef'd, for backwards compatibility. (It's supposed to be used for the WA_*-style functions, which PDCurses doesn't yet support.) - Added const where required by the spec, and in other appropriate @@ -744,10 +744,10 @@ Bug fixes and such: - Fixed poll() support in napms(). -- Various changes to the internal PDC_* functions -- don't depend on +- Various changes to the internal PDC_* functions -- don't depend on these, and don't use them unless you absolutely have to. -- Some routines accessed window structures in their variable +- Some routines accessed window structures in their variable declarations, _before_ checking for a NULL window pointer. - Dropped support for the undocumented PDC_FULL_DISPLAY, wtitle(), and @@ -757,13 +757,13 @@ Bug fixes and such: - Reduced unnecessary #include directives -- speeds up compilation. -- Fix for demos build in Borland/DOS -- the makefile in 2.7 didn't +- Fix for demos build in Borland/DOS -- the makefile in 2.7 didn't specify the memory model. Reported by Erwin Waterlander. -- Simplified the makefiles; e.g., some now build each demo in a single - step, and Watcom no longer uses demos.lnk. Also, the demo exes are now - stripped when possible; maximum compression used for archives built - by the makefiles; xcurses-config removed as part of "make distclean"; +- Simplified the makefiles; e.g., some now build each demo in a single + step, and Watcom no longer uses demos.lnk. Also, the demo exes are now + stripped when possible; maximum compression used for archives built + by the makefiles; xcurses-config removed as part of "make distclean"; and I tweaked optimization for some platforms. - Reverted to /usr/local/ as default installation directory for XCurses. @@ -955,31 +955,31 @@ BUGS FIXED: - Right Alt modifier now works like left Alt modifier under Win32 -- Add support for all libXaw replacement libraries with Scrollbar bug. - Note that for this to work, you still have to change the libXaw +- Add support for all libXaw replacement libraries with Scrollbar bug. + Note that for this to work, you still have to change the libXaw replacement libraries to fix the bug :-( -- Don't trap signals in XCurses if calling application has ignored them. +- Don't trap signals in XCurses if calling application has ignored them. Change by Frank Heckenbach. - Bug reports from Warren W. Gay: - Fix termattrs() to return A_REVERSE and A_BLINK on all platforms. - - Fix definition of getsyx() and setsyx() to be consistent with + - Fix definition of getsyx() and setsyx() to be consistent with ncurses. Bug 624424. - Fix definition of echo() and noecho(). Bug 625001. - Fix definition of keypad() and leaveok(). Bug 632653. - Missing panel_hidden() prototype. Bug 649320. -- Fixed bug with calling def_prog_mode(), resize_term(), +- Fixed bug with calling def_prog_mode(), resize_term(), reset_prog_mode(); the resize details were being lost. NEW FEATURES: -- Clipboard support now available on DOS platform, but handled +- Clipboard support now available on DOS platform, but handled internally to the currently running process. -- New X11 resource: textCursor, allows the text cursor to be specified - as a vertical bar, or the standard horizontal bar. Thanks to Frank +- New X11 resource: textCursor, allows the text cursor to be specified + as a vertical bar, or the standard horizontal bar. Thanks to Frank Heckenbach for the suggestion. NEW COMPILER SUPPORT: @@ -1007,7 +1007,7 @@ INTRODUCTION: - Add getbkgd() macro -- Add new PDC functions for adding underline, overline, leftline and +- Add new PDC functions for adding underline, overline, leftline and rightline - Add support for shifted keypad keys. @@ -1038,12 +1038,12 @@ INTRODUCTION: BUGS FIXED: -- Fix bug with getting Win32 clipboard contents. Added new +- Fix bug with getting Win32 clipboard contents. Added new PDC_freeclipboard() function. - Fix bug with halfdelay() -- Fix bug with mouse interrupting programs that are not trapping mouse +- Fix bug with mouse interrupting programs that are not trapping mouse events under Win32. - Fix return value from curs_set() @@ -1099,15 +1099,15 @@ NEW FUNCTIONS: - PDC_getclipboard() and PDC_setclipboard() for accessing the native clipboard (X11, Win32 and OS/2) -- PDC_set_title() for setting the title of the window (X11 and Win32 +- PDC_set_title() for setting the title of the window (X11 and Win32 only) - PDC_get_input_fd() for getting the file handle of the PDCurses input -- PDC_get_key_modifiers() for getting the keyboard modifier settings at +- PDC_get_key_modifiers() for getting the keyboard modifier settings at the time of the last (w)getch() -- Xinitscr() (only for X11 port) which allows standard X11 switches to +- Xinitscr() (only for X11 port) which allows standard X11 switches to be passed to the application NEW COMPILER SUPPORT: @@ -1126,7 +1126,7 @@ ACKNOWLEDGEMENTS: (for this release) Juan David Palomar for pointing out getnstr() was not implemented. William McBrine for fix to allow black/black as valid color pair. Peter Preus for pointing out the missing bccos2.mak file. - Laura Michaels for a couple of bug fixes and changes required to + Laura Michaels for a couple of bug fixes and changes required to support Mingw32 compiler. Frank Heckenbach for PDC_get_input_fd() and some portability fixes and the fixes for panel library. @@ -1157,8 +1157,8 @@ INTRODUCTION: - long chtype extended to non-Unix ports - The name of the statically built library is pdcurses.lib (or - pdcurses.a). The name of the DLL import library (where applicable) is + The name of the statically built library is pdcurses.lib (or + pdcurses.a). The name of the DLL import library (where applicable) is curses.lib. BUGS FIXED: @@ -1203,7 +1203,7 @@ ACKNOWLEDGEMENTS: (for this release) Kim Huron for the slk..() functions. Florian Grosse Coosmann for some bug fixes. Esa Peuha for reducing compiler warnings. - Augustin Martin Domingo for patches to X11 port to enable accented + Augustin Martin Domingo for patches to X11 port to enable accented characters. ------------------------------------------------------------------------ @@ -1215,18 +1215,18 @@ INTRODUCTION: This release of PDCurses has includes a number of major changes: -- The portable library functions are now grouped together into single +- The portable library functions are now grouped together into single files with the same arrangement as System V R4 curses. -- A panels library has been included. This panels library was written by +- A panels library has been included. This panels library was written by Warren Tucker. -- Quite a few more functions have been supplied by Wade Schauer and - incorporated into release 2.2. Wade also supplied the support for the +- Quite a few more functions have been supplied by Wade Schauer and + incorporated into release 2.2. Wade also supplied the support for the Microway NDP C/C++ 32 bit DOS compiler. -- The curses datatype has been changed from an unsigned int to a long. - This allows more attributes to be stored as well as increasing the +- The curses datatype has been changed from an unsigned int to a long. + This allows more attributes to be stored as well as increasing the number of color-pairs from 32 to 64. - Xwindows port (experimental at the moment). @@ -1235,52 +1235,52 @@ BUGS FIXED: - mvwin() checked the wrong coordinates -- removed DESQview shadow memory buffer checking bug in curses.h in +- removed DESQview shadow memory buffer checking bug in curses.h in #define for wstandout() - lots of others I can't remember NEW FUNCTIONS: -- Too many to mention. See intro.man for a complete list of the +- Too many to mention. See intro.man for a complete list of the functions PDCurses now supports. COMPILER SUPPORT: -- DJGPP 1.12 is now supported. The run-time error that caused programs +- DJGPP 1.12 is now supported. The run-time error that caused programs to crash has been removed. -- emx 0.9a is supported. A program compiled for OS/2 should also work - under DOS if you use the VID=EMX switch when compiling. See the +- emx 0.9a is supported. A program compiled for OS/2 should also work + under DOS if you use the VID=EMX switch when compiling. See the makefile for details. -- The Microway NDP C/C++ DOS compiler is now supported. Thanks to Wade +- The Microway NDP C/C++ DOS compiler is now supported. Thanks to Wade Schauer for this port. -- The Watcom C++ 10.0 DOS compiler is now supported. Thanks to Pieter +- The Watcom C++ 10.0 DOS compiler is now supported. Thanks to Pieter Kunst for this port. -- The library now has many functions grouped together to reduce the size +- The library now has many functions grouped together to reduce the size of the library and to improve the speed of compilation. -- The "names" of a couple of the compilers in the makefile has changed; +- The "names" of a couple of the compilers in the makefile has changed; CSET2 is now ICC and GO32 is now GCC. EXTRA OPTIONS: - One difference between the behavior of PDCurses and Unix curses is the - attributes that are displayed when a character is cleared. Under Unix - curses, no attributes are displayed, so the result is always black. - Under PDCurses, these functions clear with the current attributes in - effect at the time. With the introduction of the bkgd functions, by - default, PDCurses clears using the value set by (w)bkgd(). To have - PDCurses behave the same way as it did before release 2.2, compile with + One difference between the behavior of PDCurses and Unix curses is the + attributes that are displayed when a character is cleared. Under Unix + curses, no attributes are displayed, so the result is always black. + Under PDCurses, these functions clear with the current attributes in + effect at the time. With the introduction of the bkgd functions, by + default, PDCurses clears using the value set by (w)bkgd(). To have + PDCurses behave the same way as it did before release 2.2, compile with -DPDCURSES_WCLR ACKNOWLEDGEMENTS: (for this release) - Pieter Kunst, David Nugent, Warren Tucker, Darin Haugen, Stefan Strack, - Wade Schauer and others who either alerted me to bugs or supplied + Pieter Kunst, David Nugent, Warren Tucker, Darin Haugen, Stefan Strack, + Wade Schauer and others who either alerted me to bugs or supplied fixes. ------------------------------------------------------------------------ @@ -1290,45 +1290,45 @@ PDCurses 2.1 - 1993/06/20 INTRODUCTION: - The current code contains bug fixes for the DOS and OS/2 releases and - also includes an alpha release for Unix. The Unix release uses another - public domain package (mytinfo) to handle the low-level screen writes. - mytinfo was posted to comp.sources.unix (or misc) in December 1992 or - January 1993. Unless you are a glutton for punishment I would recommend + The current code contains bug fixes for the DOS and OS/2 releases and + also includes an alpha release for Unix. The Unix release uses another + public domain package (mytinfo) to handle the low-level screen writes. + mytinfo was posted to comp.sources.unix (or misc) in December 1992 or + January 1993. Unless you are a glutton for punishment I would recommend you avoid the Unix port at this stage. - The other major addition to PDCurses is the support for DJGPP (the DOS + The other major addition to PDCurses is the support for DJGPP (the DOS port of GNU C++). Thanks to David Nugent . - Other additions are copywin() function, function debugging support and - getting the small and medium memory models to work. The testcurs.c demo - program has also been changed significantly and a new demo program, + Other additions are copywin() function, function debugging support and + getting the small and medium memory models to work. The testcurs.c demo + program has also been changed significantly and a new demo program, tuidemo, has been added. - Some people have suggested including information on where to get dmake + Some people have suggested including information on where to get dmake from. oak.oakland.edu in /pub/msdos/c OTHER NOTES: - Under DOS, by default, screen writes to a CGA monitor are done via the - video BIOS rather than by direct video memory writes. This is due to - the CGA "snow" problem. If you have a CGA monitor and do not suffer - from snow, you can compile private\_queryad.c with CGA_DIRECT defined. - This will then use cause PDCurses to write directly to the CGA video + Under DOS, by default, screen writes to a CGA monitor are done via the + video BIOS rather than by direct video memory writes. This is due to + the CGA "snow" problem. If you have a CGA monitor and do not suffer + from snow, you can compile private\_queryad.c with CGA_DIRECT defined. + This will then use cause PDCurses to write directly to the CGA video memory. - Function debugging: Firstly to get function debugging, you have to - compile the library with OPT=N in the makefile. This also turns on - compiler debugging. You can control when you want PDCurses to write to - the debug file (called trace in the current directory) by using the + Function debugging: Firstly to get function debugging, you have to + compile the library with OPT=N in the makefile. This also turns on + compiler debugging. You can control when you want PDCurses to write to + the debug file (called trace in the current directory) by using the functions traceon() and traceoff() in your program. Microsoft C 6.00 Users note: ---------------------------- - With the addition of several new functions, using dmake to compile - PDCurses now causes the compiler to run "out of heap space in pass 2". - Using the 6.00AX version (DOS-Extended) to compile PDCurses fixes this + With the addition of several new functions, using dmake to compile + PDCurses now causes the compiler to run "out of heap space in pass 2". + Using the 6.00AX version (DOS-Extended) to compile PDCurses fixes this problem; hence the -EM switch. Functional changes @@ -1336,29 +1336,29 @@ OTHER NOTES: Added OS/2 DLL support. - A few curses functions have been fixed to exhibit their correct - behavior and make them more functionally portable with System V - curses. The functions that have changed are overlay(), overwrite() and + A few curses functions have been fixed to exhibit their correct + behavior and make them more functionally portable with System V + curses. The functions that have changed are overlay(), overwrite() and typeahead. overlay() and overwrite() - Both of theses functions in PDCurses 2.0 allowed for one window to be - effectively placed on top of another, and the characters in the first - window were overlaid or overwritten starting at 0,0 in both windows. - This behavior of these functions was not correct. These functions only - operate on windows that physically overlap with respect to the - displayed screen. To achieve the same functionality as before, use the + Both of theses functions in PDCurses 2.0 allowed for one window to be + effectively placed on top of another, and the characters in the first + window were overlaid or overwritten starting at 0,0 in both windows. + This behavior of these functions was not correct. These functions only + operate on windows that physically overlap with respect to the + displayed screen. To achieve the same functionality as before, use the new function copywin(). See the manual page for further details. typeahead() - This function in PDCurses 2.0 effectively checked to see if there were - any characters remaining in the keyboard buffer. This is not the - behavior exhibited by System V curses. This function is intended - purely to set a flag so that curses can check while updating the - physical screen if any keyboard input is pending. To achieve the same - effect with typeahead() under PDCurses 2.1 the following code should be + This function in PDCurses 2.0 effectively checked to see if there were + any characters remaining in the keyboard buffer. This is not the + behavior exhibited by System V curses. This function is intended + purely to set a flag so that curses can check while updating the + physical screen if any keyboard input is pending. To achieve the same + effect with typeahead() under PDCurses 2.1 the following code should be used. In place of... @@ -1380,7 +1380,7 @@ OTHER NOTES: ACKNOWLEDGEMENTS: (in no particular order) - Jason Shumate, Pieter Kunst, David Nugent, Andreas Otte, Pasi + Jason Shumate, Pieter Kunst, David Nugent, Andreas Otte, Pasi Hamalainen, James McLennan, Duane Paulson, Ib Hojme Apologies to anyone I may have left out. @@ -1394,37 +1394,37 @@ INTRODUCTION: Well, here it finally is; PDCurses v2.0. - PDCurses v2.0 is an almost total rewrite of PCcurses 1.4 done by John - 'Frotz' Fa'atuai, the previous maintainer. It adds support for OS/2 as + PDCurses v2.0 is an almost total rewrite of PCcurses 1.4 done by John + 'Frotz' Fa'atuai, the previous maintainer. It adds support for OS/2 as well as DOS. - This version has been tested with Microsoft C v6.0, QuickC v2.0 and - Borland C++ 2.0 under DOS and Microsoft C v6.0 and TopSpeed c v3.02 - under OS/2 2.0. Also the library has been compiled successfully with - emx 0.8e, C Set/2 and Watcom 9. Most testing was done with the large - memory model, where applicable. The large memory model is probably the + This version has been tested with Microsoft C v6.0, QuickC v2.0 and + Borland C++ 2.0 under DOS and Microsoft C v6.0 and TopSpeed c v3.02 + under OS/2 2.0. Also the library has been compiled successfully with + emx 0.8e, C Set/2 and Watcom 9. Most testing was done with the large + memory model, where applicable. The large memory model is probably the best model to use. - The amount of testing has not been as extensive as I would have liked, - but demands on releasing a product have outweighed the product's - quality. Nothing new with that !! Hopefully with wider circulation, + The amount of testing has not been as extensive as I would have liked, + but demands on releasing a product have outweighed the product's + quality. Nothing new with that !! Hopefully with wider circulation, more bugs will be fixed more quickly. - I have included just 1 makefile which is suitable for dmake 3.8 for - both DOS and OS/2. The makefile does not rely on customization of the + I have included just 1 makefile which is suitable for dmake 3.8 for + both DOS and OS/2. The makefile does not rely on customization of the dmake.ini file. - If you discover bugs, and especially if you have fixes, please let me + If you discover bugs, and especially if you have fixes, please let me know ASAP. - The source to the library is distributed as a zip file made with zip - 1.9. You will need Info-ZIP unzip 5.0 to unzip. Follow the directions + The source to the library is distributed as a zip file made with zip + 1.9. You will need Info-ZIP unzip 5.0 to unzip. Follow the directions below to compile the library. DIRECTIONS: - 1. Create a new directory in which to unzip pdcurs20.zip. This will - create a curses directory and a number of subdirectories containing + 1. Create a new directory in which to unzip pdcurs20.zip. This will + create a curses directory and a number of subdirectories containing source code for the library and utilities and the documentation. 2. Make changes to the makefile where necessary: @@ -1447,40 +1447,40 @@ DIRECTIONS: targets: all, demos, lcursesd.lib, manual... - NB. dmake is case sensitive with targets, so those environments that - use an upper case model value (eg MSC) MUST specify the library + NB. dmake is case sensitive with targets, so those environments that + use an upper case model value (eg MSC) MUST specify the library target as for eg. Lcursesd.lib - The makefile is by default set up for Borland C++. The use of -e - environment_options override these defaults. If you prefer, you can - just change the defaults in the makefile and invoke it without the + The makefile is by default set up for Borland C++. The use of -e + environment_options override these defaults. If you prefer, you can + just change the defaults in the makefile and invoke it without the -e switch. OTHER NOTES: - The documentation for the library is built into each source file, a - couple of specific doc files and the header files. A program is - supplied (manext) to build the manual. This program gets compiled when + The documentation for the library is built into each source file, a + couple of specific doc files and the header files. A program is + supplied (manext) to build the manual. This program gets compiled when you build the documentation. - To generate the library response file correctly, I had to write a quick - and dirty program (buildlrf) to achieve this. Originally the makefiles - just had statements like: "echo -+$(OBJ)\$* & >> $(LRF)" which appended - a suitable line to the response file. Unfortunately under some - combinations of makefiles and command processors (eg. nmake and 4DOS) + To generate the library response file correctly, I had to write a quick + and dirty program (buildlrf) to achieve this. Originally the makefiles + just had statements like: "echo -+$(OBJ)\$* & >> $(LRF)" which appended + a suitable line to the response file. Unfortunately under some + combinations of makefiles and command processors (eg. nmake and 4DOS) the & would get treated as stderr and the echo command would fail. - The original source for PDCurses that I received from the previous - maintainer contained support for the FLEXOS operating system. Not - having access to it, I could not test the changes I made so its support - has fallen by the wayside. If you really need to have PDCurses running + The original source for PDCurses that I received from the previous + maintainer contained support for the FLEXOS operating system. Not + having access to it, I could not test the changes I made so its support + has fallen by the wayside. If you really need to have PDCurses running under FLEXOS, contact me and I will see what can be arranged. - Under DOS, by default, screen writes to a CGA monitor are done via the - video BIOS rather than by direct video memory writes. This is due to - the CGA "snow" problem. If you have a CGA monitor and do not suffer - from snow, you can compile private\_queryad.c with CGA_DIRECT defined. - This will then use cause PDCurses to write directly to the CGA video + Under DOS, by default, screen writes to a CGA monitor are done via the + video BIOS rather than by direct video memory writes. This is due to + the CGA "snow" problem. If you have a CGA monitor and do not suffer + from snow, you can compile private\_queryad.c with CGA_DIRECT defined. + This will then use cause PDCurses to write directly to the CGA video memory. Added System V color support. @@ -1490,29 +1490,29 @@ COMPILER-SPECIFIC NOTES: Microsoft C ----------- - It is possible with MSC 6.0 to build the OS/2 libraries and demo - programs from within DOS. This is the only case where it is possible to - specify the value of TOS on the command line to be OS2 and the value of + It is possible with MSC 6.0 to build the OS/2 libraries and demo + programs from within DOS. This is the only case where it is possible to + specify the value of TOS on the command line to be OS2 and the value of OS be DOS. C Set/2 ------- - I have only tested the library using the migration libraries. I doubt + I have only tested the library using the migration libraries. I doubt that the demo programs will work without them. emx --- - Testing has been done with 0.8e of emx together with the 16_to_32 - libraries. The emx\lib directory should include the vio32.lib and + Testing has been done with 0.8e of emx together with the 16_to_32 + libraries. The emx\lib directory should include the vio32.lib and kbd32.lib libraries from the 16_to_32 package. BUGS and UNFINISHED BUSINESS: - win_print() and PDC_print() do not work under OS/2. -- The file todo.man in the doc directory also lists those functions of +- The file todo.man in the doc directory also lists those functions of System V 3.2 curses not yet implemented. Any volunteers? ACKNOWLEDGEMENTS: @@ -1533,11 +1533,11 @@ ACKNOWLEDGEMENTS: PDCurses 2.0Beta - 1991/12/21 ============================= -Changed back from short to int. (int is the correct size for the default -platform. Short might be too short on some platforms. This is more +Changed back from short to int. (int is the correct size for the default +platform. Short might be too short on some platforms. This is more portable. I, also, made this mistake.) -Many functions are now macros. If you want the real thing, #undef the +Many functions are now macros. If you want the real thing, #undef the macro. (X/Open requirement.) Merged many sources into current release. @@ -1555,13 +1555,13 @@ Added a CONTRIB file to the environment. PDCurses 1.5Beta - 1990/07/14 ============================= -Added many levels of compiler support. Added mixed prototypes for all -"internal" routines. Removed all assembly language. Added EGA/VGA -support. Converted all #ifdef to #if in all modules except CURSES.H and -CURSPRIV.H. Always include ASSERT.H. Added support for an external -malloc(), calloc() and free(). Added support for FAST_VIDEO -(direct-memory writes). Added various memory model support (for -FAST_VIDEO). Added much of the December 1988 X/Open Curses +Added many levels of compiler support. Added mixed prototypes for all +"internal" routines. Removed all assembly language. Added EGA/VGA +support. Converted all #ifdef to #if in all modules except CURSES.H and +CURSPRIV.H. Always include ASSERT.H. Added support for an external +malloc(), calloc() and free(). Added support for FAST_VIDEO +(direct-memory writes). Added various memory model support (for +FAST_VIDEO). Added much of the December 1988 X/Open Curses specification. -- John 'Frotz' Fa'atuai @@ -1571,98 +1571,98 @@ specification. PCcurses 1.4 - 1990/01/14 ========================= - In PCcurses v.1.4, both portability improvements and bugfixes have -been made. The files have been changed to allow lint-free compilation -with Microsoft C v.5.1, and with Turbo C v.2.0. The source should still -compile without problems on older compilers, although this has not been + In PCcurses v.1.4, both portability improvements and bugfixes have +been made. The files have been changed to allow lint-free compilation +with Microsoft C v.5.1, and with Turbo C v.2.0. The source should still +compile without problems on older compilers, although this has not been verified. - The makefiles have been changed to suit both the public release and -the author, who maintains a special kind of libraries for himself. In -the case of Microsoft C, changes were done in the makefile to lower the -warning level to 2 (was 3). This was to avoid ANSI warnings which are -abundant because PCcurses does not attempt to follow strict ANSI C + The makefiles have been changed to suit both the public release and +the author, who maintains a special kind of libraries for himself. In +the case of Microsoft C, changes were done in the makefile to lower the +warning level to 2 (was 3). This was to avoid ANSI warnings which are +abundant because PCcurses does not attempt to follow strict ANSI C standard. BUG FIXES FROM V.1.3 TO V.1.4: !!!IMPORTANT CHANGE!!! - The definitions for OK and ERR in curses.h were exchanged. This was -done to be more consistent with UNIX versions. Also, it permits -functions like newwin() and subwin() to return 0 (=NULL) when they fail -due to memory shortage. This incompatibility with UNIX curses was -pointed out by Fred C. Smith. If you have tested success/failure by -comparisons to anything other than ERR and OK, your applications will -need to be be changed on that point. Sorry... but presumably most of you + The definitions for OK and ERR in curses.h were exchanged. This was +done to be more consistent with UNIX versions. Also, it permits +functions like newwin() and subwin() to return 0 (=NULL) when they fail +due to memory shortage. This incompatibility with UNIX curses was +pointed out by Fred C. Smith. If you have tested success/failure by +comparisons to anything other than ERR and OK, your applications will +need to be be changed on that point. Sorry... but presumably most of you used the symbolic constants? (END OF IMPORTANT CHANGE) - Fred also pointed out a bug in the file update.c. The bug caused the -first character printed after 'unauthorized' screen changes (like during -a shell escape, for example) to be placed at the wrong screen position. -This happened even if the normal precautions (clear / touch / refresh) + Fred also pointed out a bug in the file update.c. The bug caused the +first character printed after 'unauthorized' screen changes (like during +a shell escape, for example) to be placed at the wrong screen position. +This happened even if the normal precautions (clear / touch / refresh) were taken. The problem has now been fixed. - PCcurses is currently also being used on a 68000 system with -hard-coded ESCape sequences for ANSI terminals. However, ints used by -the 68000 C compiler are 32 bits. Therefore ints have been turned into -shorts wherever possible in the code (otherwise all window structures -occupy twice as much space as required on the 68000). This does not -affect PC versions since normally both ints and shorts are 16 bits for + PCcurses is currently also being used on a 68000 system with +hard-coded ESCape sequences for ANSI terminals. However, ints used by +the 68000 C compiler are 32 bits. Therefore ints have been turned into +shorts wherever possible in the code (otherwise all window structures +occupy twice as much space as required on the 68000). This does not +affect PC versions since normally both ints and shorts are 16 bits for PC C compilers. - At some places in the source code there are references made to the -68000 version. There are also a makefile, a curses68.c file, and a -curses68.cmd file. These are for making, low-level I/O, and linking -commands when building the 68000 version. These files are probably -useful to no-one but the author, since it is very specific for its -special hardware environment. Still in an effort to keep all -curses-related sources in one place they are included. Note however that + At some places in the source code there are references made to the +68000 version. There are also a makefile, a curses68.c file, and a +curses68.cmd file. These are for making, low-level I/O, and linking +commands when building the 68000 version. These files are probably +useful to no-one but the author, since it is very specific for its +special hardware environment. Still in an effort to keep all +curses-related sources in one place they are included. Note however that PCcurses will not officially support a non-PC environment. - The file cursesio.c, which was included in the package at revision -level 1.2, and which was to be an alternative to the cursesio.asm file, -has been verified to behave incorrectly in the function _curseskeytst(). -The problem was that the value of 'cflag' does not contain the proper -data for the test that is attempted. Furthermore, neither Turbo C or -Microsoft C allows any way to return the data that is needed, and -consequently you should not use cursesio.c. The best solution is to -simply use the ASM version. In v.1.2 and v.1.3, the user could edit the -makefile to select which version he wanted to use. The makefiles in -v.1.4 have removed this possibility forcing the use of the ASM file, and + The file cursesio.c, which was included in the package at revision +level 1.2, and which was to be an alternative to the cursesio.asm file, +has been verified to behave incorrectly in the function _curseskeytst(). +The problem was that the value of 'cflag' does not contain the proper +data for the test that is attempted. Furthermore, neither Turbo C or +Microsoft C allows any way to return the data that is needed, and +consequently you should not use cursesio.c. The best solution is to +simply use the ASM version. In v.1.2 and v.1.3, the user could edit the +makefile to select which version he wanted to use. The makefiles in +v.1.4 have removed this possibility forcing the use of the ASM file, and cursesio.c has been dropped from the distribution. - A bug in the wgetstr() function caused PCcurses to echo characters -when reading a keyboard string, even if the echo had been turned off. -Thanks to Per Foreby at Lund University, Sweden, for this. Per also -reported bugs concerning the handling of characters with bit 8 set. -Their ASCII code were considered as lower than 32, so they were erased -etc. like control characters, i.e. erasing two character positions. The + A bug in the wgetstr() function caused PCcurses to echo characters +when reading a keyboard string, even if the echo had been turned off. +Thanks to Per Foreby at Lund University, Sweden, for this. Per also +reported bugs concerning the handling of characters with bit 8 set. +Their ASCII code were considered as lower than 32, so they were erased +etc. like control characters, i.e. erasing two character positions. The control character test was changed to cope with this. - The overlay() and overwrite() functions were changed so that the -overlaying window is positioned at its 'own' coordinates inside the -underlying window (it used to be at the underlying window's [0,0] -position). There is some controversy about this - the documentation for -different curses versions say different things. I think the choice made + The overlay() and overwrite() functions were changed so that the +overlaying window is positioned at its 'own' coordinates inside the +underlying window (it used to be at the underlying window's [0,0] +position). There is some controversy about this - the documentation for +different curses versions say different things. I think the choice made is the most reasonable. - The border() and wborder() functions were changed to actually draw a -border, since this seems to be the correct behavior of these functions. -They used to just set the border characters to be used by box(). These + The border() and wborder() functions were changed to actually draw a +border, since this seems to be the correct behavior of these functions. +They used to just set the border characters to be used by box(). These functions are not present in standard BSD UNIX curses. - The subwin() function previously did not allow the subwindow to be as -big as the original window in which it was created. This has now been -fixed. There was also the problem that the default size (set by -specifying numlines or numcols (or both) as 0 made the resulting actual + The subwin() function previously did not allow the subwindow to be as +big as the original window in which it was created. This has now been +fixed. There was also the problem that the default size (set by +specifying numlines or numcols (or both) as 0 made the resulting actual size 1 line/column too small. - There were a few spelling errors in function names, both in the -function declarations and in curses.h. This was reported by Carlos -Amaral at INESC in Portugal. Thanks! There was also an unnecessary (but + There were a few spelling errors in function names, both in the +function declarations and in curses.h. This was reported by Carlos +Amaral at INESC in Portugal. Thanks! There was also an unnecessary (but harmless) parameter in a function call at one place. ------------------------------------------------------------------------ @@ -1670,26 +1670,26 @@ harmless) parameter in a function call at one place. PCcurses 1.3 - 1988/10/05 ========================= - The file 'border.c' is now included. It allows you to explicitly -specify what characters should be used as box borders when the box() -functions are called. If the new border characters are non-0, they -override the border characters specified in the box() call. In my -understanding, this functionality is required for AT&T UNIX sV.3 + The file 'border.c' is now included. It allows you to explicitly +specify what characters should be used as box borders when the box() +functions are called. If the new border characters are non-0, they +override the border characters specified in the box() call. In my +understanding, this functionality is required for AT&T UNIX sV.3 compatibility. Thanks for this goes to Tony L. Hansen -(hansen@pegasus.UUCP) for posting an article about it on Usenet -(newsgroup comp.unix.questions; his posting was not related at all to +(hansen@pegasus.UUCP) for posting an article about it on Usenet +(newsgroup comp.unix.questions; his posting was not related at all to PCcurses). - The only other difference between v.1.2 and v.1.3 is that the latter -has been changed to avoid warning diagnostics if the source files are -compiled with warning switches on (for Microsoft this means '-W3', for -Turbo C it means '-w -w-pro'). Of these, the Turbo C warning check is -clearly to be used rather than Microsoft, even if neither of them comes -even close to a real UNIX 'lint'. Some of the warnings in fact indicated -real bugs, mostly functions that did not return correct return values or + The only other difference between v.1.2 and v.1.3 is that the latter +has been changed to avoid warning diagnostics if the source files are +compiled with warning switches on (for Microsoft this means '-W3', for +Turbo C it means '-w -w-pro'). Of these, the Turbo C warning check is +clearly to be used rather than Microsoft, even if neither of them comes +even close to a real UNIX 'lint'. Some of the warnings in fact indicated +real bugs, mostly functions that did not return correct return values or types. - The makefiles for both MSC and TRC have been modified to produce + The makefiles for both MSC and TRC have been modified to produce warning messages as part of normal compilation. ------------------------------------------------------------------------ @@ -1697,43 +1697,43 @@ warning messages as part of normal compilation. PCcurses 1.2 - 1988/10/02 ========================= - The changes from v.1.1 to v.1.2 are minor. The biggest change is that -there was a bug related to limiting the cursor movement if the -application tried to move it outside the screen (something that should -not be done anyway). Such erroneous application behavior is now handled + The changes from v.1.1 to v.1.2 are minor. The biggest change is that +there was a bug related to limiting the cursor movement if the +application tried to move it outside the screen (something that should +not be done anyway). Such erroneous application behavior is now handled appropriately. - All modules have been changed to have a revision string in them, which -makes it easier to determine what version is linked into a program (or + All modules have been changed to have a revision string in them, which +makes it easier to determine what version is linked into a program (or what library version you have). - There is now a 'cursesio.c' file. That file does the same as -'cursesio.asm' (i.e. it provides the interface to the lower-level system -I/O routines). It is written in C and thus it is (possibly) more -portable than the assembler version (but still not so portable since it -uses 8086 INT XX calls directly). When one creates new curses libraries, -one chooses whether to use the assembler or the C version of cursesio. -The choice is made by commenting out the appropriate dependencies for + There is now a 'cursesio.c' file. That file does the same as +'cursesio.asm' (i.e. it provides the interface to the lower-level system +I/O routines). It is written in C and thus it is (possibly) more +portable than the assembler version (but still not so portable since it +uses 8086 INT XX calls directly). When one creates new curses libraries, +one chooses whether to use the assembler or the C version of cursesio. +The choice is made by commenting out the appropriate dependencies for cursesio.obj, near the end of the makefiles. - There is now a 'setmode.c' file. That file contains functions that -save and restore terminal modes. They do it into other variables than do -savetty() and resetty(), so one should probably use either -savetty()/resetty() or the new functions only - and not mix the both + There is now a 'setmode.c' file. That file contains functions that +save and restore terminal modes. They do it into other variables than do +savetty() and resetty(), so one should probably use either +savetty()/resetty() or the new functions only - and not mix the both ways unless one really knows what one does. - Diff lists vs v.1.0 are no longer included in the distribution. The -make utility still is. PCcurses v.1.2 still compiles with Microsoft C -v.4.0, and with Borland Turbo C v.1.0. There is as far as I know no -reason to believe that it does not compile under Microsoft C v.3.0 and + Diff lists vs v.1.0 are no longer included in the distribution. The +make utility still is. PCcurses v.1.2 still compiles with Microsoft C +v.4.0, and with Borland Turbo C v.1.0. There is as far as I know no +reason to believe that it does not compile under Microsoft C v.3.0 and 5.x, or Turbo C v.1.5, but this has not been tested. - There are two makefiles included, one for Microsoft C, one for Turbo -C. They are both copies of my personal makefiles, and as such they -reflect the directory structure on my own computer. This will have to be -changed before you run make. Check $(INCDIR) and $(LIBDIR) in -particular, and make the choice of ASM or C cursesio version as -mentioned above (the distribution version uses the C version of + There are two makefiles included, one for Microsoft C, one for Turbo +C. They are both copies of my personal makefiles, and as such they +reflect the directory structure on my own computer. This will have to be +changed before you run make. Check $(INCDIR) and $(LIBDIR) in +particular, and make the choice of ASM or C cursesio version as +mentioned above (the distribution version uses the C version of cursesio). The manual file (curses.man) has been changed at appropriate places. @@ -1784,20 +1784,20 @@ cursesio). PCcurses 1.1 - 1988/03/06 ========================= - The changes from v.1.0 to v.1.1 are minor. There are a few bug fixes, -and new (non-portable) functions for verbatim IBM character font display -have been added (in charadd.c and charins.c). The manual file + The changes from v.1.0 to v.1.1 are minor. There are a few bug fixes, +and new (non-portable) functions for verbatim IBM character font display +have been added (in charadd.c and charins.c). The manual file (curses.man) has been changed at appropriate places. In the file v10tov11.dif there are listings of the differences between version 1.0 and 1.1. The diff listings are in UNIX diff(1) format. - Version 1.1 compiles with Turbo C v.1.0, as well as Microsoft C v.3.0 -and v.4.0. On the release disk there is a make.exe utility which is very -similar to UNIX make (If the package was mailed to you, the make utility -will be in uuencoded format - in make.uu - and must be uudecoded first). -It is much more powerful than Microsoft's different MAKEs; the latter -ones will NOT generate libraries properly if used with the PCcurses + Version 1.1 compiles with Turbo C v.1.0, as well as Microsoft C v.3.0 +and v.4.0. On the release disk there is a make.exe utility which is very +similar to UNIX make (If the package was mailed to you, the make utility +will be in uuencoded format - in make.uu - and must be uudecoded first). +It is much more powerful than Microsoft's different MAKEs; the latter +ones will NOT generate libraries properly if used with the PCcurses makefiles. There are three makefiles: @@ -1806,14 +1806,14 @@ makefiles. makefile.ms MSC 4.0 makefile makefile.tc Turbo C 1.0 makefile - To make a library with for example Turbo C, make directories to hold -.H and .LIB files (these directories are the 'standard places'), edit + To make a library with for example Turbo C, make directories to hold +.H and .LIB files (these directories are the 'standard places'), edit makefile.tc for this, and type make -f makefile.tc all -and libraries for all memory models will be created in the .LIB -directory, while the include files will end up in the .H directory. Also +and libraries for all memory models will be created in the .LIB +directory, while the include files will end up in the .H directory. Also read what is said about installation below! ------------------------------------------------------------------------ @@ -1821,59 +1821,59 @@ read what is said about installation below! PCcurses 1.0 - 1987/08/24 ========================= - This is the release notes for the PCcurses v.1.0 cursor/window control -package. PCcurses offers the functionality of UNIX curses, plus some -extras. Normally it should be possible to port curses-based programs -from UNIX curses to PCcurses on the IBM PC without changes. PCcurses is -a port/ rewrite of Pavel Curtis' public domain 'ncurses' package. All -the code has been re-written - it is not just an edit of ncurses (or -UNIX curses). I mention this to clarify any copyright violation claims. -The data structures and ideas are very similar to ncurses. As for UNIX + This is the release notes for the PCcurses v.1.0 cursor/window control +package. PCcurses offers the functionality of UNIX curses, plus some +extras. Normally it should be possible to port curses-based programs +from UNIX curses to PCcurses on the IBM PC without changes. PCcurses is +a port/ rewrite of Pavel Curtis' public domain 'ncurses' package. All +the code has been re-written - it is not just an edit of ncurses (or +UNIX curses). I mention this to clarify any copyright violation claims. +The data structures and ideas are very similar to ncurses. As for UNIX curses, I have not even seen any sources for it. - For an introduction to the use of 'curses' and its derivatives, you -should read 'Screen Updating and Cursor Movement Optimization: A Library -Package' by Kenneth C. R. C. Arnold, which describes the original -Berkeley UNIX version of curses. It is available as part of the UNIX -manuals. The other source of information is 'The Ncurses Reference + For an introduction to the use of 'curses' and its derivatives, you +should read 'Screen Updating and Cursor Movement Optimization: A Library +Package' by Kenneth C. R. C. Arnold, which describes the original +Berkeley UNIX version of curses. It is available as part of the UNIX +manuals. The other source of information is 'The Ncurses Reference Manual' by Pavel Curtis. The latter is part of Curtis' ncurses package. - The only other documentation provided is a 'man' page which describes -all the included functions in a very terse way. In the sources, each -function is preceded by a rather thorough description of what the -function does. I didn't have time to write a nice manual/tutorial - + The only other documentation provided is a 'man' page which describes +all the included functions in a very terse way. In the sources, each +function is preceded by a rather thorough description of what the +function does. I didn't have time to write a nice manual/tutorial - sorry. - PCcurses is released as a number of source files, a man page, and a -make file. A uuencoded copy of a 'make' utility, and a manpage for the -'make' is also provided to make it easier to put together PCcurses -libraries. Even if you are not interested in PCcurses, it may be + PCcurses is released as a number of source files, a man page, and a +make file. A uuencoded copy of a 'make' utility, and a manpage for the +'make' is also provided to make it easier to put together PCcurses +libraries. Even if you are not interested in PCcurses, it may be worthwhile to grab the make. - The makefile assumes the presence of the Microsoft C compiler (3.0 or -4.0), Microsoft MASM and LIB, plus some MS-DOS utilities. The reason for -supplying MAKE.EXE is that the Microsoft 'MAKE:s' are much inferior to a -real UNIX make. The supplied make is a port of a public domain make, -published on Usenet. It is almost completely compatible with UNIX make. -When generating the curses libraries, the makefile will direct make to -do some directory creating and file copying, and then re-invoke itself -with new targets. The workings of the makefile are not absolutely + The makefile assumes the presence of the Microsoft C compiler (3.0 or +4.0), Microsoft MASM and LIB, plus some MS-DOS utilities. The reason for +supplying MAKE.EXE is that the Microsoft 'MAKE:s' are much inferior to a +real UNIX make. The supplied make is a port of a public domain make, +published on Usenet. It is almost completely compatible with UNIX make. +When generating the curses libraries, the makefile will direct make to +do some directory creating and file copying, and then re-invoke itself +with new targets. The workings of the makefile are not absolutely crystal clear at first sight... just start it and see what it does. - For portability, the curses libraries depend on one assembler file for -access to the BIOS routines. There is no support for the EGA, but both -CGA, MGA, and the HGA can be used. The libraries are originally for -Microsoft C, but all C modules should be portable right away. In the -assembler file, segment names probably need to be changed, and possibly -the parameter passing scheme. I think Turbo C will work right away - as -far as I understand, all its conventions are compatible with Microsoft + For portability, the curses libraries depend on one assembler file for +access to the BIOS routines. There is no support for the EGA, but both +CGA, MGA, and the HGA can be used. The libraries are originally for +Microsoft C, but all C modules should be portable right away. In the +assembler file, segment names probably need to be changed, and possibly +the parameter passing scheme. I think Turbo C will work right away - as +far as I understand, all its conventions are compatible with Microsoft C. - There are some parts left out between ncurses and PCcurses. One is the -support for multiple terminals - not very interesting on a PC anyway. -Because we KNOW what terminal we have, there is no need for a termcap or -terminfo library. PCcurses also has some things that neither curses nor -ncurses have. Compared to the original UNIX curses, PCcurses has lots of + There are some parts left out between ncurses and PCcurses. One is the +support for multiple terminals - not very interesting on a PC anyway. +Because we KNOW what terminal we have, there is no need for a termcap or +terminfo library. PCcurses also has some things that neither curses nor +ncurses have. Compared to the original UNIX curses, PCcurses has lots of extras. The BIOS routines are used directly, which gives fast screen updates. @@ -1881,37 +1881,37 @@ PCcurses does not do direct writes to screen RAM - in my opinion it is a bit ugly to rely that much on hardware compatibility. Anyone could fix that, of course... - One of the more serious problems with PCcurses is the way in which -normal, cbreak, and raw input modes are done. All those details are in -the 'charget' module - I do raw I/O via the BIOS, and perform any -buffering myself. If an application program uses PCcurses, it should do -ALL its I/O via PCcurses calls, otherwise the mix of normal and -PCcurses I/O may mess up the display. I think my code is reasonable... + One of the more serious problems with PCcurses is the way in which +normal, cbreak, and raw input modes are done. All those details are in +the 'charget' module - I do raw I/O via the BIOS, and perform any +buffering myself. If an application program uses PCcurses, it should do +ALL its I/O via PCcurses calls, otherwise the mix of normal and +PCcurses I/O may mess up the display. I think my code is reasonable... comments are welcome, provided you express them nicely... - To install, copy all files to a work directory, edit 'makefile' to -define the standard include and library file directory names of your -choice (these directories must exist already, and their path names must -be relative to the root directory, not to the current one). You must -also run uudecode on make.uu, to generate MAKE.EXE. You can do that on -your PC, if you have uudecode there, otherwise you can do it under UNIX -and do a binary transfer to the PC. When you have MAKE.EXE in your work + To install, copy all files to a work directory, edit 'makefile' to +define the standard include and library file directory names of your +choice (these directories must exist already, and their path names must +be relative to the root directory, not to the current one). You must +also run uudecode on make.uu, to generate MAKE.EXE. You can do that on +your PC, if you have uudecode there, otherwise you can do it under UNIX +and do a binary transfer to the PC. When you have MAKE.EXE in your work directory (or in your /bin directory), type make. - Make will now create 4 sub-directories (one for each memory model), -copy some assembler include files into them, copy two include files to -your include directory, CHDIR to each sub-directory and re-invoke itself -with other make targets to compile and assemble all the source files -into the appropriate directories. Then the library manager is run to + Make will now create 4 sub-directories (one for each memory model), +copy some assembler include files into them, copy two include files to +your include directory, CHDIR to each sub-directory and re-invoke itself +with other make targets to compile and assemble all the source files +into the appropriate directories. Then the library manager is run to create the library files in your desired library directory. Presto! - If you only want to generate a library for one memory model, type -'make small', 'make large', etc. The name of the memory model must be in + If you only want to generate a library for one memory model, type +'make small', 'make large', etc. The name of the memory model must be in lower case, like in the makefile. - I think the package is fairly well debugged - but then again, that's -what I always think. It was completed in May-87, and no problems found -yet. Now it's your turn... Comments, suggestions and bug reports and + I think the package is fairly well debugged - but then again, that's +what I always think. It was completed in May-87, and no problems found +yet. Now it's your turn... Comments, suggestions and bug reports and fixes (no flames please) to -- Bjorn Larsson diff --git a/graphics/pdcurs34/IMPLEMNT b/graphics/pdcurs34/IMPLEMNT index 1a2d66eff..68c81a5ac 100644 --- a/graphics/pdcurs34/IMPLEMNT +++ b/graphics/pdcurs34/IMPLEMNT @@ -2,71 +2,71 @@ PDCurses Implementor's Guide ============================ Version 1.3 - 200?/??/?? - notes about official ports -Version 1.2 - 2007/07/11 - added PDC_init_pair(), PDC_pair_content(), +Version 1.2 - 2007/07/11 - added PDC_init_pair(), PDC_pair_content(), version history; removed pdc_atrtab Version 1.1 - 2007/06/06 - minor cosmetic change Version 1.0 - 2007/04/01 - initial revision -This document is for those wishing to port PDCurses to a new platform, -or just wanting to better understand how it works. Nothing here should -be needed for application programming; for that, refer to PDCurses.txt, -as built in doc/, or distributed as a file separate from this source -package. This document assumes that you've read the user-level -documentation and are very familiar with application-level curses +This document is for those wishing to port PDCurses to a new platform, +or just wanting to better understand how it works. Nothing here should +be needed for application programming; for that, refer to PDCurses.txt, +as built in doc/, or distributed as a file separate from this source +package. This document assumes that you've read the user-level +documentation and are very familiar with application-level curses programming. -If you want to submit your port for possible inclusion into the main +If you want to submit your port for possible inclusion into the main PDCurses distribution, please follow these guidelines: - - Don't modify anything in the pdcurses directory or in other port - directories. Don't modify curses.h or curspriv.h unless absolutely + - Don't modify anything in the pdcurses directory or in other port + directories. Don't modify curses.h or curspriv.h unless absolutely necessary. (And prefer modifying curspriv.h over curses.h.) - - Use the same indentation style, naming and scope conventions as the + - Use the same indentation style, naming and scope conventions as the existing code. - - Release all your code to the public domain -- no copyright. Code + - Release all your code to the public domain -- no copyright. Code under GPL, BSD, etc. will not be accepted. DATA STRUCTURES --------------- -A port of PDCurses must provide acs_map[], a 128-element array of -chtypes, with values laid out based on the Alternate Character Set of -the VT100 (see curses.h). PDC_transform_line() must use this table; when -it encounters a chtype with the A_ALTCHARSET flag set, and an A_CHARTEXT -value in the range 0-127, it must render it using the A_CHARTEXT portion -of the corresponding value from this table, instead of the original -value. Also, values may be read from this table by apps, and passed -through functions such as waddch(), which does no special processing on -control characters (0-31 and 127) when the A_ALTCHARSET flag is set. -Thus, any control characters used in acs_map[] should also have the -A_ALTCHARSET flag set. Implementations should provide suitable values -for all the ACS_ macros defined in curses.h; other values in the table -should be filled with their own indices (e.g., acs_map['E'] == 'E'). The -table can be either hardwired, or filled by PDC_scr_open(). Existing +A port of PDCurses must provide acs_map[], a 128-element array of +chtypes, with values laid out based on the Alternate Character Set of +the VT100 (see curses.h). PDC_transform_line() must use this table; when +it encounters a chtype with the A_ALTCHARSET flag set, and an A_CHARTEXT +value in the range 0-127, it must render it using the A_CHARTEXT portion +of the corresponding value from this table, instead of the original +value. Also, values may be read from this table by apps, and passed +through functions such as waddch(), which does no special processing on +control characters (0-31 and 127) when the A_ALTCHARSET flag is set. +Thus, any control characters used in acs_map[] should also have the +A_ALTCHARSET flag set. Implementations should provide suitable values +for all the ACS_ macros defined in curses.h; other values in the table +should be filled with their own indices (e.g., acs_map['E'] == 'E'). The +table can be either hardwired, or filled by PDC_scr_open(). Existing ports define it in pdcdisp.c, but this is not required. FUNCTIONS --------- -A port of PDCurses must implement the following functions, with extern -scope. These functions are traditionally divided into several modules, -as indicated below; this division is not required (only the functions -are), but may make it easier to follow for someone familiar with the +A port of PDCurses must implement the following functions, with extern +scope. These functions are traditionally divided into several modules, +as indicated below; this division is not required (only the functions +are), but may make it easier to follow for someone familiar with the existing ports. -Any other functions you create as part of your implementation should -have static scope, if possible. If they can't be static, they should be -named with the "PDC_" prefix. This minimizes the risk of collision with +Any other functions you create as part of your implementation should +have static scope, if possible. If they can't be static, they should be +named with the "PDC_" prefix. This minimizes the risk of collision with an application's choices. -Current PDCurses style also uses a single leading underscore with the -name of any static function; and modified BSD/Allman-style indentation, -approximately equivalent to "indent -kr -i8 -bl -bli0", with adjustments -to keep every line under 80 columns. This isn't essential, but a +Current PDCurses style also uses a single leading underscore with the +name of any static function; and modified BSD/Allman-style indentation, +approximately equivalent to "indent -kr -i8 -bl -bli0", with adjustments +to keep every line under 80 columns. This isn't essential, but a consistent style helps readability. @@ -75,17 +75,17 @@ pdcdisp.c: void PDC_gotoyx(int y, int x); -Move the physical cursor (as opposed to the logical cursor affected by -wmove()) to the given location. This is called mainly from doupdate(). -In general, this function need not compare the old location with the new +Move the physical cursor (as opposed to the logical cursor affected by +wmove()) to the given location. This is called mainly from doupdate(). +In general, this function need not compare the old location with the new one, and should just move the cursor unconditionally. void PDC_transform_line(int lineno, int x, int len, const chtype *srcp); -The core output routine. It takes len chtype entities from srcp (a -pointer into curscr) and renders them to the physical screen at line -lineno, column x. It must also translate characters 0-127 via acs_map[], -if they're flagged with A_ALTCHARSET in the attribute portion of the +The core output routine. It takes len chtype entities from srcp (a +pointer into curscr) and renders them to the physical screen at line +lineno, column x. It must also translate characters 0-127 via acs_map[], +if they're flagged with A_ALTCHARSET in the attribute portion of the chtype. @@ -94,22 +94,22 @@ pdcgetsc.c: int PDC_get_columns(void); -Returns the size of the screen in columns. It's used in resize_term() to -set the new value of COLS. (Some existing implementations also call it +Returns the size of the screen in columns. It's used in resize_term() to +set the new value of COLS. (Some existing implementations also call it internally from PDC_scr_open(), but this is not required.) int PDC_get_cursor_mode(void); -Returns the size/shape of the cursor. The format of the result is -unspecified, except that it must be returned as an int. This function is -called from initscr(), and the result is stored in SP->orig_cursor, -which is used by PDC_curs_set() to determine the size/shape of the +Returns the size/shape of the cursor. The format of the result is +unspecified, except that it must be returned as an int. This function is +called from initscr(), and the result is stored in SP->orig_cursor, +which is used by PDC_curs_set() to determine the size/shape of the cursor in normal visibility mode (curs_set(1)). int PDC_get_rows(void); -Returns the size of the screen in rows. It's used in resize_term() to -set the new value of LINES. (Some existing implementations also call it +Returns the size of the screen in rows. It's used in resize_term() to +set the new value of LINES. (Some existing implementations also call it internally from PDC_scr_open(), but this is not required.) @@ -148,23 +148,23 @@ true). int PDC_modifiers_set(void); -Called from PDC_return_key_modifiers(). If your platform needs to do -anything in response to a change in SP->return_key_modifiers, do it +Called from PDC_return_key_modifiers(). If your platform needs to do +anything in response to a change in SP->return_key_modifiers, do it here. Returns OK or ERR, which is passed on by the caller. int PDC_mouse_set(void); -Called by mouse_set(), mouse_on(), and mouse_off() -- all the functions -that modify SP->_trap_mbe. If your platform needs to do anything in -response to a change in SP->_trap_mbe (for example, turning the mouse -cursor on or off), do it here. Returns OK or ERR, which is passed on by +Called by mouse_set(), mouse_on(), and mouse_off() -- all the functions +that modify SP->_trap_mbe. If your platform needs to do anything in +response to a change in SP->_trap_mbe (for example, turning the mouse +cursor on or off), do it here. Returns OK or ERR, which is passed on by the caller. void PDC_set_keyboard_binary(bool on); -Set keyboard input to "binary" mode. If you need to do something to keep -the OS from processing ^C, etc. on your platform, do it here. true turns -the mode on; false reverts it. This function is called from raw() and +Set keyboard input to "binary" mode. If you need to do something to keep +the OS from processing ^C, etc. on your platform, do it here. true turns +the mode on; false reverts it. This function is called from raw() and noraw(). @@ -173,90 +173,90 @@ pdcscrn.c: bool PDC_can_change_color(void); -Returns true if init_color() and color_content() give meaningful +Returns true if init_color() and color_content() give meaningful results, false otherwise. Called from can_change_color(). int PDC_color_content(short color, short *red, short *green, short *blue); -The core of color_content(). This does all the work of that function, +The core of color_content(). This does all the work of that function, except checking for values out of range and null pointers. int PDC_init_color(short color, short red, short green, short blue); -The core of init_color(). This does all the work of that function, +The core of init_color(). This does all the work of that function, except checking for values out of range. void PDC_init_pair(short pair, short fg, short bg); -The core of init_pair(). This does all the work of that function, except -checking for values out of range. The values passed to this function -should be returned by a call to PDC_pair_content() with the same pair -number. PDC_transform_line() should use the specified colors when +The core of init_pair(). This does all the work of that function, except +checking for values out of range. The values passed to this function +should be returned by a call to PDC_pair_content() with the same pair +number. PDC_transform_line() should use the specified colors when rendering a chtype with the given pair number. int PDC_pair_content(short pair, short *fg, short *bg); -The core of pair_content(). This does all the work of that function, +The core of pair_content(). This does all the work of that function, except checking for values out of range and null pointers. void PDC_reset_prog_mode(void); -The non-portable functionality of reset_prog_mode() is handled here -- -whatever's not done in _restore_mode(). In current ports: In OS/2, this -sets the keyboard to binary mode; in Win32, it enables or disables the +The non-portable functionality of reset_prog_mode() is handled here -- +whatever's not done in _restore_mode(). In current ports: In OS/2, this +sets the keyboard to binary mode; in Win32, it enables or disables the mouse pointer to match the saved mode; in others it does nothing. void PDC_reset_shell_mode(void); -The same thing, for reset_shell_mode(). In OS/2 and Win32, it restores +The same thing, for reset_shell_mode(). In OS/2 and Win32, it restores the default console mode; in others it does nothing. int PDC_resize_screen(int nlines, int ncols); -This does the main work of resize_term(). It may respond to non-zero -parameters, by setting the screen to the specified size; to zero -parameters, by setting the screen to a size chosen by the user at -runtime, in an unspecified way (e.g., by dragging the edges of the -window); or both. It may also do nothing, if there's no appropriate +This does the main work of resize_term(). It may respond to non-zero +parameters, by setting the screen to the specified size; to zero +parameters, by setting the screen to a size chosen by the user at +runtime, in an unspecified way (e.g., by dragging the edges of the +window); or both. It may also do nothing, if there's no appropriate action for the platform. void PDC_restore_screen_mode(int i); -Called from _restore_mode() in kernel.c, this function does the actual +Called from _restore_mode() in kernel.c, this function does the actual mode changing, if applicable. Currently used only in DOS and OS/2. void PDC_save_screen_mode(int i); -Called from _save_mode() in kernel.c, this function saves the actual +Called from _save_mode() in kernel.c, this function saves the actual screen mode, if applicable. Currently used only in DOS and OS/2. void PDC_scr_close(void); -The platform-specific part of endwin(). It may restore the image of the -original screen saved by PDC_scr_open(), if the PDC_RESTORE_SCREEN -environment variable is set; either way, if using an existing terminal, -this function should restore it to the mode it had at startup, and move +The platform-specific part of endwin(). It may restore the image of the +original screen saved by PDC_scr_open(), if the PDC_RESTORE_SCREEN +environment variable is set; either way, if using an existing terminal, +this function should restore it to the mode it had at startup, and move the cursor to the lower left corner. (The X11 port does nothing.) void PDC_scr_free(void); -Frees the memory for SP allocated by PDC_scr_open(). Called by +Frees the memory for SP allocated by PDC_scr_open(). Called by delscreen(). int PDC_scr_open(int argc, char **argv); -The platform-specific part of initscr(). It's actually called from -Xinitscr(); the arguments, if present, correspond to those used with -main(), and may be used to set the title of the terminal window, or for -other, platform-specific purposes. (The arguments are currently used -only in X11.) PDC_scr_open() must allocate memory for SP, and must -initialize acs_map[] (unless it's preset) and several members of SP, -including lines, cols, mouse_wait, orig_attr (and if orig_attr is true, -orig_fore and orig_back), mono, _restore and _preserve. (Although SP is -used the same way in all ports, it's allocated here in order to allow -the X11 port to map it to a block of shared memory.) If using an -existing terminal, and the environment variable PDC_RESTORE_SCREEN is -set, this function may also store the existing screen image for later +The platform-specific part of initscr(). It's actually called from +Xinitscr(); the arguments, if present, correspond to those used with +main(), and may be used to set the title of the terminal window, or for +other, platform-specific purposes. (The arguments are currently used +only in X11.) PDC_scr_open() must allocate memory for SP, and must +initialize acs_map[] (unless it's preset) and several members of SP, +including lines, cols, mouse_wait, orig_attr (and if orig_attr is true, +orig_fore and orig_back), mono, _restore and _preserve. (Although SP is +used the same way in all ports, it's allocated here in order to allow +the X11 port to map it to a block of shared memory.) If using an +existing terminal, and the environment variable PDC_RESTORE_SCREEN is +set, this function may also store the existing screen image for later restoration by PDC_scr_close(). @@ -265,9 +265,9 @@ pdcsetsc.c: int PDC_curs_set(int visibility); -Called from curs_set(). Changes the appearance of the cursor -- 0 turns -it off, 1 is normal (the terminal's default, if applicable, as -determined by SP->orig_cursor), and 2 is high visibility. The exact +Called from curs_set(). Changes the appearance of the cursor -- 0 turns +it off, 1 is normal (the terminal's default, if applicable, as +determined by SP->orig_cursor), and 2 is high visibility. The exact appearance of these modes is not specified. @@ -276,30 +276,30 @@ pdcutil.c: void PDC_beep(void); -Emits a short audible beep. If this is not possible on your platform, -you must set SP->audible to false during initialization (i.e., from -PDC_scr_open() -- not here); otherwise, set it to true. This function is +Emits a short audible beep. If this is not possible on your platform, +you must set SP->audible to false during initialization (i.e., from +PDC_scr_open() -- not here); otherwise, set it to true. This function is called from beep(). void PDC_napms(int ms); -This is the core delay routine, called by napms(). It pauses for about -(the X/Open spec says "at least") ms milliseconds, then returns. High -degrees of accuracy and precision are not expected (though desirable, if -you can achieve them). More important is that this function gives back -the process' time slice to the OS, so that PDCurses idles at low CPU +This is the core delay routine, called by napms(). It pauses for about +(the X/Open spec says "at least") ms milliseconds, then returns. High +degrees of accuracy and precision are not expected (though desirable, if +you can achieve them). More important is that this function gives back +the process' time slice to the OS, so that PDCurses idles at low CPU usage. const char *PDC_sysname(void); -Returns a short string describing the platform, such as "DOS" or "X11". -This is used by longname(). It must be no more than 100 characters; it +Returns a short string describing the platform, such as "DOS" or "X11". +This is used by longname(). It must be no more than 100 characters; it should be much, much shorter (existing platforms use no more than 5). -------------------------------------------------------------------------- -The following functions are implemented in the platform directories, but -are accessed directly by apps. Refer to the user documentation for their +The following functions are implemented in the platform directories, but +are accessed directly by apps. Refer to the user documentation for their descriptions: diff --git a/graphics/pdcurs34/README b/graphics/pdcurs34/README index dc476a9f1..ae03c09cb 100644 --- a/graphics/pdcurs34/README +++ b/graphics/pdcurs34/README @@ -1,7 +1,7 @@ Welcome to PDCurses! ==================== -Public Domain Curses, aka PDCurses, is an implementation of X/Open +Public Domain Curses, aka PDCurses, is an implementation of X/Open curses for multiple platforms. The latest version can be found at: http://pdcurses.sourceforge.net/ @@ -12,14 +12,14 @@ For changes, see the HISTORY file. Legal Stuff ----------- -The core package is in the public domain, but small portions of PDCurses -are subject to copyright under various licenses. Each directory -contains a README file, with a section titled "Distribution Status" +The core package is in the public domain, but small portions of PDCurses +are subject to copyright under various licenses. Each directory +contains a README file, with a section titled "Distribution Status" which describes the status of the files in that directory. -If you use PDCurses in an application, an acknowledgement would be -appreciated, but is not mandatory. If you make corrections or -enhancements to PDCurses, please forward them to the current maintainer +If you use PDCurses in an application, an acknowledgement would be +appreciated, but is not mandatory. If you make corrections or +enhancements to PDCurses, please forward them to the current maintainer for the benefit of other users. This software is provided AS IS with NO WARRANTY whatsoever. @@ -28,17 +28,17 @@ This software is provided AS IS with NO WARRANTY whatsoever. Ports ----- -PDCurses has been ported to DOS, OS/2, Win32, X11 and SDL. A directory -containing the port-specific source files exists for each of these +PDCurses has been ported to DOS, OS/2, Win32, X11 and SDL. A directory +containing the port-specific source files exists for each of these platforms. Build instructions are in the README file for each platform. Distribution Status ------------------- -All files in this directory except configure, config.guess and -config.sub are released to the Public Domain. config.guess and -config.sub are under the GPL; configure is under a free license +All files in this directory except configure, config.guess and +config.sub are released to the Public Domain. config.guess and +config.sub are under the GPL; configure is under a free license described within it. diff --git a/graphics/pdcurs34/include/term.h b/graphics/pdcurs34/include/term.h index 7bad794a8..57eab5997 100644 --- a/graphics/pdcurs34/include/term.h +++ b/graphics/pdcurs34/include/term.h @@ -1,9 +1,9 @@ /**************************************************************************** * apps/graphics/pdcurses/term.h * Public Domain Curses - * PDCurses doesn't operate with terminfo, but we need these functions for - * compatibility, to allow some things (notably, interface libraries for - * other languages) to be compiled. Anyone who tries to actually _use_ + * PDCurses doesn't operate with terminfo, but we need these functions for + * compatibility, to allow some things (notably, interface libraries for + * other languages) to be compiled. Anyone who tries to actually _use_ * them will be disappointed, since they only return ERR. * $Id: term.h,v 1.16 2008/07/13 16:08:16 wmcbrine Exp $ * @@ -92,7 +92,7 @@ char *tgoto(const char *, int, int); int tigetflag(const char *); int tigetnum(const char *); char *tigetstr(const char *); -char *tparm(const char *, long, long, long, long, long, +char *tparm(const char *, long, long, long, long, long, long, long, long, long); int tputs(const char *, int, int (*)(int)); diff --git a/graphics/pdcurs34/nuttx/Make.defs b/graphics/pdcurs34/nuttx/Make.defs index 1df7ea2dd..a782da200 100644 --- a/graphics/pdcurs34/nuttx/Make.defs +++ b/graphics/pdcurs34/nuttx/Make.defs @@ -33,7 +33,7 @@ # ############################################################################ -# CSRCS += +# CSRCS += DEPPATH += --dep-path nuttx VPATH += :nuttx diff --git a/graphics/pdcurs34/pdcurses/README b/graphics/pdcurs34/pdcurses/README index bef1c4c46..a6a7ee8fe 100644 --- a/graphics/pdcurs34/pdcurses/README +++ b/graphics/pdcurs34/pdcurses/README @@ -1,14 +1,14 @@ PDCurses Portable Core ====================== -This directory contains core PDCurses source code files common to all +This directory contains core PDCurses source code files common to all platforms. Building -------- -These modules are built by the platform-specific makefiles, in the +These modules are built by the platform-specific makefiles, in the platform directories. diff --git a/graphics/pdcurs34/pdcurses/pdc_addch.c b/graphics/pdcurs34/pdcurses/pdc_addch.c index 27ac43c79..76c5c2de4 100644 --- a/graphics/pdcurs34/pdcurses/pdc_addch.c +++ b/graphics/pdcurs34/pdcurses/pdc_addch.c @@ -75,41 +75,41 @@ * mvaddch() moves the cursor to the specified (y, x) position, and * adds ch to stdscr. mvadd_wch() is the wide version. * - * mvwaddch() moves the cursor to the specified position and adds + * mvwaddch() moves the cursor to the specified position and adds * ch to the specified window. mvwadd_wch() is the wide version. * - * echochar() adds ch to stdscr at the current cursor position and + * echochar() adds ch to stdscr at the current cursor position and * calls refresh(). echo_wchar() is the wide version. * - * wechochar() adds ch to the specified window and calls + * wechochar() adds ch to the specified window and calls * wrefresh(). wecho_wchar() is the wide version. * * addrawch(), waddrawch(), mvaddrawch() and mvwaddrawch() are - * PDCurses-specific wrappers for addch() etc. that disable the + * PDCurses-specific wrappers for addch() etc. that disable the * translation of control characters. * * The following applies to all these functions: * - * If the cursor moves on to the right margin, an automatic newline - * is performed. If scrollok is enabled, and a character is added - * to the bottom right corner of the window, the scrolling region - * will be scrolled up one line. If scrolling is not allowed, ERR + * If the cursor moves on to the right margin, an automatic newline + * is performed. If scrollok is enabled, and a character is added + * to the bottom right corner of the window, the scrolling region + * will be scrolled up one line. If scrolling is not allowed, ERR * will be returned. * - * If ch is a tab, newline, or backspace, the cursor will be moved - * appropriately within the window. If ch is a newline, the - * clrtoeol routine is called before the cursor is moved to the - * beginning of the next line. If newline mapping is off, the - * cursor will be moved to the next line, but the x coordinate will - * be unchanged. If ch is a tab the cursor is moved to the next - * tab position within the window. If ch is another control - * character, it will be drawn in the ^X notation. Calling the - * inch() routine after adding a control character returns the - * representation of the control character, not the control + * If ch is a tab, newline, or backspace, the cursor will be moved + * appropriately within the window. If ch is a newline, the + * clrtoeol routine is called before the cursor is moved to the + * beginning of the next line. If newline mapping is off, the + * cursor will be moved to the next line, but the x coordinate will + * be unchanged. If ch is a tab the cursor is moved to the next + * tab position within the window. If ch is another control + * character, it will be drawn in the ^X notation. Calling the + * inch() routine after adding a control character returns the + * representation of the control character, not the control * character. * - * Video attributes can be combined with a character by ORing them - * into the parameter. Text, including attributes, can be copied + * Video attributes can be combined with a character by ORing them + * into the parameter. Text, including attributes, can be copied * from one place to another by using inch() and addch(). * * Note that in PDCurses, for now, a cchar_t and a chtype are the diff --git a/graphics/pdcurs34/pdcurses/pdc_addchstr.c b/graphics/pdcurs34/pdcurses/pdc_addchstr.c index 650477481..919f64c7b 100644 --- a/graphics/pdcurs34/pdcurses/pdc_addchstr.c +++ b/graphics/pdcurs34/pdcurses/pdc_addchstr.c @@ -61,15 +61,15 @@ * int n); * * Description: - * These routines write a chtype or cchar_t string directly into - * the window structure, starting at the current or specified - * position. The four routines with n as the last argument copy at - * most n elements, but no more than will fit on the line. If n = - * -1 then the whole string is copied, up to the maximum number + * These routines write a chtype or cchar_t string directly into + * the window structure, starting at the current or specified + * position. The four routines with n as the last argument copy at + * most n elements, but no more than will fit on the line. If n = + * -1 then the whole string is copied, up to the maximum number * that will fit on the line. * - * The cursor position is not advanced. These routines do not check - * for newline or other special characters, nor does any line + * The cursor position is not advanced. These routines do not check + * for newline or other special characters, nor does any line * wrapping occur. * * Return Value: diff --git a/graphics/pdcurs34/pdcurses/pdc_attr.c b/graphics/pdcurs34/pdcurses/pdc_attr.c index bd0920ca0..dbfd4ada3 100644 --- a/graphics/pdcurs34/pdcurses/pdc_attr.c +++ b/graphics/pdcurs34/pdcurses/pdc_attr.c @@ -77,24 +77,24 @@ * chtype getattrs(WINDOW *win); * * Description: - * These functions manipulate the current attributes and/or colors - * of the named window. These attributes can be any combination + * These functions manipulate the current attributes and/or colors + * of the named window. These attributes can be any combination * of A_STANDOUT, A_REVERSE, A_BOLD, A_DIM, A_BLINK, A_UNDERLINE. * * These constants are defined in curses.h and can be combined * with the bitwise-OR operator (|). * - * The current attributes of a window are applied to all chtypes - * that are written into the window with waddch(). Attributes are - * a property of the chtype, and move with the character through + * The current attributes of a window are applied to all chtypes + * that are written into the window with waddch(). Attributes are + * a property of the chtype, and move with the character through * any scrolling or insert/delete operations. * - * attrset() sets the current attributes of the given window to - * attrs. attroff() turns off the named attributes without - * affecting any other attributes; attron() turns them on. + * attrset() sets the current attributes of the given window to + * attrs. attroff() turns off the named attributes without + * affecting any other attributes; attron() turns them on. * color_set() sets the window color to the value of color_pair. * - * standout() is the same as attron(A_STANDOUT). standend() is the + * standout() is the same as attron(A_STANDOUT). standend() is the * same as attrset(A_NORMAL); that is, it turns off all attributes. * * Return Value: diff --git a/graphics/pdcurs34/pdcurses/pdc_bkgd.c b/graphics/pdcurs34/pdcurses/pdc_bkgd.c index 4ec0d6b45..a01a4eb87 100644 --- a/graphics/pdcurs34/pdcurses/pdc_bkgd.c +++ b/graphics/pdcurs34/pdcurses/pdc_bkgd.c @@ -71,7 +71,7 @@ * there is a conflict (e.g., different color pairs). * * Return Value: - * bkgd() and wbkgd() return OK, unless the window is NULL, in + * bkgd() and wbkgd() return OK, unless the window is NULL, in * which case they return ERR. * * Portability X/Open BSD SYS V @@ -173,7 +173,7 @@ int wbkgd(WINDOW * win, chtype ch) attr ^= oldattr; attr |= newattr; - /* Change character if it is there because it was the old background + /* Change character if it is there because it was the old background * character. */ diff --git a/graphics/pdcurs34/pdcurses/pdc_border.c b/graphics/pdcurs34/pdcurses/pdc_border.c index 3dadf64cf..71ea7ef3d 100644 --- a/graphics/pdcurs34/pdcurses/pdc_border.c +++ b/graphics/pdcurs34/pdcurses/pdc_border.c @@ -41,9 +41,9 @@ /* Name: border * * Synopsis: - * int border(chtype ls, chtype rs, chtype ts, chtype bs, chtype tl, + * int border(chtype ls, chtype rs, chtype ts, chtype bs, chtype tl, * chtype tr, chtype bl, chtype br); - * int wborder(WINDOW *win, chtype ls, chtype rs, chtype ts, + * int wborder(WINDOW *win, chtype ls, chtype rs, chtype ts, * chtype bs, chtype tl, chtype tr, chtype bl, chtype br); * int box(WINDOW *win, chtype verch, chtype horch); * int hline(chtype ch, int n); @@ -74,8 +74,8 @@ * int mvwvline_set(WINDOW *win, int y, int x, const cchar_t *wch, int n); * * Description: - * border(), wborder(), and box() draw a border around the edge of - * the window. If any argument is zero, an appropriate default is + * border(), wborder(), and box() draw a border around the edge of + * the window. If any argument is zero, an appropriate default is * used: * * ls left side of border ACS_VLINE @@ -87,14 +87,14 @@ * bl bottom left corner of border ACS_LLCORNER * br bottom right corner of border ACS_LRCORNER * - * hline() and whline() draw a horizontal line, using ch, starting - * from the current cursor position. The cursor position does not - * change. The line is at most n characters long, or as many as + * hline() and whline() draw a horizontal line, using ch, starting + * from the current cursor position. The cursor position does not + * change. The line is at most n characters long, or as many as * will fit in the window. * - * vline() and wvline() draw a vertical line, using ch, starting - * from the current cursor position. The cursor position does not - * change. The line is at most n characters long, or as many as + * vline() and wvline() draw a vertical line, using ch, starting + * from the current cursor position. The cursor position does not + * change. The line is at most n characters long, or as many as * will fit in the window. * * Return Value: @@ -135,9 +135,9 @@ * Private Functions ****************************************************************************/ -/* _attr_passthru() -- Takes a single chtype 'ch' and checks if the - * current attribute of window 'win', as set by wattrset(), and/or the - * current background of win, as set by wbkgd(), should by combined with +/* _attr_passthru() -- Takes a single chtype 'ch' and checks if the + * current attribute of window 'win', as set by wattrset(), and/or the + * current background of win, as set by wbkgd(), should by combined with * it. Attributes set explicitly in ch take precedence. */ @@ -159,7 +159,7 @@ static chtype _attr_passthru(WINDOW * win, chtype ch) } /* wrs (4/10/93) -- Apply the same sort of logic for the window background, - * in that it only takes precedence if other color attributes are not there. + * in that it only takes precedence if other color attributes are not there. */ if (!(attr & A_COLOR)) diff --git a/graphics/pdcurs34/pdcurses/pdc_clear.c b/graphics/pdcurs34/pdcurses/pdc_clear.c index d7b996075..3ad22dd35 100644 --- a/graphics/pdcurs34/pdcurses/pdc_clear.c +++ b/graphics/pdcurs34/pdcurses/pdc_clear.c @@ -51,14 +51,14 @@ * int wclrtoeol(WINDOW *win); * * Description: - * erase() and werase() copy blanks (i.e. the background chtype) to + * erase() and werase() copy blanks (i.e. the background chtype) to * every cell of the window. * * clear() and wclear() are similar to erase() and werase(), but - * they also call clearok() to ensure that the the window is + * they also call clearok() to ensure that the the window is * cleared on the next wrefresh(). * - * clrtobot() and wclrtobot() clear the window from the current + * clrtobot() and wclrtobot() clear the window from the current * cursor position to the end of the window. * * clrtoeol() and wclrtoeol() clear the window from the current diff --git a/graphics/pdcurs34/pdcurses/pdc_color.c b/graphics/pdcurs34/pdcurses/pdc_color.c index 16c9aee10..97dd3772c 100644 --- a/graphics/pdcurs34/pdcurses/pdc_color.c +++ b/graphics/pdcurs34/pdcurses/pdc_color.c @@ -56,10 +56,10 @@ * * Description: * To use these routines, start_color() must be called, usually - * immediately after initscr(). Colors are always used in pairs, - * referred to as color-pairs. A color-pair consists of a - * foreground color and a background color. A color-pair is - * initialized via init_pair(). After initialization, COLOR_PAIR(n) + * immediately after initscr(). Colors are always used in pairs, + * referred to as color-pairs. A color-pair consists of a + * foreground color and a background color. A color-pair is + * initialized via init_pair(). After initialization, COLOR_PAIR(n) * can be used like any other video attribute. * * start_color() initializes eight basic colors (black, red, green, @@ -68,16 +68,16 @@ * maximum number of colors and color-pairs the terminal is capable * of displaying). * - * init_pair() changes the definition of a color-pair. It takes - * three arguments: the number of the color-pair to be redefined, - * and the new values of the foreground and background colors. The - * pair number must be between 0 and COLOR_PAIRS - 1, inclusive. - * The foreground and background must be between 0 and COLORS - 1, - * inclusive. If the color pair was previously initialized, the - * screen is refreshed, and all occurrences of that color-pair are + * init_pair() changes the definition of a color-pair. It takes + * three arguments: the number of the color-pair to be redefined, + * and the new values of the foreground and background colors. The + * pair number must be between 0 and COLOR_PAIRS - 1, inclusive. + * The foreground and background must be between 0 and COLORS - 1, + * inclusive. If the color pair was previously initialized, the + * screen is refreshed, and all occurrences of that color-pair are * changed to the new definition. * - * has_colors() indicates if the terminal supports, and can + * has_colors() indicates if the terminal supports, and can * maniplulate color. It returns true or false. * * can_change_color() indicates if the terminal has the capability diff --git a/graphics/pdcurs34/pdcurses/pdc_debug.c b/graphics/pdcurs34/pdcurses/pdc_debug.c index 3a49c61b0..42f6c860b 100644 --- a/graphics/pdcurs34/pdcurses/pdc_debug.c +++ b/graphics/pdcurs34/pdcurses/pdc_debug.c @@ -46,12 +46,12 @@ * void PDC_debug(const char *, ...); * * Description: - * traceon() and traceoff() toggle the recording of debugging - * information to the file "trace". Although not standard, similar + * traceon() and traceoff() toggle the recording of debugging + * information to the file "trace". Although not standard, similar * functions are in some other curses implementations. * - * PDC_debug() is the function that writes to the file, based on - * whether traceon() has been called. It's used from the PDC_LOG() + * PDC_debug() is the function that writes to the file, based on + * whether traceon() has been called. It's used from the PDC_LOG() * macro. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_deleteln.c b/graphics/pdcurs34/pdcurses/pdc_deleteln.c index 4f09683eb..f5aab0870 100644 --- a/graphics/pdcurs34/pdcurses/pdc_deleteln.c +++ b/graphics/pdcurs34/pdcurses/pdc_deleteln.c @@ -59,10 +59,10 @@ * current line are moved up one line. The bottom line of the * window is cleared. The cursor position does not change. * - * With the insertln() and winsertn() functions, a blank line is + * With the insertln() and winsertn() functions, a blank line is * inserted above the current line and the bottom line is lost. * - * mvdeleteln(), mvwdeleteln(), mvinsertln() and mvwinsertln() + * mvdeleteln(), mvwdeleteln(), mvinsertln() and mvwinsertln() * allow moving the cursor and inserting/deleting in one call. * * Return Value: diff --git a/graphics/pdcurs34/pdcurses/pdc_getch.c b/graphics/pdcurs34/pdcurses/pdc_getch.c index 4d5f1b885..9cc01c257 100644 --- a/graphics/pdcurs34/pdcurses/pdc_getch.c +++ b/graphics/pdcurs34/pdcurses/pdc_getch.c @@ -59,13 +59,13 @@ * int PDC_return_key_modifiers(bool flag); * * Description: - * With the getch(), wgetch(), mvgetch(), and mvwgetch() functions, - * a character is read from the terminal associated with the window. - * In nodelay mode, if there is no input waiting, the value ERR is - * returned. In delay mode, the program will hang until the system - * passes text through to the program. Depending on the setting of - * cbreak(), this will be after one character or after the first - * newline. Unless noecho() has been set, the character will also + * With the getch(), wgetch(), mvgetch(), and mvwgetch() functions, + * a character is read from the terminal associated with the window. + * In nodelay mode, if there is no input waiting, the value ERR is + * returned. In delay mode, the program will hang until the system + * passes text through to the program. Depending on the setting of + * cbreak(), this will be after one character or after the first + * newline. Unless noecho() has been set, the character will also * be echoed into the designated window. * * If keypad() is true, and a function key is pressed, the token for @@ -76,25 +76,25 @@ * If nodelay(win, true) has been called on the window and no input * is waiting, the value ERR is returned. * - * ungetch() places ch back onto the input queue to be returned by + * ungetch() places ch back onto the input queue to be returned by * the next call to wgetch(). * - * flushinp() throws away any type-ahead that has been typed by the + * flushinp() throws away any type-ahead that has been typed by the * user and has not yet been read by the program. * - * PDC_get_key_modifiers() returns the keyboard modifiers (shift, - * control, alt, numlock) effective at the time of the last getch() - * call, if PDC_save_key_modifiers(true) has been called before the - * getch(). Use the macros PDC_KEY_MODIFIER_* to determine which - * modifier(s) were set. PDC_return_key_modifiers() tells getch() - * to return modifier keys pressed alone as keystrokes (KEY_ALT_L, + * PDC_get_key_modifiers() returns the keyboard modifiers (shift, + * control, alt, numlock) effective at the time of the last getch() + * call, if PDC_save_key_modifiers(true) has been called before the + * getch(). Use the macros PDC_KEY_MODIFIER_* to determine which + * modifier(s) were set. PDC_return_key_modifiers() tells getch() + * to return modifier keys pressed alone as keystrokes (KEY_ALT_L, * etc.). These may not work on all platforms. * - * NOTE: getch() and ungetch() are implemented as macros, to avoid + * NOTE: getch() and ungetch() are implemented as macros, to avoid * conflict with many DOS compiler's runtime libraries. * * Return Value: - * These functions return ERR or the value of the character, meta + * These functions return ERR or the value of the character, meta * character or function key token. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_getstr.c b/graphics/pdcurs34/pdcurses/pdc_getstr.c index 22ce03ab7..93a77ab47 100644 --- a/graphics/pdcurs34/pdcurses/pdc_getstr.c +++ b/graphics/pdcurs34/pdcurses/pdc_getstr.c @@ -60,20 +60,20 @@ * int mvwgetn_wstr(WINDOW *win, int y, int x, wint_t *wstr, int n); * * Description: - * These routines call wgetch() repeatedly to build a string, - * interpreting erase and kill characters along the way, until a - * newline or carriage return is received. When PDCurses is built - * with wide-character support enabled, the narrow-character - * functions convert the wgetch()'d values into a multibyte string - * in the current locale before returning it. The resulting string - * is placed in the area pointed to by *str. The routines with n as + * These routines call wgetch() repeatedly to build a string, + * interpreting erase and kill characters along the way, until a + * newline or carriage return is received. When PDCurses is built + * with wide-character support enabled, the narrow-character + * functions convert the wgetch()'d values into a multibyte string + * in the current locale before returning it. The resulting string + * is placed in the area pointed to by *str. The routines with n as * the last argument read at most n characters. * - * Note that there's no way to know how long the buffer passed to + * Note that there's no way to know how long the buffer passed to * wgetstr() is, so use wgetnstr() to avoid buffer overflows. * * Return Value: - * This functions return ERR on failure or any other value on + * This functions return ERR on failure or any other value on * success. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_getyx.c b/graphics/pdcurs34/pdcurses/pdc_getyx.c index 536c75f2f..ae97eec6e 100644 --- a/graphics/pdcurs34/pdcurses/pdc_getyx.c +++ b/graphics/pdcurs34/pdcurses/pdc_getyx.c @@ -59,12 +59,12 @@ * int getmaxx(WINDOW *win); * * Description: - * The getyx() macro (defined in curses.h -- the prototypes here - * are merely illustrative) puts the current cursor position of the - * specified window into y and x. getbegyx() and getmaxyx() return - * the starting coordinates and size of the specified window, - * respectively. getparyx() returns the starting coordinates of the - * parent's window, if the specified window is a subwindow; + * The getyx() macro (defined in curses.h -- the prototypes here + * are merely illustrative) puts the current cursor position of the + * specified window into y and x. getbegyx() and getmaxyx() return + * the starting coordinates and size of the specified window, + * respectively. getparyx() returns the starting coordinates of the + * parent's window, if the specified window is a subwindow; * otherwise it sets y and x to -1. These are all macros. * * getsyx() gets the coordinates of the virtual screen cursor, and diff --git a/graphics/pdcurs34/pdcurses/pdc_inch.c b/graphics/pdcurs34/pdcurses/pdc_inch.c index f749b31a9..d6a5ce157 100644 --- a/graphics/pdcurs34/pdcurses/pdc_inch.c +++ b/graphics/pdcurs34/pdcurses/pdc_inch.c @@ -52,14 +52,14 @@ * int mvwin_wch(WINDOW *win, int y, int x, cchar_t *wcval); * * Description: - * The inch() functions retrieve the character and attribute from - * the current or specified window position, in the form of a + * The inch() functions retrieve the character and attribute from + * the current or specified window position, in the form of a * chtype. If a NULL window is specified, (chtype)ERR is returned. * - * The in_wch() functions are the wide-character versions; instead - * of returning a chtype, they store a cchar_t at the address - * specified by wcval, and return OK or ERR. (No value is stored - * when ERR is returned.) Note that in PDCurses, chtype and cchar_t + * The in_wch() functions are the wide-character versions; instead + * of returning a chtype, they store a cchar_t at the address + * specified by wcval, and return OK or ERR. (No value is stored + * when ERR is returned.) Note that in PDCurses, chtype and cchar_t * are the same. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_inchstr.c b/graphics/pdcurs34/pdcurses/pdc_inchstr.c index f417bb1be..c360fe899 100644 --- a/graphics/pdcurs34/pdcurses/pdc_inchstr.c +++ b/graphics/pdcurs34/pdcurses/pdc_inchstr.c @@ -60,12 +60,12 @@ * int mvwin_wchnstr(WINDOW *win, int y, int x, cchar_t *wch, int n); * * Description: - * These routines read a chtype or cchar_t string from the window, - * starting at the current or specified position, and ending at the + * These routines read a chtype or cchar_t string from the window, + * starting at the current or specified position, and ending at the * right margin, or after n elements, whichever is less. * * Return Value: - * All functions return the number of elements read, or ERR on + * All functions return the number of elements read, or ERR on * error. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_initscr.c b/graphics/pdcurs34/pdcurses/pdc_initscr.c index 4497ea895..ef95c11c2 100644 --- a/graphics/pdcurs34/pdcurses/pdc_initscr.c +++ b/graphics/pdcurs34/pdcurses/pdc_initscr.c @@ -54,23 +54,23 @@ * const char *curses_version(void); * * Description: - * initscr() should be the first curses routine called. It will - * initialize all curses data structures, and arrange that the - * first call to refresh() will clear the screen. In case of - * error, initscr() will write a message to standard error and end + * initscr() should be the first curses routine called. It will + * initialize all curses data structures, and arrange that the + * first call to refresh() will clear the screen. In case of + * error, initscr() will write a message to standard error and end * the program. * - * endwin() should be called before exiting or escaping from curses - * mode temporarily. It will restore tty modes, move the cursor to - * the lower left corner of the screen and reset the terminal into - * the proper non-visual mode. To resume curses after a temporary + * endwin() should be called before exiting or escaping from curses + * mode temporarily. It will restore tty modes, move the cursor to + * the lower left corner of the screen and reset the terminal into + * the proper non-visual mode. To resume curses after a temporary * escape, call refresh() or doupdate(). * - * isendwin() returns true if endwin() has been called without a + * isendwin() returns true if endwin() has been called without a * subsequent refresh, unless SP is NULL. * - * In some implementations of curses, newterm() allows the use of - * multiple terminals. Here, it's just an alternative interface for + * In some implementations of curses, newterm() allows the use of + * multiple terminals. Here, it's just an alternative interface for * initscr(). It always returns SP, or NULL. * * delscreen() frees the memory allocated by newterm() or @@ -78,29 +78,29 @@ * usually not needed. In PDCurses, the parameter must be the * value of SP, and delscreen() sets SP to NULL. * - * set_term() does nothing meaningful in PDCurses, but is included + * set_term() does nothing meaningful in PDCurses, but is included * for compatibility with other curses implementations. * - * resize_term() is effectively two functions: When called with - * nonzero values for nlines and ncols, it attempts to resize the - * screen to the given size. When called with (0, 0), it merely - * adjusts the internal structures to match the current size after - * the screen is resized by the user. On the currently supported - * platforms, this functionality is mutually exclusive: X11 allows - * user resizing, while DOS, OS/2 and Win32 allow programmatic - * resizing. If you want to support user resizing, you should check - * for getch() returning KEY_RESIZE, and/or call is_termresized() - * at appropriate times; if either condition occurs, call - * resize_term(0, 0). Then, with either user or programmatic - * resizing, you'll have to resize any windows you've created, as + * resize_term() is effectively two functions: When called with + * nonzero values for nlines and ncols, it attempts to resize the + * screen to the given size. When called with (0, 0), it merely + * adjusts the internal structures to match the current size after + * the screen is resized by the user. On the currently supported + * platforms, this functionality is mutually exclusive: X11 allows + * user resizing, while DOS, OS/2 and Win32 allow programmatic + * resizing. If you want to support user resizing, you should check + * for getch() returning KEY_RESIZE, and/or call is_termresized() + * at appropriate times; if either condition occurs, call + * resize_term(0, 0). Then, with either user or programmatic + * resizing, you'll have to resize any windows you've created, as * appropriate; resize_term() only handles stdscr and curscr. * * is_termresized() returns true if the curses screen has been - * resized by the user, and a call to resize_term() is needed. - * Checking for KEY_RESIZE is generally preferable, unless you're + * resized by the user, and a call to resize_term() is needed. + * Checking for KEY_RESIZE is generally preferable, unless you're * not handling the keyboard. * - * curses_version() returns a string describing the version of + * curses_version() returns a string describing the version of * PDCurses. * * Return Value: diff --git a/graphics/pdcurs34/pdcurses/pdc_inopts.c b/graphics/pdcurs34/pdcurses/pdc_inopts.c index 4c6eaab9f..34a3a9a02 100644 --- a/graphics/pdcurs34/pdcurses/pdc_inopts.c +++ b/graphics/pdcurs34/pdcurses/pdc_inopts.c @@ -65,57 +65,57 @@ * int nocrmode(void); * * Description: - * cbreak() and nocbreak() toggle cbreak mode. In cbreak mode, - * characters typed by the user are made available immediately, and - * erase/kill character processing is not performed. In nocbreak - * mode, typed characters are buffered until a newline or carriage - * return. Interrupt and flow control characters are unaffected by + * cbreak() and nocbreak() toggle cbreak mode. In cbreak mode, + * characters typed by the user are made available immediately, and + * erase/kill character processing is not performed. In nocbreak + * mode, typed characters are buffered until a newline or carriage + * return. Interrupt and flow control characters are unaffected by * this mode. PDCurses always starts in cbreak mode. * - * echo() and noecho() control whether typed characters are echoed - * by the input routine. Initially, input characters are echoed. + * echo() and noecho() control whether typed characters are echoed + * by the input routine. Initially, input characters are echoed. * Subsequent calls to echo() and noecho() do not flush type-ahead. * - * halfdelay() is similar to cbreak(), but allows for a time limit - * to be specified, in tenths of a second. This causes getch() to - * block for that period before returning ERR if no key has been + * halfdelay() is similar to cbreak(), but allows for a time limit + * to be specified, in tenths of a second. This causes getch() to + * block for that period before returning ERR if no key has been * received. tenths must be between 1 and 255. * - * keypad() controls whether getch() returns function/special keys - * as single key codes (e.g., the left arrow key as KEY_LEFT). Per - * X/Open, the default for keypad mode is OFF. You'll probably want - * it on. With keypad mode off, if a special key is pressed, + * keypad() controls whether getch() returns function/special keys + * as single key codes (e.g., the left arrow key as KEY_LEFT). Per + * X/Open, the default for keypad mode is OFF. You'll probably want + * it on. With keypad mode off, if a special key is pressed, * getch() does nothing or returns ERR. * - * nodelay() controls whether wgetch() is a non-blocking call. If - * the option is enabled, and no input is ready, wgetch() will - * return ERR. If disabled, wgetch() will hang until input is + * nodelay() controls whether wgetch() is a non-blocking call. If + * the option is enabled, and no input is ready, wgetch() will + * return ERR. If disabled, wgetch() will hang until input is * ready. * - * nl() enables the translation of a carriage return into a newline - * on input. nonl() disables this. Initially, the translation does + * nl() enables the translation of a carriage return into a newline + * on input. nonl() disables this. Initially, the translation does * occur. * - * raw() and noraw() toggle raw mode. Raw mode is similar to cbreak - * mode, in that characters typed are immediately passed through to - * the user program. The difference is that in raw mode, the INTR, - * QUIT, SUSP, and STOP characters are passed through without being + * raw() and noraw() toggle raw mode. Raw mode is similar to cbreak + * mode, in that characters typed are immediately passed through to + * the user program. The difference is that in raw mode, the INTR, + * QUIT, SUSP, and STOP characters are passed through without being * interpreted, and without generating a signal. * * In PDCurses, the meta() function sets raw mode on or off. * - * timeout() and wtimeout() set blocking or non-blocking reads for - * the specified window. The delay is measured in milliseconds. If - * it's negative, a blocking read is used; if zero, then non- - * blocking reads are done -- if no input is waiting, ERR is - * returned immediately. If the delay is positive, the read blocks + * timeout() and wtimeout() set blocking or non-blocking reads for + * the specified window. The delay is measured in milliseconds. If + * it's negative, a blocking read is used; if zero, then non- + * blocking reads are done -- if no input is waiting, ERR is + * returned immediately. If the delay is positive, the read blocks * for the delay period; if the period expires, ERR is returned. * * intrflush(), notimeout(), noqiflush(), qiflush() and typeahead() - * do nothing in PDCurses, but are included for compatibility with + * do nothing in PDCurses, but are included for compatibility with * other curses implementations. * - * crmode() and nocrmode() are archaic equivalents to cbreak() and + * crmode() and nocrmode() are archaic equivalents to cbreak() and * nocbreak(), respectively. * * Return Value: @@ -319,7 +319,7 @@ void wtimeout(WINDOW * win, int delay) } else if (!delay) { - /* This causes a non-blocking read on the window, so turn off delay mode + /* This causes a non-blocking read on the window, so turn off delay mode */ win->_nodelay = true; diff --git a/graphics/pdcurs34/pdcurses/pdc_insch.c b/graphics/pdcurs34/pdcurses/pdc_insch.c index 4462834a3..8a0dcd84c 100644 --- a/graphics/pdcurs34/pdcurses/pdc_insch.c +++ b/graphics/pdcurs34/pdcurses/pdc_insch.c @@ -57,20 +57,20 @@ * int mvwins_wch(WINDOW *win, int y, int x, const cchar_t *wch); * * Description: - * The insch() functions insert a chtype into the window at the - * current or specified cursor position. The cursor is NOT - * advanced. A newline is equivalent to clrtoeol(); tabs are - * expanded; other control characters are converted as with + * The insch() functions insert a chtype into the window at the + * current or specified cursor position. The cursor is NOT + * advanced. A newline is equivalent to clrtoeol(); tabs are + * expanded; other control characters are converted as with * unctrl(). * * The ins_wch() functions are the wide-character * equivalents, taking cchar_t pointers rather than chtypes. * * Video attributes can be combined with a character by ORing - * them into the parameter. Text, including attributes, can be + * them into the parameter. Text, including attributes, can be * copied from one place to another using inch() and insch(). * - * insrawch() etc. are PDCurses-specific wrappers for insch() etc. + * insrawch() etc. are PDCurses-specific wrappers for insch() etc. * that disable the translation of control characters. * * Return Value: @@ -171,7 +171,7 @@ int winsch(WINDOW * win, chtype ch) int maxx; chtype *temp; - /* If the incoming character doesn't have its own attribute, then use the + /* If the incoming character doesn't have its own attribute, then use the * current attributes for the window. If it has attributes but not a * color component, OR the attributes to the current attributes for the * window. If it has a color component, use the attributes solely from @@ -182,7 +182,7 @@ int winsch(WINDOW * win, chtype ch) attr |= win->_attrs; } - /* wrs (4/10/93): Apply the same sort of logic for the window background, + /* wrs (4/10/93): Apply the same sort of logic for the window background, * in that it only takes precedence if other color attributes are not * there and that the background character will only print if the * printing character is blank. */ diff --git a/graphics/pdcurs34/pdcurses/pdc_insstr.c b/graphics/pdcurs34/pdcurses/pdc_insstr.c index 15ed5a986..232f4c856 100644 --- a/graphics/pdcurs34/pdcurses/pdc_insstr.c +++ b/graphics/pdcurs34/pdcurses/pdc_insstr.c @@ -64,12 +64,12 @@ * at the current cursor position, by repeatedly calling winsch(). * When PDCurses is built with wide-character support enabled, the * narrow-character functions treat the string as a multibyte - * string in the current locale, and convert it first. All - * characters to the right of the cursor are moved to the right, - * with the possibility of the rightmost characters on the line - * being lost. The cursor position does not change (after moving - * to y, x, if specified). The routines with n as the last - * argument insert at most n characters; if n is negative, then the + * string in the current locale, and convert it first. All + * characters to the right of the cursor are moved to the right, + * with the possibility of the rightmost characters on the line + * being lost. The cursor position does not change (after moving + * to y, x, if specified). The routines with n as the last + * argument insert at most n characters; if n is negative, then the * entire string is inserted. * * Return Value: diff --git a/graphics/pdcurs34/pdcurses/pdc_instr.c b/graphics/pdcurs34/pdcurses/pdc_instr.c index 96c017f97..dfad78a90 100644 --- a/graphics/pdcurs34/pdcurses/pdc_instr.c +++ b/graphics/pdcurs34/pdcurses/pdc_instr.c @@ -60,16 +60,16 @@ * int mvwinnwstr(WINDOW *win, int y, int x, wchar_t *wstr, int n); * * Description: - * These functions take characters (or wide characters) from the - * current or specified position in the window, and return them as - * a string in str (or wstr). Attributes are ignored. The functions - * with n as the last argument return a string at most n characters + * These functions take characters (or wide characters) from the + * current or specified position in the window, and return them as + * a string in str (or wstr). Attributes are ignored. The functions + * with n as the last argument return a string at most n characters * long. * * Return Value: - * Upon successful completion, innstr(), mvinnstr(), mvwinnstr() + * Upon successful completion, innstr(), mvinnstr(), mvwinnstr() * and winnstr() return the number of characters actually read into - * the string; instr(), mvinstr(), mvwinstr() and winstr() return + * the string; instr(), mvinstr(), mvwinstr() and winstr() return * OK. Otherwise, all these functions return ERR. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_kernel.c b/graphics/pdcurs34/pdcurses/pdc_kernel.c index ace3344db..2ba085199 100644 --- a/graphics/pdcurs34/pdcurses/pdc_kernel.c +++ b/graphics/pdcurs34/pdcurses/pdc_kernel.c @@ -77,17 +77,17 @@ * 0 makes it disappear; 1 makes it appear "normal" (usually an * underline) and 2 makes it "highly visible" (usually a block). * - * ripoffline() reduces the size of stdscr by one line. If the - * "line" parameter is positive, the line is removed from the top - * of the screen; if negative, from the bottom. Up to 5 lines can - * be ripped off stdscr by calling ripoffline() repeatedly. The - * function argument, init, is called from within initscr() or - * newterm(), so ripoffline() must be called before either of these - * functions. The init function receives a pointer to a one-line - * WINDOW, and the width of the window. Calling ripoffline() with a + * ripoffline() reduces the size of stdscr by one line. If the + * "line" parameter is positive, the line is removed from the top + * of the screen; if negative, from the bottom. Up to 5 lines can + * be ripped off stdscr by calling ripoffline() repeatedly. The + * function argument, init, is called from within initscr() or + * newterm(), so ripoffline() must be called before either of these + * functions. The init function receives a pointer to a one-line + * WINDOW, and the width of the window. Calling ripoffline() with a * NULL init function pointer is an error. * - * napms() suspends the program for the specified number of + * napms() suspends the program for the specified number of * milliseconds. draino() is an archaic equivalent. * * resetterm(), fixterm() and saveterm() are archaic equivalents diff --git a/graphics/pdcurs34/pdcurses/pdc_keyname.c b/graphics/pdcurs34/pdcurses/pdc_keyname.c index 6b6fdac77..8b0ec3c5c 100644 --- a/graphics/pdcurs34/pdcurses/pdc_keyname.c +++ b/graphics/pdcurs34/pdcurses/pdc_keyname.c @@ -48,13 +48,13 @@ * bool has_key(int key); * * Description: - * keyname() returns a string corresponding to the argument key. + * keyname() returns a string corresponding to the argument key. * key may be any key returned by wgetch(). * - * key_name() is the wide-character version. It takes a wchar_t + * key_name() is the wide-character version. It takes a wchar_t * parameter, but still returns a char *. * - * has_key() returns true for recognized keys, false otherwise. + * has_key() returns true for recognized keys, false otherwise. * This function is an ncurses extension. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_mouse.c b/graphics/pdcurs34/pdcurses/pdc_mouse.c index f872f41f8..2abffb250 100644 --- a/graphics/pdcurs34/pdcurses/pdc_mouse.c +++ b/graphics/pdcurs34/pdcurses/pdc_mouse.c @@ -123,9 +123,9 @@ * reported) through 1000ms. In x11, the timeout can also be set * via the clickPeriod resource. The return value from * mouseinterval() is the old timeout. To check the old value - * without setting a new one, call it with a parameter of -1. Note - * that although there's no classic equivalent for this function - * (apart from the clickPeriod resource), the value set applies in + * without setting a new one, call it with a parameter of -1. Note + * that although there's no classic equivalent for this function + * (apart from the clickPeriod resource), the value set applies in * both interfaces. * * wenclose() reports whether the given screen-relative y, x @@ -143,23 +143,23 @@ * mousemask() is nearly equivalent to mouse_set(), but instead of * OK/ERR, it returns the value of the mask after setting it. (This * isn't necessarily the same value passed in, since the mask could - * be altered on some platforms.) And if the second parameter is a - * non-null pointer, mousemask() stores the previous mask value - * there. Also, since the ncurses interface doesn't work with + * be altered on some platforms.) And if the second parameter is a + * non-null pointer, mousemask() stores the previous mask value + * there. Also, since the ncurses interface doesn't work with * PDCurses' BUTTON_MOVED events, mousemask() filters them out. * - * nc_getmouse() returns the current mouse status in an MEVENT - * struct. This is equivalent to ncurses' getmouse(), renamed to - * avoid conflict with PDCurses' getmouse(). But if you define - * NCURSES_MOUSE_VERSION (preferably as 2) before including - * curses.h, it defines getmouse() to nc_getmouse(), along with a - * few other redefintions needed for compatibility with ncurses - * code. nc_getmouse() calls request_mouse_pos(), which (not + * nc_getmouse() returns the current mouse status in an MEVENT + * struct. This is equivalent to ncurses' getmouse(), renamed to + * avoid conflict with PDCurses' getmouse(). But if you define + * NCURSES_MOUSE_VERSION (preferably as 2) before including + * curses.h, it defines getmouse() to nc_getmouse(), along with a + * few other redefintions needed for compatibility with ncurses + * code. nc_getmouse() calls request_mouse_pos(), which (not * getmouse()) is the classic equivalent. * - * ungetmouse() is the mouse equivalent of ungetch(). However, - * PDCurses doesn't maintain a queue of mouse events; only one can - * be pushed back, and it can overwrite or be overwritten by real + * ungetmouse() is the mouse equivalent of ungetch(). However, + * PDCurses doesn't maintain a queue of mouse events; only one can + * be pushed back, and it can overwrite or be overwritten by real * mouse events. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_outopts.c b/graphics/pdcurs34/pdcurses/pdc_outopts.c index a4160e45e..1dea1bbc4 100644 --- a/graphics/pdcurs34/pdcurses/pdc_outopts.c +++ b/graphics/pdcurs34/pdcurses/pdc_outopts.c @@ -53,12 +53,12 @@ * int raw_output(bool bf); * * Description: - * With clearok(), if bf is true, the next call to wrefresh() with - * this window will clear the screen completely and redraw the + * With clearok(), if bf is true, the next call to wrefresh() with + * this window will clear the screen completely and redraw the * entire screen. * - * immedok(), called with a second argument of true, causes an - * automatic wrefresh() every time a change is made to the + * immedok(), called with a second argument of true, causes an + * automatic wrefresh() every time a change is made to the * specified window. * * Normally, the hardware cursor is left at the location of the @@ -68,17 +68,17 @@ * the need for cursor motions. If possible, the cursor is made * invisible when this option is enabled. * - * wsetscrreg() sets a scrolling region in a window; "top" and - * "bot" are the line numbers for the top and bottom margins. If - * this option and scrollok() are enabled, any attempt to move off - * the bottom margin will cause all lines in the scrolling region + * wsetscrreg() sets a scrolling region in a window; "top" and + * "bot" are the line numbers for the top and bottom margins. If + * this option and scrollok() are enabled, any attempt to move off + * the bottom margin will cause all lines in the scrolling region * to scroll up one line. setscrreg() is the stdscr version. * - * idlok() and idcok() do nothing in PDCurses, but are provided for + * idlok() and idcok() do nothing in PDCurses, but are provided for * compatibility with other curses implementations. * - * raw_output() enables the output of raw characters using the - * standard *add* and *ins* curses functions (that is, it disables + * raw_output() enables the output of raw characters using the + * standard *add* and *ins* curses functions (that is, it disables * translation of control characters). * * Return Value: diff --git a/graphics/pdcurs34/pdcurses/pdc_overlay.c b/graphics/pdcurs34/pdcurses/pdc_overlay.c index c519dfc9f..3c3de6771 100644 --- a/graphics/pdcurs34/pdcurses/pdc_overlay.c +++ b/graphics/pdcurs34/pdcurses/pdc_overlay.c @@ -74,7 +74,7 @@ * copywin Y - 3.0 * * - * Thanks to Andreas Otte for the + * Thanks to Andreas Otte for the * corrected overlay()/overwrite() behavior. */ diff --git a/graphics/pdcurs34/pdcurses/pdc_pad.c b/graphics/pdcurs34/pdcurses/pdc_pad.c index 83618106a..19de198bb 100644 --- a/graphics/pdcurs34/pdcurses/pdc_pad.c +++ b/graphics/pdcurs34/pdcurses/pdc_pad.c @@ -63,13 +63,13 @@ * to specify the part of the pad to be displayed, and the location * to use on the screen. * - * newpad() creates a new pad data structure. + * newpad() creates a new pad data structure. * * subpad() creates a new sub-pad within a pad, at position (begy, - * begx), with dimensions of nlines lines and ncols columns. This - * position is relative to the pad, and not to the screen as with - * subwin. Changes to either the parent pad or sub-pad will affect - * both. When using sub-pads, you may need to call touchwin() + * begx), with dimensions of nlines lines and ncols columns. This + * position is relative to the pad, and not to the screen as with + * subwin. Changes to either the parent pad or sub-pad will affect + * both. When using sub-pads, you may need to call touchwin() * before calling prefresh(). * * pnoutrefresh() copies the specified pad to the virtual screen. @@ -78,7 +78,7 @@ * * These routines are analogous to wnoutrefresh() and wrefresh(). * (py, px) specifies the upper left corner of the part of the pad - * to be displayed; (sy1, sx1) and (sy2, sx2) describe the screen + * to be displayed; (sy1, sx1) and (sy2, sx2) describe the screen * rectangle that will contain the selected part of the pad. * * pechochar() is functionally equivalent to addch() followed by diff --git a/graphics/pdcurs34/pdcurses/pdc_panel.c b/graphics/pdcurs34/pdcurses/pdc_panel.c index 592a25379..102d4e43c 100644 --- a/graphics/pdcurs34/pdcurses/pdc_panel.c +++ b/graphics/pdcurs34/pdcurses/pdc_panel.c @@ -77,61 +77,61 @@ * panels, fetch and set their associated windows, shuffle panels * in the deck, and manipulate panels in other ways. * - * bottom_panel() places pan at the bottom of the deck. The size, + * bottom_panel() places pan at the bottom of the deck. The size, * location and contents of the panel are unchanged. * * del_panel() deletes pan, but not its associated winwow. * - * hide_panel() removes a panel from the deck and thus hides it + * hide_panel() removes a panel from the deck and thus hides it * from view. * - * move_panel() moves the curses window associated with pan, so - * that its upper lefthand corner is at the supplied coordinates. + * move_panel() moves the curses window associated with pan, so + * that its upper lefthand corner is at the supplied coordinates. * (Do not use mvwin() on the window.) * - * new_panel() creates a new panel associated with win and returns - * the panel pointer. The new panel is placed at the top of the + * new_panel() creates a new panel associated with win and returns + * the panel pointer. The new panel is placed at the top of the * deck. * - * panel_above() returns a pointer to the panel in the deck above - * pan, or NULL if pan is the top panel. If the value of pan passed - * is NULL, this function returns a pointer to the bottom panel in + * panel_above() returns a pointer to the panel in the deck above + * pan, or NULL if pan is the top panel. If the value of pan passed + * is NULL, this function returns a pointer to the bottom panel in * the deck. * - * panel_below() returns a pointer to the panel in the deck below - * pan, or NULL if pan is the bottom panel. If the value of pan - * passed is NULL, this function returns a pointer to the top panel + * panel_below() returns a pointer to the panel in the deck below + * pan, or NULL if pan is the bottom panel. If the value of pan + * passed is NULL, this function returns a pointer to the top panel * in the deck. * * panel_hidden() returns OK if pan is hidden and ERR if it is not. * - * panel_userptr() - Each panel has a user pointer available for - * maintaining relevant information. This function returns a - * pointer to that information previously set up by + * panel_userptr() - Each panel has a user pointer available for + * maintaining relevant information. This function returns a + * pointer to that information previously set up by * set_panel_userptr(). * - * panel_window() returns a pointer to the curses window associated + * panel_window() returns a pointer to the curses window associated * with the panel. * * replace_panel() replaces the current window of pan with win. * - * set_panel_userptr() - Each panel has a user pointer available - * for maintaining relevant information. This function sets the + * set_panel_userptr() - Each panel has a user pointer available + * for maintaining relevant information. This function sets the * value of that information. * - * show_panel() makes a previously hidden panel visible and places + * show_panel() makes a previously hidden panel visible and places * it back in the deck on top. * - * top_panel() places pan on the top of the deck. The size, + * top_panel() places pan on the top of the deck. The size, * location and contents of the panel are unchanged. * - * update_panels() refreshes the virtual screen to reflect the - * depth relationships between the panels in the deck. The user + * update_panels() refreshes the virtual screen to reflect the + * depth relationships between the panels in the deck. The user * must use doupdate() to refresh the physical screen. * * Return Value: - * Each routine that returns a pointer to an object returns NULL if - * an error occurs. Each panel routine that returns an integer, + * Each routine that returns a pointer to an object returns NULL if + * an error occurs. Each panel routine that returns an integer, * returns OK if it executes successfully and ERR if it does not. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_printw.c b/graphics/pdcurs34/pdcurses/pdc_printw.c index bb58ac2bf..0c5a04d38 100644 --- a/graphics/pdcurs34/pdcurses/pdc_printw.c +++ b/graphics/pdcurs34/pdcurses/pdc_printw.c @@ -49,13 +49,13 @@ * int vw_printw(WINDOW *win, const char *fmt, va_list varglist); * * Description: - * The printw() functions add a formatted string to the window at - * the current or specified cursor position. The format strings are - * the same as used in the standard C library's printf(). (printw() + * The printw() functions add a formatted string to the window at + * the current or specified cursor position. The format strings are + * the same as used in the standard C library's printf(). (printw() * can be used as a drop-in replacement for printf().) * * Return Value: - * All functions return the number of characters printed, or + * All functions return the number of characters printed, or * ERR on error. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_refresh.c b/graphics/pdcurs34/pdcurses/pdc_refresh.c index 7515e0e03..1e44b23d4 100644 --- a/graphics/pdcurs34/pdcurses/pdc_refresh.c +++ b/graphics/pdcurs34/pdcurses/pdc_refresh.c @@ -49,28 +49,28 @@ * int wredrawln(WINDOW *win, int beg_line, int num_lines); * * Description: - * wrefresh() copies the named window to the physical terminal - * screen, taking into account what is already there in order to - * optimize cursor movement. refresh() does the same, using stdscr. - * These routines must be called to get any output on the terminal, - * as other routines only manipulate data structures. Unless - * leaveok() has been enabled, the physical cursor of the terminal + * wrefresh() copies the named window to the physical terminal + * screen, taking into account what is already there in order to + * optimize cursor movement. refresh() does the same, using stdscr. + * These routines must be called to get any output on the terminal, + * as other routines only manipulate data structures. Unless + * leaveok() has been enabled, the physical cursor of the terminal * is left at the location of the window's cursor. * - * wnoutrefresh() and doupdate() allow multiple updates with more - * efficiency than wrefresh() alone. wrefresh() works by first - * calling wnoutrefresh(), which copies the named window to the - * virtual screen. It then calls doupdate(), which compares the - * virtual screen to the physical screen and does the actual - * update. A series of calls to wrefresh() will result in - * alternating calls to wnoutrefresh() and doupdate(), causing - * several bursts of output to the screen. By first calling - * wnoutrefresh() for each window, it is then possible to call + * wnoutrefresh() and doupdate() allow multiple updates with more + * efficiency than wrefresh() alone. wrefresh() works by first + * calling wnoutrefresh(), which copies the named window to the + * virtual screen. It then calls doupdate(), which compares the + * virtual screen to the physical screen and does the actual + * update. A series of calls to wrefresh() will result in + * alternating calls to wnoutrefresh() and doupdate(), causing + * several bursts of output to the screen. By first calling + * wnoutrefresh() for each window, it is then possible to call * doupdate() only once. * - * In PDCurses, redrawwin() is equivalent to touchwin(), and - * wredrawln() is the same as touchline(). In some other curses - * implementations, there's a subtle distinction, but it has no + * In PDCurses, redrawwin() is equivalent to touchwin(), and + * wredrawln() is the same as touchline(). In some other curses + * implementations, there's a subtle distinction, but it has no * meaning in PDCurses. * * Return Value: diff --git a/graphics/pdcurs34/pdcurses/pdc_scrdump.c b/graphics/pdcurs34/pdcurses/pdc_scrdump.c index b0aa9eabe..1a974e368 100644 --- a/graphics/pdcurs34/pdcurses/pdc_scrdump.c +++ b/graphics/pdcurs34/pdcurses/pdc_scrdump.c @@ -49,32 +49,32 @@ * int scr_set(const char *filename); * * Description: - * getwin() reads window-related data previously stored in a file - * by putwin(). It then creates and initialises a new window using + * getwin() reads window-related data previously stored in a file + * by putwin(). It then creates and initialises a new window using * that data. * - * putwin() writes all data associated with a window into a file, - * using an unspecified format. This information can be retrieved + * putwin() writes all data associated with a window into a file, + * using an unspecified format. This information can be retrieved * later using getwin(). * - * scr_dump() writes the current contents of the virtual screen to + * scr_dump() writes the current contents of the virtual screen to * the file named by filename in an unspecified format. * - * scr_restore() function sets the virtual screen to the contents - * of the file named by filename, which must have been written - * using scr_dump(). The next refresh operation restores the screen + * scr_restore() function sets the virtual screen to the contents + * of the file named by filename, which must have been written + * using scr_dump(). The next refresh operation restores the screen * to the way it looked in the dump file. * - * In PDCurses, scr_init() does nothing, and scr_set() is a synonym - * for scr_restore(). Also, scr_dump() and scr_restore() save and - * load from curscr. This differs from some other implementations, - * where scr_init() works with curscr, and scr_restore() works with - * newscr; but the effect should be the same. (PDCurses has no + * In PDCurses, scr_init() does nothing, and scr_set() is a synonym + * for scr_restore(). Also, scr_dump() and scr_restore() save and + * load from curscr. This differs from some other implementations, + * where scr_init() works with curscr, and scr_restore() works with + * newscr; but the effect should be the same. (PDCurses has no * newscr.) * * Return Value: - * On successful completion, getwin() returns a pointer to the - * window it created. Otherwise, it returns a null pointer. Other + * On successful completion, getwin() returns a pointer to the + * window it created. Otherwise, it returns a null pointer. Other * functions return OK or ERR. * * Portability X/Open BSD SYS V @@ -99,7 +99,7 @@ * Pre-processor Defintiions ****************************************************************************/ -#define DUMPVER 1 /* Should be updated whenever the WINDOW struct +#define DUMPVER 1 /* Should be updated whenever the WINDOW struct * is changed */ /**************************************************************************** diff --git a/graphics/pdcurs34/pdcurses/pdc_scroll.c b/graphics/pdcurs34/pdcurses/pdc_scroll.c index 4fb0203d7..fd0c77dfd 100644 --- a/graphics/pdcurs34/pdcurses/pdc_scroll.c +++ b/graphics/pdcurs34/pdcurses/pdc_scroll.c @@ -46,15 +46,15 @@ * int wscrl(WINDOW *win, int n); * * Description: - * scroll() causes the window to scroll up one line. This involves + * scroll() causes the window to scroll up one line. This involves * moving the lines in the window data strcture. * - * With a positive n, scrl() and wscrl() scroll the window up n - * lines (line i + n becomes i); otherwise they scroll the window + * With a positive n, scrl() and wscrl() scroll the window up n + * lines (line i + n becomes i); otherwise they scroll the window * down n lines. - - * For these functions to work, scrolling must be enabled via - * scrollok(). Note also that scrolling is not allowed if the + + * For these functions to work, scrolling must be enabled via + * scrollok(). Note also that scrolling is not allowed if the * supplied window is a pad. * * Return Value: diff --git a/graphics/pdcurs34/pdcurses/pdc_slk.c b/graphics/pdcurs34/pdcurses/pdc_slk.c index 200a75c4f..43cc35655 100644 --- a/graphics/pdcurs34/pdcurses/pdc_slk.c +++ b/graphics/pdcurs34/pdcurses/pdc_slk.c @@ -66,15 +66,15 @@ * wchar_t *slk_wlabel(int labnum) * * Description: - * These functions manipulate a window that contain Soft Label Keys - * (SLK). To use the SLK functions, a call to slk_init() must be - * made BEFORE initscr() or newterm(). slk_init() removes 1 or 2 + * These functions manipulate a window that contain Soft Label Keys + * (SLK). To use the SLK functions, a call to slk_init() must be + * made BEFORE initscr() or newterm(). slk_init() removes 1 or 2 * lines from the useable screen, depending on the format selected. * - * The line(s) removed from the screen are used as a separate + * The line(s) removed from the screen are used as a separate * window, in which SLKs are displayed. * - * slk_init() requires a single parameter which describes the + * slk_init() requires a single parameter which describes the * format of the SLKs as follows: * * 0 3-2-3 format diff --git a/graphics/pdcurs34/pdcurses/pdc_termattr.c b/graphics/pdcurs34/pdcurses/pdc_termattr.c index 478c29a1b..e29bd54b1 100644 --- a/graphics/pdcurs34/pdcurses/pdc_termattr.c +++ b/graphics/pdcurs34/pdcurses/pdc_termattr.c @@ -57,16 +57,16 @@ * char wordchar(void); * * Description: - * baudrate() is supposed to return the output speed of the + * baudrate() is supposed to return the output speed of the * terminal. In PDCurses, it simply returns INT_MAX. * - * has_ic and has_il() return true. These functions have meaning in + * has_ic and has_il() return true. These functions have meaning in * some other implementations of curses. * - * erasechar() and killchar() return ^H and ^U, respectively -- the - * ERASE and KILL characters. In other curses implementations, - * these may vary by terminal type. erasewchar() and killwchar() - * are the wide-character versions; they take a pointer to a + * erasechar() and killchar() return ^H and ^U, respectively -- the + * ERASE and KILL characters. In other curses implementations, + * these may vary by terminal type. erasewchar() and killwchar() + * are the wide-character versions; they take a pointer to a * location in which to store the character, and return OK or ERR. * * longname() returns a pointer to a static area containing a @@ -80,8 +80,8 @@ * termattrs() returns a logical OR of all video attributes * supported by the terminal. * - * wordchar() is a PDCurses extension of the concept behind the - * functions erasechar() and killchar(), returning the "delete + * wordchar() is a PDCurses extension of the concept behind the + * functions erasechar() and killchar(), returning the "delete * word" character, ^W. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_terminfo.c b/graphics/pdcurs34/pdcurses/pdc_terminfo.c index ab42aa50f..5f37c22bc 100644 --- a/graphics/pdcurs34/pdcurses/pdc_terminfo.c +++ b/graphics/pdcurs34/pdcurses/pdc_terminfo.c @@ -67,10 +67,10 @@ * int tputs(const char *, int, int (*)(int)); * * Description: - * mvcur() lets you move the physical cursor without updating any + * mvcur() lets you move the physical cursor without updating any * window cursor positions. It returns OK or ERR. * - * The rest of these functions are currently implemented as stubs, + * The rest of these functions are currently implemented as stubs, * returning the appropriate errors and doing nothing else. * * Portability X/Open BSD SYS V diff --git a/graphics/pdcurs34/pdcurses/pdc_touch.c b/graphics/pdcurs34/pdcurses/pdc_touch.c index afc2b844c..c491897c8 100644 --- a/graphics/pdcurs34/pdcurses/pdc_touch.c +++ b/graphics/pdcurs34/pdcurses/pdc_touch.c @@ -49,26 +49,26 @@ * bool is_wintouched(WINDOW *win); * * Description: - * touchwin() and touchline() throw away all information about - * which parts of the window have been touched, pretending that the - * entire window has been drawn on. This is sometimes necessary - * when using overlapping windows, since a change to one window - * will affect the other window, but the records of which lines - * have been changed in the other window will not reflect the + * touchwin() and touchline() throw away all information about + * which parts of the window have been touched, pretending that the + * entire window has been drawn on. This is sometimes necessary + * when using overlapping windows, since a change to one window + * will affect the other window, but the records of which lines + * have been changed in the other window will not reflect the * change. * - * untouchwin() marks all lines in the window as unchanged since + * untouchwin() marks all lines in the window as unchanged since * the last call to wrefresh(). * - * wtouchln() makes n lines in the window, starting at line y, look - * as if they have (changed == 1) or have not (changed == 0) been + * wtouchln() makes n lines in the window, starting at line y, look + * as if they have (changed == 1) or have not (changed == 0) been * changed since the last call to wrefresh(). * - * is_linetouched() returns true if the specified line in the - * specified window has been changed since the last call to + * is_linetouched() returns true if the specified line in the + * specified window has been changed since the last call to * wrefresh(). * - * is_wintouched() returns true if the specified window + * is_wintouched() returns true if the specified window * has been changed since the last call to wrefresh(). * * Return Value: diff --git a/graphics/pdcurs34/pdcurses/pdc_util.c b/graphics/pdcurs34/pdcurses/pdc_util.c index e595b0740..538eaed1f 100644 --- a/graphics/pdcurs34/pdcurses/pdc_util.c +++ b/graphics/pdcurs34/pdcurses/pdc_util.c @@ -58,38 +58,38 @@ * size_t PDC_wcstombs(char *dest, const wchar_t *src, size_t n); * * Description: - * unctrl() expands the text portion of the chtype c into a - * printable string. Control characters are changed to the "^X" - * notation; others are passed through. wunctrl() is the wide- + * unctrl() expands the text portion of the chtype c into a + * printable string. Control characters are changed to the "^X" + * notation; others are passed through. wunctrl() is the wide- * character version of the function. * * filter() and use_env() are no-ops in PDCurses. * * delay_output() inserts an ms millisecond pause in output. * - * getcchar() works in two modes: When wch is not NULL, it reads - * the cchar_t pointed to by wcval and stores the attributes in + * getcchar() works in two modes: When wch is not NULL, it reads + * the cchar_t pointed to by wcval and stores the attributes in * attrs, the color pair in color_pair, and the text in the - * wide-character string wch. When wch is NULL, getcchar() merely - * returns the number of wide characters in wcval. In either mode, + * wide-character string wch. When wch is NULL, getcchar() merely + * returns the number of wide characters in wcval. In either mode, * the opts argument is unused. * - * setcchar constructs a cchar_t at wcval from the wide-character - * text at wch, the attributes in attr and the color pair in + * setcchar constructs a cchar_t at wcval from the wide-character + * text at wch, the attributes in attr and the color pair in * color_pair. The opts argument is unused. * * Currently, the length returned by getcchar() is always 1 or 0. * Similarly, setcchar() will only take the first wide character * from wch, and ignore any others that it "should" take (i.e., - * combining characters). Nor will it correctly handle any + * combining characters). Nor will it correctly handle any * character outside the basic multilingual plane (UCS-2). * * Return Value: - * unctrl() and wunctrl() return NULL on failure. delay_output() + * unctrl() and wunctrl() return NULL on failure. delay_output() * always returns OK. * - * getcchar() returns the number of wide characters wcval points to - * when wch is NULL; when it's not, getcchar() returns OK or ERR. + * getcchar() returns the number of wide characters wcval points to + * when wch is NULL; when it's not, getcchar() returns OK or ERR. * * setcchar() returns OK or ERR. * diff --git a/graphics/pdcurs34/pdcurses/pdc_window.c b/graphics/pdcurs34/pdcurses/pdc_window.c index 9a2537fca..bca47ba4c 100644 --- a/graphics/pdcurs34/pdcurses/pdc_window.c +++ b/graphics/pdcurs34/pdcurses/pdc_window.c @@ -68,8 +68,8 @@ * LINES - begy; ncols to COLS - begx. Create a new full-screen * window by calling newwin(0, 0, 0, 0). * - * delwin() deletes the named window, freeing all associated - * memory. In the case of overlapping windows, subwindows should be + * delwin() deletes the named window, freeing all associated + * memory. In the case of overlapping windows, subwindows should be * deleted before the main window. * * mvwin() moves the window so that the upper left-hand corner is @@ -110,12 +110,12 @@ * wsyncdown() causes a touchwin() of the current window if any of * its parent's windows have been touched. * - * resize_window() allows the user to resize an existing window. It + * resize_window() allows the user to resize an existing window. It * returns the pointer to the new window, or NULL on failure. * * wresize() is an ncurses-compatible wrapper for resize_window(). * Note that, unlike ncurses, it will NOT process any subwindows of - * the window. (However, you still can call it _on_ subwindows.) It + * the window. (However, you still can call it _on_ subwindows.) It * returns OK or ERR. * * PDC_makenew() allocates all data for a new WINDOW * except the diff --git a/include/graphics/curses.h b/include/graphics/curses.h index 8ecf9f44e..ff4066409 100644 --- a/include/graphics/curses.h +++ b/include/graphics/curses.h @@ -145,8 +145,8 @@ #define BUTTON3_TRIPLE_CLICKED 0x00004000L #define BUTTON3_MOVED 0x00004000L /* PDCurses */ -/* For the ncurses-compatible functions only, BUTTON4_PRESSED and - BUTTON5_PRESSED are returned for mouse scroll wheel up and down; +/* For the ncurses-compatible functions only, BUTTON4_PRESSED and + BUTTON5_PRESSED are returned for mouse scroll wheel up and down; otherwise PDCurses doesn't support buttons 4 and 5 */ #define BUTTON4_RELEASED 0x00008000L @@ -182,13 +182,13 @@ /* PDCurses Text Attributes * - * Originally, PDCurses used a short (16 bits) for its chtype. To include - * color, a number of things had to be sacrificed from the strict Unix and - * System V support. The main problem was fitting all character attributes + * Originally, PDCurses used a short (16 bits) for its chtype. To include + * color, a number of things had to be sacrificed from the strict Unix and + * System V support. The main problem was fitting all character attributes * and color into an unsigned char (all 8 bits!). * - * Today, PDCurses by default uses a long (32 bits) for its chtype, as in - * System V. The short chtype is still available, by undefining CHTYPE_LONG + * Today, PDCurses by default uses a long (32 bits) for its chtype, as in + * System V. The short chtype is still available, by undefining CHTYPE_LONG * and rebuilding the library. * * The following is the structure of a win->_attrs chtype: @@ -200,20 +200,20 @@ * ------------------------------------------------- * color number | attrs | character eg 'a' * - * The available non-color attributes are bold, reverse and blink. Others - * have no effect. The high order char is an index into an array of - * physical colors (defined in color.c) -- 32 foreground/background color + * The available non-color attributes are bold, reverse and blink. Others + * have no effect. The high order char is an index into an array of + * physical colors (defined in color.c) -- 32 foreground/background color * pairs (5 bits) plus 3 bits for other attributes. * * long form: - * + * * ---------------------------------------------------------------------------- * |31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|12|..| 3| 2| 1| 0| * ---------------------------------------------------------------------------- * color number | modifiers | character eg 'a' * - * The available non-color attributes are bold, underline, invisible, - * right-line, left-line, protect, reverse and blink. 256 color pairs (8 + * The available non-color attributes are bold, underline, invisible, + * right-line, left-line, protect, reverse and blink. 256 color pairs (8 * bits), 8 bits for other attributes, and 16 bits for character data. */ @@ -269,7 +269,7 @@ #define ATR_MSK A_ATTRIBUTES /* Obsolete */ #define ATR_NRM A_NORMAL /* Obsolete */ -/* For use with attr_t -- X/Open says, "these shall be distinct", so +/* For use with attr_t -- X/Open says, "these shall be distinct", so * this is a non-conforming implementation. */ @@ -293,7 +293,7 @@ /* Alternate character set macros * * 'w' = 32-bit chtype; acs_map[] index | A_ALTCHARSET - * 'n' = 16-bit chtype; it gets the fallback set because no bit is + * 'n' = 16-bit chtype; it gets the fallback set because no bit is * available for A_ALTCHARSET */ @@ -804,7 +804,7 @@ typedef struct _win /* definition of a window */ struct _win *_parent; /* subwin's pointer to parent win */ } WINDOW; -/* Avoid using the SCREEN struct directly -- use the corresponding +/* Avoid using the SCREEN struct directly -- use the corresponding * functions if possible. This struct may eventually be made private. */ @@ -831,12 +831,12 @@ typedef struct unsigned long _trap_mbe; /* trap these mouse button events */ unsigned long _map_mbe_to_key; /* map mouse buttons to slk */ int mouse_wait; /* time to wait (in ms) for a - * button release after a press, in + * button release after a press, in * order to count it as a click */ int slklines; /* lines in use by slk_init() */ WINDOW *slk_winptr; /* window for slk */ int linesrippedoff; /* lines ripped off via ripoffline() */ - int linesrippedoffontop; /* lines ripped off on + int linesrippedoffontop; /* lines ripped off on * top via ripoffline() */ int delaytenths; /* 1/10ths second to wait block * getch() for */ @@ -894,7 +894,7 @@ void bkgdset(chtype); int border(chtype, chtype, chtype, chtype, chtype, chtype, chtype, chtype); int box(WINDOW *, chtype, chtype); bool can_change_color(void); -int cbreak(void); +int cbreak(void); int chgat(int, attr_t, short, const void *); int clearok(WINDOW *, bool); int clear(void); @@ -909,7 +909,7 @@ int def_shell_mode(void); int delay_output(int); int delch(void); int deleteln(void); -void delscreen(SCREEN *); +void delscreen(SCREEN *); int delwin(WINDOW *); WINDOW *derwin(WINDOW *, int, int, int, int); int doupdate(void); @@ -1147,8 +1147,8 @@ int addwstr(const wchar_t *); int add_wch(const cchar_t *); int add_wchnstr(const cchar_t *, int); int add_wchstr(const cchar_t *); -int border_set(const cchar_t *, const cchar_t *, const cchar_t *, - const cchar_t *, const cchar_t *, const cchar_t *, +int border_set(const cchar_t *, const cchar_t *, const cchar_t *, + const cchar_t *, const cchar_t *, const cchar_t *, const cchar_t *, const cchar_t *); int box_set(WINDOW *, const cchar_t *, const cchar_t *); int echo_wchar(const cchar_t *); @@ -1218,7 +1218,7 @@ int wadd_wchstr(WINDOW *, const cchar_t *); int wbkgrnd(WINDOW *, const cchar_t *); void wbkgrndset(WINDOW *, const cchar_t *); int wborder_set(WINDOW *, const cchar_t *, const cchar_t *, - const cchar_t *, const cchar_t *, const cchar_t *, + const cchar_t *, const cchar_t *, const cchar_t *, const cchar_t *, const cchar_t *, const cchar_t *); int wecho_wchar(WINDOW *, const cchar_t *); int wgetbkgrnd(WINDOW *, cchar_t *);