[PATCH 031/100] man/ncurses.3x: Relocate material from "Overview" subsection to "Naming Conventions" subsection.

[G. Branden Robinson]

Postpone getting down into the weeds of curses's Byzantine function
nomenclature; the latter section is much close to the function name
index where this preparation can be better appreciated.
---
 man/ncurses.3x | 61 +++++++++++++++++++++++++-------------------------
 1 file changed, 31 insertions(+), 30 deletions(-)

diff --git a/man/ncurses.3x b/man/ncurses.3x
index a84d92c9e..b955f2119 100644
--- a/man/ncurses.3x
+++ b/man/ncurses.3x
@@ -259,36 +259,6 @@ .SS Overview
 these place the cursor and write a character to
 .BR \%stdscr ,
 respectively.
-As a rule,
-window-addressing functions feature names prefixed
-(or infixed,
-see below)
-with \*(``w\*('';
-these allow the user to specify a pointer to a
-.IR \%WINDOW .
-Counterparts not thus prefixed
-(or infixed)
-affect \fB\%stdscr\fP.
-Because moving the cursor prior to another operation is so common,
-.I curses
-generally also provides functions with a \*(``mv\*('' prefix as a
-convenience.
-Thus,
-the library defines all of
-\fB\%addch\fP,
-\fB\%waddch\fP,
-\fB\%mvaddch\fP,
-and
-\fB\%mvwaddch\fP.
-When both prefixes are present,
-the order of arguments is a
-.I \%WINDOW
-pointer first,
-then a
-.I y
-and
-.I x
-coordinate pair.
 .PP
 Frequent changes to the terminal screen can cause unpleasant flicker or
 inefficient use of the communication channel to the device,
@@ -418,6 +388,37 @@ .SS "Naming Conventions"
 Four functions prefixed with \*(``p\*('' require a pad argument.
 Those without a prefix generally operate on \fB\%stdscr\fP.
 .PP
+As a rule,
+window-addressing functions feature names prefixed
+(or infixed,
+see below)
+with \*(``w\*('';
+these allow the user to specify a pointer to a
+.IR \%WINDOW .
+Counterparts not thus prefixed
+(or infixed)
+affect \fB\%stdscr\fP.
+Because moving the cursor prior to another operation is so common,
+.I curses
+generally also provides functions with a \*(``mv\*('' prefix as a
+convenience.
+Thus,
+the library defines all of
+\fB\%addch\fP,
+\fB\%waddch\fP,
+\fB\%mvaddch\fP,
+and
+\fB\%mvwaddch\fP.
+When both prefixes are present,
+the order of arguments is a
+.I \%WINDOW
+pointer first,
+then a
+.I y
+and
+.I x
+coordinate pair.
+.PP
 In function synopses,
 .I \%ncurses
 man pages apply the following names to parameters.
-- 
2.30.2

signature.asc
Description: PGP signature