At 2025-10-26T00:43:19+0000, Thomas Dickey wrote:
>       + correct a recent change to curs_termino.3x, along with formatting
>         fixes for manpages.

This change regresses formatting on DWB 3.3, Plan 9, and Solaris 10
troffs, causing some synopsis lines to overset (overrun the right
margin).  That's because those formatters use a line length of 65n in
nroff mode, not 78-80n as Heirloom Doctools troff and groff (for their
man(7) packages), and mandoc(1) do.

Because filling is off, one doesn't get warnings from GNU troff about
this, even when the relevant warning category is enabled.  Dave Kemper
has opined that when people turn filling off, they're happy for lines to
silently overset.  I think this makes a good set of counterexamples.

We can easily see where the margin is by inspecting the header of
each man page; it coincides with the right end of (3NCURSES).

Those check Plan 9 or Solaris 10 troff output will observe different
page offsets,[1] but all use the same 65n line length.

--- ncurses-20251018.dwb        2025-10-25 20:30:56.697852303 -0500
+++ ncurses-20251025.dwb        2025-10-25 20:32:52.522134457 -0500
@@ -4034,7 +4034,7 @@
 
 
 
-       add_wch(3NCURSES)   ncurses 6.5 (2025-08-23)    add_wch(3NCURSES)
+       add_wch(3NCURSES)   ncurses 6.5 (2025-10-20)    add_wch(3NCURSES)
 
 
 
@@ -4049,8 +4049,7 @@
             int add_wch(const cchar_t * wch);
             int wadd_wch(WINDOW * win, const cchar_t * wch);
             int mvadd_wch(int y, int x, const cchar_t * wch);
-            int mvwadd_wch(WINDOW * win, int y, int x,
-                  const cchar_t * wch);
+            int mvwadd_wch(WINDOW * win, int y, int x, const cchar_t * wch);
[...]
@@ -4729,7 +4730,7 @@



-       add_wchstr(3NCURSES)ncurses 6.5 (2025-08-16) add_wchstr(3NCURSES)
+       add_wchstr(3NCURSES)ncurses 6.5 (2025-10-20) add_wchstr(3NCURSES)



@@ -4744,14 +4745,11 @@
             int add_wchstr(const cchar_t * wchstr);
             int wadd_wchstr(WINDOW *  win, const cchar_t * wchstr);
             int mvadd_wchstr(int y, int x, const cchar_t * wchstr);
-            int mvwadd_wchstr(WINDOW * win, int y, int x,
-                  const cchar_t * wchstr);
+            int mvwadd_wchstr(WINDOW * win, int y, int x, const cchar_t * 
wchstr);

             int add_wchnstr(const cchar_t * wchstr, int n);
-            int wadd_wchnstr(WINDOW *  win, const cchar_t * wchstr,
-                  int n);
-            int mvadd_wchnstr(int y, int x, const cchar_t * wchstr,
-                  int n);
+            int wadd_wchnstr(WINDOW *  win, const cchar_t * wchstr, int n);
+            int mvadd_wchnstr(int y, int x, const cchar_t * wchstr, int n);
             int mvwadd_wchnstr(WINDOW * win, int y, int x,
                   const cchar_t * wchstr, int n);
[...]
@@ -5521,7 +5522,7 @@



-       addstr(3NCURSES)    ncurses 6.5 (2025-03-15)     addstr(3NCURSES)
+       addstr(3NCURSES)    ncurses 6.5 (2025-10-20)     addstr(3NCURSES)



@@ -5541,8 +5542,7 @@
             int addnstr(const char * str, int n);
             int waddnstr(WINDOW * win, const char * str, int n);
             int mvaddnstr(int y, int x, const char * str, int n);
-            int mvwaddnstr(WINDOW * win, int y, int x, const char * str,
-                  int n);
+            int mvwaddnstr(WINDOW * win, int y, int x, const char * str, int 
n);

        DESCRIPTION
             waddstr writes the characters of the (null-terminated)
[...]
@@ -12123,7 +12124,7 @@



-       get_wstr(3NCURSES)  ncurses 6.5 (2025-07-05)   get_wstr(3NCURSES)
+       get_wstr(3NCURSES)  ncurses 6.5 (2025-10-20)   get_wstr(3NCURSES)



@@ -12143,8 +12144,7 @@
             int getn_wstr(wint_t * wstr, int n);
             int wgetn_wstr(WINDOW * win, wint_t * wstr, int n);
             int mvgetn_wstr(int y, int x, wint_t * wstr, int n);
-            int mvwgetn_wstr(WINDOW * win, int y, int x, wint_t * wstr,
-                  int n);
+            int mvwgetn_wstr(WINDOW * win, int y, int x, wint_t * wstr, int n);

        DESCRIPTION
             wget_wstr populates a user-supplied wide-character string
[...]
@@ -13265,7 +13266,7 @@



-       getstr(3NCURSES)    ncurses 6.5 (2025-07-05)     getstr(3NCURSES)
+       getstr(3NCURSES)    ncurses 6.5 (2025-10-20)     getstr(3NCURSES)



@@ -13285,8 +13286,7 @@
             int getnstr(char * str, int n);
             int wgetnstr(WINDOW * win, char * str, int n);
             int mvgetnstr(int y, int x, char * str, int n);
-            int mvwgetnstr(WINDOW * win, int y, int x, char * str,
-                  int n);
+            int mvwgetnstr(WINDOW * win, int y, int x, char * str, int n);

        DESCRIPTION
             wgetstr populates a user-supplied string buffer str by
[...]
@@ -14123,7 +14124,7 @@



-       in_wchstr(3NCURSES) ncurses 6.5 (2025-08-23)  in_wchstr(3NCURSES)
+       in_wchstr(3NCURSES) ncurses 6.5 (2025-10-20)  in_wchstr(3NCURSES)



@@ -14138,14 +14139,12 @@
             int in_wchstr(cchar_t * wchstr);
             int win_wchstr(WINDOW * win, cchar_t * wchstr);
             int mvin_wchstr(int y, int x, cchar_t * wchstr);
-            int mvwin_wchstr(WINDOW * win, int y, int x,
-                cchar_t * wchstr);
+            int mvwin_wchstr(WINDOW * win, int y, int x, cchar_t * wchstr);

             int in_wchnstr(cchar_t * wchstr, int n);
             int win_wchnstr(WINDOW * win, cchar_t * wchstr, int n);
             int mvin_wchnstr(int y, int x, cchar_t * wchstr, int n);
-            int mvwin_wchnstr(WINDOW * win, int y, int x,
-                cchar_t * wchstr, int n)
+            int mvwin_wchnstr(WINDOW * win, int y, int x, cchar_t * wchstr, 
int n)

        DESCRIPTION
             win_wchstr extracts a curses complex character string from a
[...]
@@ -14387,7 +14388,7 @@



-       inchstr(3NCURSES)   ncurses 6.5 (2025-08-16)    inchstr(3NCURSES)
+       inchstr(3NCURSES)   ncurses 6.5 (2025-10-20)    inchstr(3NCURSES)



@@ -14407,8 +14408,7 @@
             int mvinchstr(int y, int x, chtype * chstr);
             int mvinchnstr(int y, int x, chtype * chstr, int n);
             int mvwinchstr(WINDOW * win, int y, int x, chtype * chstr);
-            int mvwinchnstr(WINDOW * win, int y, int x, chtype * chstr,
-                int n);
+            int mvwinchnstr(WINDOW * win, int y, int x, chtype * chstr, int n);

        DESCRIPTION
             winchstr extracts a curses character string from a curses
[...]
@@ -15509,7 +15510,7 @@



-       ins_wch(3NCURSES)   ncurses 6.5 (2025-03-08)    ins_wch(3NCURSES)
+       ins_wch(3NCURSES)   ncurses 6.5 (2025-10-20)    ins_wch(3NCURSES)



@@ -15523,8 +15524,7 @@
             int ins_wch(const cchar_t * wch);
             int wins_wch(WINDOW * win, const cchar_t * wch);
             int mvins_wch(int y, int x, const cchar_t * wch);
-            int mvwins_wch(WINDOW * win, int y, int x,
-                  const cchar_t * wch);
+            int mvwins_wch(WINDOW * win, int y, int x, const cchar_t * wch);

        DESCRIPTION
             wins_wch inserts the curses complex character wch at the
[...]
@@ -15905,7 +15906,7 @@



-       insstr(3NCURSES)    ncurses 6.5 (2025-02-01)     insstr(3NCURSES)
+       insstr(3NCURSES)    ncurses 6.5 (2025-10-20)     insstr(3NCURSES)



@@ -15924,8 +15925,7 @@
             int insnstr(const char * str, int n);
             int winsnstr(WINDOW * win, const char * str, int n);
             int mvinsnstr(int y, int x, const char * str, int n);
-            int mvwinsnstr(WINDOW * win, int y, int x, const char * str,
-                  int n);
+            int mvwinsnstr(WINDOW * win, int y, int x, const char * str, int 
n);

        DESCRIPTION
             winsstr inserts a string str before the character at the
[...]
@@ -16037,7 +16038,7 @@



-       instr(3NCURSES)     ncurses 6.5 (2025-08-16)      instr(3NCURSES)
+       instr(3NCURSES)     ncurses 6.5 (2025-10-20)      instr(3NCURSES)



@@ -16056,8 +16057,7 @@
             int innstr(char * str, int n);
             int winnstr(WINDOW * win, char * str, int n);
             int mvinnstr(int y, int x, char * str, int n);
-            int mvwinnstr(WINDOW * win, int y, int x, char * str,
-                  int n);
+            int mvwinnstr(WINDOW * win, int y, int x, char * str, int n);

        DESCRIPTION
             winstr extracts a string from a curses window win, starting
[...]
@@ -16169,7 +16170,7 @@



-       inwstr(3NCURSES)    ncurses 6.5 (2025-08-16)     inwstr(3NCURSES)
+       inwstr(3NCURSES)    ncurses 6.5 (2025-10-20)     inwstr(3NCURSES)



@@ -16189,8 +16190,7 @@
             int innwstr(wchar_t * wstr, int n);
             int winnwstr(WINDOW * win, wchar_t * wstr, int n);
             int mvinnwstr(int y, int x, wchar_t * wstr, int n);
-            int mvwinnwstr(WINDOW * win, int y, int x, wchar_t * wstr,
-                  int n);
+            int mvwinnwstr(WINDOW * win, int y, int x, wchar_t * wstr, int n);

        DESCRIPTION
             winwstr extracts a wide-character string from a curses win-
[...]
+            #include <ncursestw/curses.h>
             #include <ncursestw/term.h>

             TERMINAL * cur_term;
@@ -26042,8 +26044,7 @@
             int setupterm(const char * term, int filedes, int * errret);
             TERMINAL * set_curterm(TERMINAL * nterm);
             int del_curterm(TERMINAL * oterm);
-            int restartterm(const char * term, int filedes,
-                  int * errret);
+            int restartterm(const char * term, int filedes, int * errret);

             char * tparm(const char * str, ...);
                  /* or */
@@ -26054,8 +26055,7 @@

             int vidputs(chtype attrs, int (* putc)(int));
             int vidattr(chtype attrs);
-            int vid_puts(attr_t attrs, short pair, void * opts,
-                  int (* putc)(int));
+            int vid_puts(attr_t attrs, short pair, void * opts, int (* 
putc)(int));
             int vid_attr(attr_t attrs, short pair, void * opts);

             int tigetflag(const char * cap-code);
@@ -26065,26 +26065,25 @@
             char * tiparm(const char * str, ...);

             /* extensions */
-            char * tiparm_s(int expected, int mask,
-                  const char * str, ...);
+            char * tiparm_s(int expected, int mask, const char * str, ...);
             int tiscan_s(int * expected, int * mask, const char * str);

             /* deprecated */

Regards,
Branden

[1] DWB 3.3 uses a page offset of 7n; Plan 9, 5n; and Solaris 10, zero.

Attachment: signature.asc
Description: PGP signature

Reply via email to