bug-ncurses
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH 16/52] Revise man page subsection titles.


From: G. Branden Robinson
Subject: [PATCH 16/52] Revise man page subsection titles.
Date: Fri, 22 Dec 2023 17:03:18 -0600

+ Quote multi-word macro arguments to future-proof them with respect to
  macro packages descended from McIlroy man(7) (1979), which supported
  at most six arguments to macro calls.
+ Use titlecase, not full caps nor sentence case.
+ Drop unnecessary hyphens.
+ Replace hyphens with em dashes (man/tset.1).
+ Italicize names of commands, libraries, functions, and data types.

* man/captoinfo.1m:
* man/curs_add_wch.3x:
* man/curs_addch.3x:
* man/curs_attr.3x:
* man/curs_getch.3x:
* man/curs_mouse.3x:
* man/curs_sp_funcs.3x:
* man/curs_trace.3x:
* man/form.3x:
* man/form_driver.3x:
* man/infocmp.1m:
* man/menu.3x:
* man/menu_driver.3x:
* man/ncurses.3x:
* man/scr_dump.5:
* man/tabs.1:
* man/term.5:
* man/term_variables.3x:
* man/terminfo.head:
* man/tic.1m:
* man/tput.1:
* man/tset.1:
* man/user_caps.5: Do it.
---
 man/captoinfo.1m      |  2 +-
 man/curs_add_wch.3x   |  6 +++---
 man/curs_addch.3x     | 10 +++++-----
 man/curs_attr.3x      |  8 ++++----
 man/curs_getch.3x     | 10 +++++-----
 man/curs_mouse.3x     |  2 +-
 man/curs_sp_funcs.3x  |  4 ++--
 man/curs_trace.3x     |  4 ++--
 man/form.3x           |  4 ++--
 man/form_driver.3x    |  8 ++++----
 man/infocmp.1m        | 12 ++++++------
 man/menu.3x           |  4 ++--
 man/menu_driver.3x    |  4 ++--
 man/ncurses.3x        |  8 ++++----
 man/scr_dump.5        |  6 +++---
 man/tabs.1            |  8 ++++----
 man/term.5            | 16 ++++++++--------
 man/term_variables.3x | 10 +++++-----
 man/terminfo.head     |  8 ++++----
 man/tic.1m            |  6 +++---
 man/tput.1            |  2 +-
 man/tset.1            |  4 ++--
 man/user_caps.5       |  4 ++--
 23 files changed, 75 insertions(+), 75 deletions(-)

diff --git a/man/captoinfo.1m b/man/captoinfo.1m
index 43a0bd6de..da29eabe7 100644
--- a/man/captoinfo.1m
+++ b/man/captoinfo.1m
@@ -82,7 +82,7 @@ .SH DESCRIPTION
 .BR \-x .
 The \fB\-V\fP option reports the version of \fI\%ncurses\fP associated
 with this program and exits with a successful status.
-.SS "Translations from nonstandard capabilities"
+.SS "Translations from Nonstandard Capabilities"
 \fB\%@CAPTOINFO@\fP translates some obsolete,
 nonstandard capabilities into standard
 (SVr4/XSI Curses)
diff --git a/man/curs_add_wch.3x b/man/curs_add_wch.3x
index 227acc252..445df68b2 100644
--- a/man/curs_add_wch.3x
+++ b/man/curs_add_wch.3x
@@ -117,7 +117,7 @@ .SS echo_wchar
 that only a single character is being output is taken into consideration and,
 for non-control characters, a considerable performance gain might be seen
 by using the *\fBecho\fP* functions instead of their equivalents.
-.SS Line Graphics
+.SS "Line Graphics"
 Like \fB\%addch\fP(3X),
 \fBaddch_wch\fP accepts symbols which make it simple to draw lines and other
 frequently used special characters.
@@ -255,7 +255,7 @@ .SH NOTES
 .SH PORTABILITY
 These functions are described in the XSI Curses standard, Issue 4.
 The defaults specified for line-drawing characters apply in the POSIX locale.
-.SS WACS Symbols
+.SS "WACS Symbols"
 X/Open Curses makes it clear that the WACS_ symbols should be defined as
 a pointer to \fBcchar_t\fP data, e.g., in the discussion of \fBborder_set\fP.
 A few implementations are problematic:
@@ -333,7 +333,7 @@ .SS WACS Symbols
 \[u2327] U+2327 (x in a rectangle),
 \[u256C] U+256C (forms double vertical and horizontal), and
 \[u2612] U+2612 (ballot box with x).
-.SS Complex Characters
+.SS "Complex Characters"
 The complex character type \fBcchar_t\fR
 can store more than one wide character (\fBwchar_t\fR).
 The X/Open Curses description does not mention this possibility,
diff --git a/man/curs_addch.3x b/man/curs_addch.3x
index e61aee2f3..34cc21c53 100644
--- a/man/curs_addch.3x
+++ b/man/curs_addch.3x
@@ -66,7 +66,7 @@ .SH SYNOPSIS
 \fBint wechochar(WINDOW *\fIwin\fP, const chtype \fIch\fP);
 .fi
 .SH DESCRIPTION
-.SS Adding characters
+.SS "Adding Characters"
 The \fBaddch\fP, \fBwaddch\fP, \fBmvaddch\fP and \fBmvwaddch\fP routines put
 the character \fIch\fP into the given window at its current window position,
 which is then advanced.
@@ -122,7 +122,7 @@ .SS Adding characters
 using \fB\%inch\fP(3X) and \fBaddch\fP.)
 See the \fB\%curs_attr\fP(3X) page for values of predefined video
 attribute constants that can be usefully OR'ed into characters.
-.SS Echoing characters
+.SS "Echoing Characters"
 The \fBechochar\fP and \fBwechochar\fP routines are equivalent to a call to
 \fBaddch\fP followed by a call to \fB\%refresh\fP(3X), or a call to 
\fBwaddch\fP
 followed by a call to \fBwrefresh\fP.
@@ -130,7 +130,7 @@ .SS Echoing characters
 character is being output is used and, for non-control characters, a
 considerable performance gain may be seen by using these routines instead of
 their equivalents.
-.SS Line Graphics
+.SS "Line Graphics"
 The following variables may be used to add line drawing characters to the
 screen with routines of the \fBaddch\fP family.
 The default character listed
@@ -209,7 +209,7 @@ .SH NOTES
 .SH PORTABILITY
 These functions are described in the XSI Curses standard, Issue 4.
 The defaults specified for forms-drawing characters apply in the POSIX locale.
-.SS ACS Symbols
+.SS "ACS Symbols"
 X/Open Curses states that the \fBACS_\fP definitions are \fBchar\fP constants.
 For the wide-character implementation (see \fBcurs_add_wch\fP),
 there are analogous \fBWACS_\fP definitions which are \fBcchar_t\fP constants.
@@ -269,7 +269,7 @@ .SS ACS Symbols
 except by using UTF-8
 (see the discussion of \fB\%NCURSES_NO_UTF8_ACS\fP in
 \fB\%ncurses\fP(3X)).
-.SS Character Set
+.SS "Character Set"
 X/Open Curses assumes that the parameter passed to \fBwaddch\fP contains
 a single character.
 As discussed in \fB\%curs_attr\fP(3X), that character may have been
diff --git a/man/curs_attr.3x b/man/curs_attr.3x
index 475d3ab48..b8f950c81 100644
--- a/man/curs_attr.3x
+++ b/man/curs_attr.3x
@@ -127,7 +127,7 @@ .SH DESCRIPTION
 See \fBcurs_bkgd\fP(3X) for functions which modify the attributes used for
 erasing and clearing.
 .\" ---------------------------------------------------------------------------
-.SS Window attributes
+.SS "Window Attributes"
 There are two sets of functions:
 .bP
 functions for manipulating the window attributes and color:
@@ -148,7 +148,7 @@ .SS Window attributes
 again values OR'd together in \fIattr\fP,
 without affecting other attributes.
 .\" ---------------------------------------------------------------------------
-.SS Legacy window attributes
+.SS "Legacy Window Attributes"
 The X/Open window attribute routines which \fIset\fP or \fIget\fP,
 turn \fIon\fP or \fIoff\fP
 are extensions of older routines
@@ -206,7 +206,7 @@ .SS Legacy window attributes
 although \fI\%ncurses\fP provides \fB\%getattrs\fP
 (see \fB\%curs_legacy\fP(3X)).
 .\" ---------------------------------------------------------------------------
-.SS Change character rendition
+.SS "Change Character Rendition"
 The routine \fBchgat\fP changes the attributes of a given number of characters
 starting at the current cursor location of \fBstdscr\fP.
 It does not update
@@ -221,7 +221,7 @@ .SS Change character rendition
 the color \fIpair\fP argument is a color pair index
 (as in the first argument of \fBinit_pair\fP, see \fBcurs_color\fP(3X)).
 .\" ---------------------------------------------------------------------------
-.SS Change window color
+.SS "Change Window Color"
 The routine \fBcolor_set\fP sets the current color of the given window to the
 foreground/background combination described by the color \fIpair\fP parameter.
 .\" ---------------------------------------------------------------------------
diff --git a/man/curs_getch.3x b/man/curs_getch.3x
index 690672971..09a8b3545 100644
--- a/man/curs_getch.3x
+++ b/man/curs_getch.3x
@@ -68,7 +68,7 @@ .SH SYNOPSIS
 .B int has_key(int \fIch\fP);
 .fi
 .SH DESCRIPTION
-.SS Reading characters
+.SS "Reading Characters"
 The \fBgetch\fP, \fBwgetch\fP, \fBmvgetch\fP and \fBmvwgetch\fP, routines read
 a character from the window.
 In no-delay mode, if no input is waiting, the value \fBERR\fP is returned.
@@ -101,7 +101,7 @@ .SS Reading characters
 If the window is not a pad, and it has been moved or modified since the last
 call to \fBwrefresh\fP, \fBwrefresh\fP will be called before another character
 is read.
-.SS Keypad mode
+.SS "Keypad Mode"
 If \fBkeypad\fP is \fBTRUE\fP, and a function key is pressed, the token for
 that function key is returned instead of the raw characters:
 .bP
@@ -135,11 +135,11 @@ .SS Keypad mode
 Because function keys usually begin with an escape character,
 the terminal may appear to hang in notimeout mode after pressing the escape key
 until another key is pressed.
-.SS Ungetting characters
+.SS "Ungetting Characters"
 The \fBungetch\fP routine places \fIch\fP back onto the input queue to be
 returned by the next call to \fBwgetch\fP.
 There is just one input queue for all windows.
-.SS Predefined key-codes
+.SS "Predefined Key Codes"
 The following special keys are defined in \fB<curses.h>\fP.
 .bP
 Except for the special case \fBKEY_RESIZE\fP,
@@ -284,7 +284,7 @@ .SS Predefined key-codes
 with \fBxterm\fP(1) mouse prototocol)
 \fI\%ncurses\fP must read escape sequences,
 just like a function key.
-.SS Testing key-codes
+.SS "Testing Key Codes"
 The \fBhas_key\fP routine takes a key-code value from the above list, and
 returns \fBTRUE\fP or \fBFALSE\fP according to whether
 the current terminal type recognizes a key with that value.
diff --git a/man/curs_mouse.3x b/man/curs_mouse.3x
index 64c8e0f53..91da8ce56 100644
--- a/man/curs_mouse.3x
+++ b/man/curs_mouse.3x
@@ -106,7 +106,7 @@ .SS mousemask
 As a side effect, setting a zero mousemask may turn off the mouse pointer;
 setting a nonzero mask may turn it on.
 Whether this happens is device-dependent.
-.SS Mouse events
+.SS "Mouse Events"
 Here are the mouse event type masks which may be defined:
 .PP
 .TS
diff --git a/man/curs_sp_funcs.3x b/man/curs_sp_funcs.3x
index 730ce37c6..aaf33d63c 100644
--- a/man/curs_sp_funcs.3x
+++ b/man/curs_sp_funcs.3x
@@ -218,7 +218,7 @@ .SH DESCRIPTION
 it adds new entrypoints
 without changing the meaning of any of the existing ones.
 .\" ***************************************************************************
-.SS IMPROVED FUNCTIONS
+.SS "Improved Functions"
 Most of the functions are new versions of existing functions.
 A parameter is added at the front of the parameter list.
 It is a SCREEN pointer.
@@ -229,7 +229,7 @@ .SS IMPROVED FUNCTIONS
 thereby reducing the number of variables which must be modified
 to update multiple screens.
 .\" ***************************************************************************
-.SS NEW FUNCTIONS
+.SS "New Functions"
 Here are the new functions:
 .TP 5
 ceiling_panel
diff --git a/man/curs_trace.3x b/man/curs_trace.3x
index 09e787780..dcbeebe14 100644
--- a/man/curs_trace.3x
+++ b/man/curs_trace.3x
@@ -127,7 +127,7 @@ .SS Functions
 If the file already exists, no tracing is done.
 .bP
 If tracing is not available, \fBcurses_trace\fP returns zero (0).
-.SS Trace Parameter
+.SS "Trace Parameter"
 The trace parameter is formed by OR'ing
 values from the list of \fBTRACE_\fIxxx\fR definitions in \fB<curses.h>\fR.
 These include:
@@ -211,7 +211,7 @@ .SS Initialization
 use_extended_names,
 use_tioctl
 .RE
-.SS Command-line Utilities
+.SS "Command-line Utilities"
 The command-line utilities such as \fBtic\fP(1) provide a verbose option
 which extends the set of messages written using the \fBcurses_trace\fP 
function.
 Both of these (\fB\-v\fP and \fBcurses_trace\fP)
diff --git a/man/form.3x b/man/form.3x
index 511952933..f8cebfbf9 100644
--- a/man/form.3x
+++ b/man/form.3x
@@ -73,7 +73,7 @@ .SH DESCRIPTION
 A curses initialization routine such as \fBinitscr\fP must be called
 before using any of these functions.
 .
-.SS Current Default Values for Field Attributes
+.SS "Current Default Values for Field Attributes"
 .
 The \fBform\fP library maintains a default value for field attributes.
 You
@@ -84,7 +84,7 @@ .SS Current Default Values for Field Attributes
 \fBset_\fP function affects future field creations, but does not change the
 rendering of fields already created.
 .
-.SS Routine Name Index
+.SS "Routine Name Index"
 .
 The following table lists each \fBform\fP routine and the name of
 the manual page on which it is described.
diff --git a/man/form_driver.3x b/man/form_driver.3x
index d8434a818..c52f26e23 100644
--- a/man/form_driver.3x
+++ b/man/form_driver.3x
@@ -67,7 +67,7 @@ .SS form_driver_w
 The type must be passed as well,
 to enable the library to determine whether the parameter
 is a wide character or a request.
-.SS Form-driver requests
+.SS "Form Driver Requests"
 The form driver requests are as follows:
 .PP
 .TS
@@ -139,7 +139,7 @@ .SS Form-driver requests
 in the current position in the current field.
 If it is one of the forms
 requests listed above, that request is executed.
-.SS Field validation
+.SS "Field Validation"
 The form library makes updates to the window associated
 with form fields rather than directly to the field buffers.
 .PP
@@ -166,7 +166,7 @@ .SS Field validation
 If the modified field is valid, the form driver copies the modified
 data from the window associated with the field
 to the field buffer.
-.SS Mouse handling
+.SS "Mouse Handling"
 If the second argument is the KEY_MOUSE special key, the associated
 mouse event is translated into one of the above pre-defined requests.
 Currently only clicks in the user window (e.g., inside the form display
@@ -213,7 +213,7 @@ .SS Mouse handling
 If you clicked outside the user window
 or the mouse event could not be translated
 into a form request an \fBE_REQUEST_DENIED\fP is returned.
-.SS Application-defined commands
+.SS "Application-defined Commands"
 If the second argument is neither printable nor one of the above
 pre-defined form requests, the driver assumes it is an application-specific
 command and returns \fBE_UNKNOWN_COMMAND\fP.  Application-defined commands
diff --git a/man/infocmp.1m b/man/infocmp.1m
index ffe2df3bc..61271171e 100644
--- a/man/infocmp.1m
+++ b/man/infocmp.1m
@@ -90,14 +90,14 @@ .SH DESCRIPTION
 In all cases, the boolean
 fields will be printed first, followed by the numeric fields, followed by the
 string fields.
-.SS Default Options
+.SS "Default Options"
 If no options are specified and zero or one \fIterminal-types\fP are
 specified,
 the
 \fB\-I\fP option will be assumed.
 If more than one \fIterminal-type\fP is specified,
 the \fB\-d\fP option will be assumed.
-.SS Comparison Options [\-d] [\-c] [\-n]
+.SS "Comparison Options [\-d] [\-c] [\-n]"
 \fB@INFOCMP@\fP compares the \fBterminfo\fP description of the first terminal
 \fIterminal-type\fP with each of the descriptions given by the entries
 for the other terminal's \fIterminal-types\fP.
@@ -142,7 +142,7 @@ .SS Comparison Options [\-d] [\-c] [\-n]
 If no \fIterminal-types\fP are given,
 \fB@INFOCMP@\fP uses the environment variable \fITERM\fP
 for each of the \fIterminal-types\fP.
-.SS Source Listing Options [\-I] [\-L] [\-C] [\-r]
+.SS "Source Listing Options [\-I] [\-L] [\-C] [\-r]"
 The \fB\-I\fP, \fB\-L\fP, and \fB\-C\fP options will produce
 a source listing for each terminal named.
 .PP
@@ -222,7 +222,7 @@ .SS Source Listing Options [\-I] [\-L] [\-C] [\-r]
 \fB%p1%?%'x'%>%t%p1%'y'%+%;/%>xy\fP/concept
 \fB%p2\fP is printed before \fB%p1/%r\fP/hp
 .TE
-.SS Use= Option [\-u]
+.SS "Use= Option [\-u]"
 The \fB\-u\fP option produces a \fBterminfo\fP source description of the first
 terminal \fIterminal-type\fP which is relative to the sum of the
 descriptions given by the entries for the other \fIterminal-types\fP.
@@ -269,7 +269,7 @@ .SS Use= Option [\-u]
 superfluous.
 \fB@INFOCMP@\fP will flag any other \fIterminal-type use=\fP fields that
 were not needed.
-.SS Changing Databases [\-A \fIdirectory\fR] [\-B \fIdirectory\fR]
+.SS "Changing Databases [\-A \fIdirectory\fR] [\-B \fIdirectory\fR]"
 Like other \fI\%ncurses\fP utilities,
 \fB@INFOCMP@\fP looks for the terminal descriptions in several places.
 You can use the \fI\%TERMINFO\fP and \fI\%TERMINFO_DIRS\fP environment
@@ -292,7 +292,7 @@ .SS Changing Databases [\-A \fIdirectory\fR] [\-B 
\fIdirectory\fR]
 For instance,
 you can use this feature for comparing descriptions for the same terminal
 created by different people.
-.SS Other Options
+.SS "Other Options"
 .TP 5
 \fB\-0\fP
 causes the fields to be printed on one line, without wrapping.
diff --git a/man/menu.3x b/man/menu.3x
index 247ebcfbe..ed04a08ad 100644
--- a/man/menu.3x
+++ b/man/menu.3x
@@ -65,7 +65,7 @@ .SH DESCRIPTION
 To use the \fBmenu\fP library, link with the options
 \fB\-lmenu \-lcurses\fP.
 .
-.SS Current Default Values for Item Attributes
+.SS "Current Default Values for Item Attributes"
 .
 The \fBmenu\fP library maintains a default value for item attributes.
 You can
@@ -75,7 +75,7 @@ .SS Current Default Values for Item Attributes
 \fBset_\fP function affects future item creations, but does not change the
 rendering of items already created.
 .
-.SS Routine Name Index
+.SS "Routine Name Index"
 .
 The following table lists each \fBmenu\fP routine and the name of
 the manual page on which it is described.
diff --git a/man/menu_driver.3x b/man/menu_driver.3x
index f3a8f02fb..2bd25f699 100644
--- a/man/menu_driver.3x
+++ b/man/menu_driver.3x
@@ -118,7 +118,7 @@ .SH DESCRIPTION
 .PP
 If the second argument is one of the above pre-defined requests, the
 corresponding action is performed.
-.SS MOUSE HANDLING
+.SS "Mouse Handling"
 If the second argument is the KEY_MOUSE special key, the associated
 mouse event is translated into one of the above pre-defined requests.
 Currently only clicks in the user window (e.g., inside the menu display
@@ -158,7 +158,7 @@ .SS MOUSE HANDLING
 If you clicked outside the user window
 or the mouse event could not be translated
 into a menu request an \fBE_REQUEST_DENIED\fP is returned.
-.SS APPLICATION-DEFINED COMMANDS
+.SS "Application-defined Commands"
 If the second argument is neither printable nor one of the above
 pre-defined menu requests or KEY_MOUSE,
 the drive assumes it is an application-specific
diff --git a/man/ncurses.3x b/man/ncurses.3x
index 36d123922..c0d2e546f 100644
--- a/man/ncurses.3x
+++ b/man/ncurses.3x
@@ -1594,7 +1594,7 @@ .SH PORTABILITY
 (that is,
 individual differences between the XSI Curses and \fI\%ncurses\fP calls)
 are described in \fBPORTABILITY\fP sections of the library man pages.
-.SS Error checking
+.SS "Error Checking"
 In many cases, X/Open Curses is vague about error conditions,
 omitting some of the SVr4 documentation.
 .PP
@@ -1606,7 +1606,7 @@ .SS Error checking
 to tell an application which of several possible errors were detected.
 Relying on this (or some other) extension will adversely affect the
 portability of curses applications.
-.SS Extensions versus portability
+.SS "Extensions Versus Portability"
 Most of the extensions provided by \fI\%ncurses\fP have not been
 standardized.
 Some have been incorporated into other implementations, such as
@@ -1641,7 +1641,7 @@ .SS Extensions versus portability
 This implementation can also be configured to provide a set of functions which
 improve the ability to manage multiple screens.
 See \fBcurs_sp_funcs\fP(3X) for details.
-.SS Padding differences
+.SS "Padding Differences"
 In historic curses versions, delays embedded in the capabilities \fBcr\fP,
 \fBind\fP, \fBcub1\fP, \fBff\fP and \fBtab\fP activated corresponding delay
 bits in the Unix tty driver.
@@ -1649,7 +1649,7 @@ .SS Padding differences
 This method is slightly more expensive, but narrows the interface
 to the Unix kernel significantly and increases the package's portability
 correspondingly.
-.SS Header files
+.SS "Header Files"
 The header file \fI\%curses.h\fP itself includes the header files
 \fI\%stdio.h\fP and \fI\%unctrl.h\fP.
 .PP
diff --git a/man/scr_dump.5 b/man/scr_dump.5
index ff1fa1e0f..73cbebb40 100644
--- a/man/scr_dump.5
+++ b/man/scr_dump.5
@@ -114,7 +114,7 @@ .SS ncurses6
 because the library truncates or fills the screen as necessary.
 .bP
 The ncurses6 \fBgetwin\fP reads the legacy screen dumps from ncurses5.
-.SS ncurses5 (legacy)
+.SS "ncurses5 (Legacy)"
 The screen-dump feature was added to \fI\%ncurses\fP in June 1995.
 While there were fixes and improvements in succeeding years,
 the basic scheme was unchanged:
@@ -133,7 +133,7 @@ .SS ncurses5 (legacy)
 .SH PORTABILITY
 There is no standard format for \fBputwin\fP.
 This section gives a brief description of the existing formats.
-.SS X/Open Curses
+.SS "X/Open Curses"
 Refer to \fIX/Open Curses, Issue 7\fP (2009).
 .PP
 X/Open's documentation for \fIenhanced curses\fP says only:
@@ -170,7 +170,7 @@ .SS X/Open Curses
 In the foregoing, emphasis was added to \fBunspecified format\fP
 and to \fBXPG4 or to earlier XPG releases\fP,
 for clarity.
-.SS Unix System V
+.SS "Unix System V"
 Unix System\ V curses identified the file format by writing a
 \*(``magic number\*('' at the beginning of the dump.
 The \fBWINDOW\fP data and the lines of text follow, all in binary form.
diff --git a/man/tabs.1 b/man/tabs.1
index 7c445ff88..90a5bb1a9 100644
--- a/man/tabs.1
+++ b/man/tabs.1
@@ -86,7 +86,7 @@ .SH DESCRIPTION
 since the normal initialization sequences do not ensure that tab-stops
 are reset.
 .SH OPTIONS
-.SS General Options
+.SS "General Options"
 .TP 5
 .BI \-T "name"
 Tell \fB@TABS@\fP which terminal type to use.
@@ -110,7 +110,7 @@ .SS General Options
 The \fB@TABS@\fP program processes a single list of tab stops.
 The last option to be processed which defines a list is the one that
 determines the list to be processed.
-.SS Implicit Lists
+.SS "Implicit Lists"
 Use a single number as an option,
 e.g., \*(``\fB\-5\fP\*('' to set tabs at the given
 interval (in this case 1, 6, 11, 16, 21, etc.).
@@ -119,7 +119,7 @@ .SS Implicit Lists
 Use \*(``\fB\-0\fP\*('' to clear all tabs.
 .PP
 Use \*(``\fB\-8\fP\*('' to set tabs to the standard interval.
-.SS Explicit Lists
+.SS "Explicit Lists"
 An explicit list can be defined after the options
 (this does not use a \*(``\-\*('').
 The values in the list must be in increasing numeric order,
@@ -144,7 +144,7 @@ .SS Explicit Lists
 .RE
 .PP
 which is equivalent to the 1,6,11,16,21 example.
-.SS Predefined Tab-Stops
+.SS "Predefined Tab Stops"
 POSIX defines several predefined lists of tab stops.
 .TP 5
 .B \-a
diff --git a/man/term.5 b/man/term.5
index e1eaa995e..26b5d0472 100644
--- a/man/term.5
+++ b/man/term.5
@@ -62,7 +62,7 @@ .SH NAME
 .SH SYNOPSIS
 .B term
 .SH DESCRIPTION
-.SS STORAGE LOCATION
+.SS "Storage Location"
 Compiled terminfo descriptions are placed under the directory \fB\*d\fP.
 Two configurations are supported
 (when building the \fI\%ncurses\fP libraries):
@@ -97,7 +97,7 @@ .SS STORAGE LOCATION
 \fI\%TERMINFO_DIRS\fP environment variable by assuming a directory tree
 for entries that correspond to an existing directory,
 and hashed database otherwise.
-.SS LEGACY STORAGE FORMAT
+.SS "Legacy Storage Format"
 The format has been chosen so that it will be the same on all hardware.
 An 8 or more bit byte is assumed, but no assumptions about byte ordering
 or sign extension are made.
@@ -215,7 +215,7 @@ .SS LEGACY STORAGE FORMAT
 interpreted form, not the printing representation.
 Padding information $<nn> and parameter information %x are
 stored intact in uninterpreted form.
-.SS EXTENDED STORAGE FORMAT
+.SS "Extended Storage Format"
 The previous section describes the conventional terminfo binary format.
 With some minor variations of the offsets (see PORTABILITY),
 the same binary format is used in all modern Unix systems.
@@ -276,7 +276,7 @@ .SS EXTENDED STORAGE FORMAT
 described in \fBterm_variables\fP(3X) which associate the long capability
 names with members of a \fBTERMTYPE\fP structure.
 .
-.SS EXTENDED NUMBER FORMAT
+.SS "Extended Number Format"
 On occasion, 16-bit signed integers are not large enough.
 With \fI\%ncurses\fP 6.1,
 a new format was introduced by making a few changes
@@ -315,7 +315,7 @@ .SS setupterm
 this is why the numbers and sizes are included.
 Also, new capabilities must always be added at the end of the lists
 of boolean, number, and string capabilities.
-.SS Binary format
+.SS "Binary Format"
 X/Open Curses does not specify a format for the terminfo database.
 System V curses used a directory-tree of binary files,
 one per terminal description.
@@ -338,7 +338,7 @@ .SS Binary format
 The format used by the other Unix versions
 can be matched by building \fI\%ncurses\fP
 with different configuration options.
-.SS Magic codes
+.SS "Magic Codes"
 The magic number in a binary terminfo file is the first 16-bits (two bytes).
 Besides making it more reliable for the library to check that a file
 is terminfo,
@@ -347,12 +347,12 @@ .SS Magic codes
 with 0433, 0435 as screen-dumps (see \fBscr_dump\fP(5)).
 This implementation uses 01036 as a continuation of that sequence,
 but with a different high-order byte to avoid confusion.
-.SS The TERMTYPE structure
+.SS "The \fITERMTYPE\fP Structure"
 Direct access to the \fBTERMTYPE\fP structure is provided for legacy
 applications.
 Portable applications should use the \fBtigetflag\fP and related functions
 described in \fBcurs_terminfo\fP(3X) for reading terminal capabilities.
-.SS Mixed-case terminal names
+.SS "Mixed-case Terminal Names"
 A small number of terminal descriptions use uppercase characters in
 their names.
 If the underlying filesystem ignores the difference between
diff --git a/man/term_variables.3x b/man/term_variables.3x
index d0360642e..c84b787f8 100644
--- a/man/term_variables.3x
+++ b/man/term_variables.3x
@@ -90,7 +90,7 @@ .SH DESCRIPTION
 which provide read-only access to \fIcurses\fP's state.
 In either case, applications should treat them as read-only to avoid
 confusing the library.
-.SS Alternate Character Set Mapping
+.SS "Alternate Character Set Mapping"
 After initializing the curses or terminfo interfaces,
 the \fBacs_map\fP array holds information used to translate cells
 with the \fBA_ALTCHARSET\fP video attribute into line-drawing characters.
@@ -100,7 +100,7 @@ .SS Alternate Character Set Mapping
 constants in <curses.h>.
 .PP
 The comparable data for the wide-character library is a private variable.
-.SS Current Terminal Data
+.SS "Current Terminal Data"
 After initializing the curses or terminfo interfaces,
 the \fBcur_term\fP contains data describing the current terminal.
 This variable is also set as a side-effect of \fBset_term\fP(3X)
@@ -110,7 +110,7 @@ .SS Current Terminal Data
 use as a parameter to \fBset_term\fP, for switching between screens.
 Alternatively, one can save the return value from \fBnewterm\fP
 or \fBsetupterm\fP(3X) to reuse in \fBset_term\fP.
-.SS Terminfo Lookup Tables
+.SS "\fIterminfo\fP Lookup Tables"
 The \fB@TIC@\fP(1) and \fB@INFOCMP@\fP(1) programs use lookup tables for
 the long and short names of terminfo capabilities,
 as well as the corresponding names for termcap capabilities.
@@ -133,13 +133,13 @@ .SS Terminfo Lookup Tables
 \fBnumcodes\fP, and
 \fBstrcodes\fP.
 .\"
-.SS Terminal Type
+.SS "Terminal Type"
 A terminal description begins with one or more terminal names
 separated by \*(``|\*('' (vertical bars).
 On initialization of the curses or terminfo interfaces,
 \fBsetupterm\fP(3X) copies the terminal names to the array \fBttytype\fP.
 .\"
-.SS Terminfo Names
+.SS "\fIterminfo\fP Names"
 In addition to the variables, \fB<term.h>\fP also defines a symbol for each
 terminfo capability \fIlong name\fP.
 These are in terms of the symbol \fBCUR\fP,
diff --git a/man/terminfo.head b/man/terminfo.head
index d4989909f..342511959 100644
--- a/man/terminfo.head
+++ b/man/terminfo.head
@@ -77,7 +77,7 @@ specifying padding requirements and initialization sequences.
 .PP
 This manual describes \fI\%ncurses\fP
 version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@).
-.SS Terminfo Entry Syntax
+.SS "\fIterminfo\fP Entry Syntax"
 Entries in
 .I terminfo
 consist of a sequence of fields:
@@ -156,7 +156,7 @@ _
 .TE
 .PP
 For more on terminal naming conventions, see the \fBterm\fP(7) manual page.
-.SS Terminfo Capabilities Syntax
+.SS "\fIterminfo\fP Capabilities Syntax"
 The terminfo entry consists of several \fIcapabilities\fP,
 i.e., features that the terminal has,
 or methods for exercising the terminal's features.
@@ -185,7 +185,7 @@ Any capability can be \fIcanceled\fP,
 i.e., suppressed from the terminal entry,
 by following its name with \*(``@\*(''
 rather than a capability value.
-.SS Similar Terminals
+.SS "Similar Terminals"
 If there are two very similar terminals, one (the variant) can be defined as
 being just like the other (the base) with certain exceptions.
 In the
@@ -220,6 +220,6 @@ user preferences.
 An entry included via \fBuse\fP can contain canceled capabilities,
 which have the same effect as if those cancels were inline in the
 using terminal entry.
-.SS Predefined Capabilities
+.SS "Predefined Capabilities"
 .\" Head of terminfo man page ends here
 .ps -1
diff --git a/man/tic.1m b/man/tic.1m
index 384d8d629..6815f7e30 100644
--- a/man/tic.1m
+++ b/man/tic.1m
@@ -139,7 +139,7 @@ .SH DESCRIPTION
 .PP
 The \fIFetching Compiled Descriptions\fP section in the \fBterminfo\fR(5)
 manual goes into further detail.
-.SS ALIASES
+.SS Aliases
 This is the same program as @INFOTOCAP@ and @CAPTOINFO@;
 usually those are linked to, or copied from this program:
 .bP
@@ -402,7 +402,7 @@ .SH OPTIONS
 make an extended table entry for that.
 User-defined capability strings
 whose name begins with \*(``k\*('' are treated as function keys.
-.SS PARAMETERS
+.SS Parameters
 .TP
 \fIfile\fP
 contains one or more \fBterminfo\fP terminal descriptions in source
@@ -412,7 +412,7 @@ .SS PARAMETERS
 .IP
 If \fIfile\fP is \*(``-\*('', then the data is read from the standard input.
 The \fIfile\fP parameter may also be the path of a character-device.
-.SS PROCESSING
+.SS Processing
 All but one of the capabilities recognized by \fB@TIC@\fP are documented
 in \fBterminfo\fP(5).
 The exception is the \fBuse\fP capability.
diff --git a/man/tput.1 b/man/tput.1
index a23240ff3..a7a3b2d9b 100644
--- a/man/tput.1
+++ b/man/tput.1
@@ -282,7 +282,7 @@ .SS Aliases
 same effect as \fB@TPUT@ init\fP.
 Again, you are less likely to use that link because another program
 named \fBinit\fP has a more well-established use.
-.SS Terminal Size
+.SS "Terminal Size"
 Besides the special commands (e.g., \fBclear\fP),
 @TPUT@ treats certain terminfo capabilities specially:
 \fBlines\fP and \fBcols\fP.
diff --git a/man/tset.1 b/man/tset.1
index 4621c8cfa..6154478a3 100644
--- a/man/tset.1
+++ b/man/tset.1
@@ -57,7 +57,7 @@ .SH SYNOPSIS
 .br
 \fB@RESET@\fP [\fB\-IQVcqrsw\fP] [\fB\-\fP] [\fB\-e\fP \fIch\fP] [\fB\-i\fP 
\fIch\fP] [\fB\-k\fP \fIch\fP] [\fB\-m\fP \fImapping\fP] [\fIterminal-type\fP]
 .SH DESCRIPTION
-.SS tset - initialization
+.SS "\fItset\fP \(em initialization"
 This program initializes terminals.
 .PP
 First, \fB@TSET@\fP retrieves the current terminal mode settings
@@ -129,7 +129,7 @@ .SS tset - initialization
 Finally, if the erase, interrupt and line kill characters have changed,
 or are not set to their default values, their values are displayed to the
 standard error output.
-.SS reset - reinitialization
+.SS "\fIreset\fP \(em reinitialization"
 When invoked as \fB@RESET@\fP, \fB@TSET@\fP sets the terminal
 modes to \*(``sane\*('' values:
 .bP
diff --git a/man/user_caps.5 b/man/user_caps.5
index 033f9d464..c2ce2d8dd 100644
--- a/man/user_caps.5
+++ b/man/user_caps.5
@@ -185,7 +185,7 @@ .SS Background
 Fitting that into termcap's limitation of 2-character names
 would be pointless.
 These extended keys are available only with terminfo.
-.SS Recognized capabilities
+.SS "Recognized Capabilities"
 The \fI\%ncurses\fP library uses the user-definable capabilities.
 While the terminfo database may have other extensions,
 \fI\%ncurses\fP makes explicit checks for these:
@@ -347,7 +347,7 @@ .SS Recognized capabilities
              %?%p4%tM%em%;,
 .fi
 .
-.SS Extended key-definitions
+.SS "Extended Key Definitions"
 Several terminals provide the ability to send distinct strings for
 combinations of modified special keys.
 There is no standard for what those keys can send.
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]