Re: [PATCH 000/100] huge pile of man page changes

[Thomas Dickey]

On Sat, Mar 30, 2024 at 04:46:20PM -0500, G. Branden Robinson wrote:
> Hi folks,
> 
> This set really ran away from me.  I apologize for the high volume.
> 
> Thomas, I'll understand if some or even none (due to their lateness)
> can't make it into this weekend's patch.

I'm just starting to look at these now (last weekend I had no time,
and this week I've been catching up on bug-fixes).  I'll review/whatever
some, in the time remaining today.
 
> Here's the "git log --oneline --reverse".
> 
> 5642aef1d man/curs_getcchar.3x: Fix error.
> 80dae7561 man/tput.1: Fix error.
> 4481adc8f man/curs_add{ch,_wch}: Fix up wide/non-wide cross references.
> b74cf9a0b man/curs_pad.3x: Revise.
> 13014f3d4 man/*.3x: Parallelize narrow/wide man page cross references.
> 8c129eb7e man/curs_terminfo.3x: Drop duplicate paragraph.
> 03a1f3eed man/curs_terminfo.3x: Wordsmith constness discussion.
> 48cbae899 man/curs_termattrs.3x: Fix typo.
> dfac30d3f man/default_colors.3x: Help apropos locate this page.
> 9c5e3d84e man/curs_{addch,initscr}: Fix content nit.
> 9af09ae49 man/curs_getch.3x: Fix style nit.
> 514c70095 man/curs_kernel.3x: Fix style nits.
> 35e93af07 man/curs_{in,out}opts.3x: Relocate nl/nonl discussion.
> fa1fe7500 man/curs_inopts.3x: Recast discussion of nl/nonl history.
> 9713489ee man/*.3x: Revise ordering of function 4-tuples in synopses.
> 1b44b4e14 man/curs_addch.3x: Clarify line feed handling.
> 4bc9bc2ca man/curs_addch.3x: Drop material already present in a page 
> cross-referenced just prior.
> a95709208 man/curs_addch.3x: Fix content and style nits.
> cecb26099 man/curs_outopts.3x: Drop duplicative paragraph.
> 4dee2c9cb man/curs_variables.3x: Correct name of ncurses's optional, separate 
> terminal-handling library.
> 2f354d878 man/curs_variables.3x: Recast explanation of "ESCDELAY".
> 07e8e56a8 man/ncurses.3x: Revise précis of library features in "DESCRIPTION" 
> section.
> f5c17d0b6 man/ncurses.3x: Recast initial part of "DESCRIPTION" section.
> 267e469b2 man/ncurses.3x: Recast discussion of linker options in 
> "DESCRIPTION" section.
> c6511d1e1 man/ncurses.3x: Relocate material.
> 303657ee5 man/ncurses.3x: Recast "Initialization" subsection.
> 1c92a68c0 man/ncurses.3x: Recast "Effects of GUIs and Environment Variables" 
> subsection.
> 1e1d33534 man/ncurses.3x: Revise and rename "Initialization" subsection to 
> "Application Structure".
> 29441581a man/ncurses.3x: Revise and rename subsection "Effects of GUIs and 
> Environment Variables" to "Initialization".
> 6e1d1ecc8 man/ncurses.3x: Revise "Overview" subsection.
> aadd95efc man/ncurses.3x: Relocate material from "Overview" subsection to 
> "Naming Conventions" subsection.
> 6a5ee5422 man/ncurses.3x: Recast "Naming Conventions" section.
> 974f57dfd man/ncurses.3x: Tighten wording in "Wide and Non-wide Character 
> Configurations" subsection.
> d3e5e90f8 man/ncurses.3x: Document yet another API naming irregularity.
> 1bf422cda man/ncurses.3x: Record another exception to the wide-character API 
> renaming rule.
> b7905c961 man/ncurses.3x: Document curs_threads(3X) functions in "Function 
> Name Index" subsection.
> f78a0425a man/ncurses.3x: Relocate material from "Function Name Index" 
> subsection to "EXTENSIONS" section.
> 5a17f7b82 man/ncurses.3x: Add forward reference from "Function Name Index" 
> subsection to "EXTENSIONS" section.
> edf8b6d7e man/ncurses.3x: Add man page cross reference to "Function Name 
> Index".
> 7c3cb8310 man/ncurses.3x: Fix style and markup nits in "RETURN VALUE" section.
> 70c6d0b93 man/ncurses.3x: Drop redundant language in "RETURN VALUE" section.
> f612589ca man/ncurses.3x: Lexicographically sort subsections of "ENVIRONMENT" 
> section.
> 669861aac man/ncurses.3x: Relocate material in "ENVIRONMENT" section.
> 3e334dc35 man/ncurses.3x: Recast introduction to "ENVIRONMENT".
> 343e10d7d man/ncurses.3x: Recast "ENVIRONMENT" section, BAUDRATE (1/21).
> 1a12935cc man/ncurses.3x: Recast "ENVIRONMENT" section, CC (2/21).
> 288ba10c1 man/ncurses.3x: Revise "ENVIRONMENT" section, COLUMNS (3/21).
> 612c45aef man/ncurses.3x: Revise "ENVIRONMENT" section, ESCDELAY (4/21).
> 1f00ac864 man/ncurses.3x: Recast "ENVIRONMENT" section, HOME (5/21).
> d86e849e2 man/ncurses.3x: Recast "ENVIRONMENT" section, LINES (6/21).
> a3101c096 man/ncurses.3x: Recast "ENVIRONMENT" section, MOUSE_BUTTONS_123 
> (7/21).
> a7c82babd man/ncurses.3x: Revise "ENVIRONMENT" section, 
> NCURSES_ASSUMED_COLORS (8/21).
> c95916eb6 man/ncurses.3x: Recast "ENVIRONMENT" section, NCURSES_CONSOLE2 
> (9/21).
> cab4364ef man/ncurses.3x: Recast "ENVIRONMENT" section, NCURSES_GPM_TERMS 
> (10/21).
> 883675834 man/ncurses.3x: Recast "ENVIRONMENT" section, NCURSES_NO_HARD_TABS 
> (11/21).
> ac18a203f man/ncurses.3x: Revise "ENVIRONMENT" section, 
> NCURSES_NO_MAGIC_COOKIE (12/21).
> c368e63c3 man/ncurses.3x: Recast "ENVIRONMENT" section, NCURSES_NO_PADDING 
> (13/21).
> ca0742aaf man/ncurses.3x: Revise "ENVIRONMENT" section, NCURSES_NO_SETBUF 
> (14/21).
> de8a2f06a man/ncurses.3x: Recast "ENVIRONMENT" section, NCURSES_NO_UTF8_ACS 
> (15/21).
> 338e18c7b man/ncurses.3x: Revise "ENVIRONMENT" section, NCURSES_TRACE (16/21).
> 471d9f147 man/ncurses.3x: Recast "ENVIRONMENT" section, TERM (17/21).
> 447045e82 man/ncurses.3x: Recast "ENVIRONMENT" section, TERMCAP (18/21).
> 90de4d8c4 man/ncurses.3x: Recast "ENVIRONMENT" section, TERMINFO (19/21).
> e0e1e5703 man/ncurses.3x: Recast "ENVIRONMENT" section, TERMINFO_DIRS (20/21).
> 2e11b0843 man/ncurses.3x: Recast "ENVIRONMENT" section, TERMPATH (20/21).
> 33d9eb675 man/ncurses.3x: Set paragraph tags in bold in "ALTERNATE 
> CONFIGURATIONS" section.
> 165c06553 man/ncurses.3x: Fix content and style nits in "NOTES" section.
> fec7a1ec6 man/ncurses.3x: Promote mention of xterm to man page cross 
> reference.
> bc66014f6 man/ncurses.3x: Recast introduction of opaque API in "EXTENSIONS" 
> section.
> 196338a1f man/ncurses.3x: Recast bits of "EXTENSIONS" section.
> 87a47a460 man/ncurses.3x: Note keybound() and use_legacy_coding() as 
> extensions.
> cb63869a3 man/ncurses.3x: Speak clearer X/Open Curses standardese.
> 0471268ec man/ncurses.3x: Revise "Error Checking" subsection.
> 69ca98d07 man/ncurses.3x: Revise "Padding Differences" subsection.
> 928cbf398 man/ncurses.3x: Recast "Header Files" subsection and "AUTHORS" 
> section.
> 4dad9ab91 man/curs_insch.3x: Tweak wording.
> 1fe43e8db man/curs_insch.3x: Fix style nits.
> 9a28a8e11 man/curs_delch.3x: Revise.
> e06a1fcb3 man/curs_addch.3x: Fix content and style nits.
> 4f1e6896c man/*.3x: Fix markup nit.
> 157a22ba0 man/*.3x: Name metasyntactic variables more consistently (1/3).
> 5c39766bd man/*.3x: Name metasyntactic variables more consistently (2/3).
> b6fd0e0ca man/*.3x: Name metasyntactic variables more consistently (3/3).
> 7ecf615ef man/MKada_config.in: Make `EX` and `EE` man(7) macros usable on DWB.
> 71e7a4817 man/MKada_config.in: Work harder to get example to fit.
> 92deb9a37 man/tput.1: Recast presentation of string capability parameters.
> c12d33205 man/toe.1m: Tighten wording.
> 39a9aee62 man/curs_getch.3x: Fix content, style, and markup nits.
> 999df2964 man/curs_mouse.3x: Fix *roff code style nit.
> db5e92642 man/curs_mouse.3x: Relocate material.
> 747bbb6b8 man/*.3x: Fix content nit.
> d66d9a9f9 man/curs_move.3x: Recast and align with model language.
> 0b8691eae include/Caps*: Fix formatting error in capability table.
> 95b7ce81f man/tabs.1: Tweak wording.
> 45958aaa3 man/tset.1: Recast discussion of environment variable usage.
> 1b9221423 man/curs_termcap.3x: Recast to improve precision.
> 1ced96fe6 man/legacy_coding.3x: Recast.
> d384bb080 man/curs_trace.3x: Name metasyntactic variable more informatively.
> 777f0628f man/{ncurses.3x,terminfo.head}: Tweak version boilerplate.
> 4b85f6e6b man/*.3x: Apply consistent `mv*()` failure boilerplate.
> 
> Regards,
> Branden



-- 
Thomas E. Dickey <dickey@invisible-island.net>
https://invisible-island.net

signature.asc
Description: PGP signature