Skip to content

Commit

Permalink
Brought history and manual up to date, and updated the version date c…
Browse files Browse the repository at this point in the history
…onstant.
  • Loading branch information
Bill-Gray committed Jul 28, 2023
1 parent a201843 commit 3fabd2f
Show file tree
Hide file tree
Showing 3 changed files with 41 additions and 16 deletions.
2 changes: 1 addition & 1 deletion curses.h
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Defined by this header:
#define PDC_VER_CHANGE 0
#define PDC_VER_YEAR 2023
#define PDC_VER_MONTH 07
#define PDC_VER_DAY 23
#define PDC_VER_DAY 27

#define PDC_STRINGIZE( x) #x
#define PDC_stringize( x) PDC_STRINGIZE( x)
Expand Down
27 changes: 26 additions & 1 deletion docs/HISTORY.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,25 @@
PDCursesMod -- 2023 July 2310
PDCursesMod -- 2023 July 27
===========================

This is the (thus far experimental) 4.4 branch.

Major new features
------------------

- The SCREEN and WINDOW structures are now opaque. 11671880e2
3259719b37

- The WA_ flags are now distinct, in builds with 64-bit chtypes and
attr_ts (the default). This led to considerable documentation
changes and an attempt to make the distinction between WA_ macros
(for use with wattr_t) and A_ macros (for use with chtype) clearer.
Most implementations of curses have wattr_t == chtype, including
PDCurses* and ncurses, but you can't really rely on it.
78658c94cd

- KEY_MAX was increased to reserve some key codes for future use.
16ac494c25

Minor new features
------------------

Expand All @@ -20,6 +39,9 @@ Minor new features
This avoids buffer overruns and problems with mishandled characters.
cb8c87b287

- 'testcurs' attribute test now lists which flags in term_attrs() are
set. 4da423c59e

Bug fixes
---------

Expand All @@ -42,6 +64,9 @@ Bug fixes
- touchoverlap() un-touched some parts of the window that didn't
overlap. 5c0bc334f8

- Line attributes were not reliably updated after PDC_set_line_color().
3b54290f13

PDCursesMod 4.3.7 - 2023 June 17
================================

Expand Down
28 changes: 14 additions & 14 deletions docs/MANUAL.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,14 +38,14 @@ There are three configurations supported :

Default, 64-bit chtype, both wide- and 8-bit character builds:
-------------------------------------------------------------------------------
|63|62|..|53|52|..|34|33|32|31|30|29|28|..|22|21|20|19|18|17|16|..| 3| 2| 1| 0|
|63|62|..|45|44|43|..|38|37|36|35|34|33|..|22|21|20|19|18|17|16|..| 3| 2| 1| 0|
-------------------------------------------------------------------------------
unused |color pair | modifiers | character eg 'a'
| color pair | unused | modifiers | character eg 'a'

21 character bits (0-20), enough for full Unicode coverage
12 attribute bits (21-32)
20 color pair bits (33-52), enough for 1048576 color pairs
11 currently unused bits (53-63)
17 attribute bits (21-37)
6 currently unused bits (38-43)
20 color pair bits (44-63), enough for 1048576 color pairs

32-bit chtypes with wide characters (CHTYPE_32 and PDC_WIDE are #defined):
+--------------------------------------------------------------------+
Expand All @@ -67,9 +67,9 @@ Default, 64-bit chtype, both wide- and 8-bit character builds:

All attribute modifier schemes include eight "basic" bits: bold, underline,
right-line, left-line, italic, reverse and blink attributes, plus the
alternate character set indicator. For default and 32-bit narrow builds,
three more bits are used for overlined, dimmed, and strikeout attributes;
a fourth bit is reserved.
alternate character set indicator. For 32-bit narrow builds, three more
bits are used for overlined, dimmed, and strikeout attributes; a fourth
bit is reserved.

Default chtypes have enough character bits to support the full range of
Unicode, all attributes, and 2^20 = 1048576 color pairs. Note, though,
Expand Down Expand Up @@ -798,9 +798,9 @@ color
foreground is white.

PDC_set_line_color() is used to set the color, globally, for the
color of the lines drawn for the attributes: A_UNDERLINE, A_LEFT and
A_RIGHT. A value of -1 (the default) indicates that the current
foreground color should be used.
color of the lines drawn for the attributes: A_UNDERLINE, A_LEFT,
A_RIGHT, A_STRIKEOUT, and A_TOP. A value of -1 (the default) indicates
that the current foreground color should be used.

NOTE: COLOR_PAIR() and PAIR_NUMBER() are implemented as macros.

Expand Down Expand Up @@ -2310,7 +2310,7 @@ panel
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.
del_panel() deletes pan, but not its associated window.

hide_panel() removes a panel from the deck and thus hides it from
view.
Expand Down Expand Up @@ -2742,8 +2742,8 @@ termattr
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 some
other implementations of curses.
has_ic and has_il() return TRUE, indicating that the terminal has the
capability to insert and delete characters and lines, respectively.

erasechar() and killchar() return ^H and ^U, respectively -- the
ERASE and KILL characters. In other curses implementations, these may
Expand Down

0 comments on commit 3fabd2f

Please sign in to comment.