[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
signature.asc
Description: PGP signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH 16/52] Revise man page subsection titles.,
G. Branden Robinson <=