When formatting for typesetters, a blank input line produces 1 vee (one line height, basically) of vertical space, but the default inter-paragraph distance in man(7) is 0.4v. Second, the package always puts inter-paragraph spacing before a (sub)section heading anyway. Third, forcing vertical space after a (sub)section heading is nonidiomatic.
Fixes numerous style warnings from "nroff -rCHECKSTYLE=3 -man" in groff 1.23.0 of the following form. an.tmac:lib/readline/doc/history.3:xxx: style: blank line in input --- lib/readline/doc/history.3 | 13 ------------- 1 file changed, 13 deletions(-) diff --git a/lib/readline/doc/history.3 b/lib/readline/doc/history.3 index 4f1af5fe..266d91f6 100644 --- a/lib/readline/doc/history.3 +++ b/lib/readline/doc/history.3 @@ -67,7 +67,6 @@ .SH DESCRIPTION History library is able to keep track of those lines, associate arbitrary data with each line, and utilize information from previous lines in composing new ones. -.PP .SH "HISTORY EXPANSION" The history library supports a history expansion feature that is identical to the history expansion in @@ -404,7 +403,6 @@ .SS Initializing History and State Management .F1 void history_set_history_state "HISTORY_STATE *state" Set the state of the history list according to \fIstate\fP. - .SS History List Management These functions manage individual entries on the history list, or set parameters managing the list itself. @@ -451,9 +449,7 @@ .SS History List Management .F1 int history_is_stifled "void" Returns non-zero if the history is stifled, zero if it is not. - .SS Information About the History List - These functions return information about the entire history list or individual list entries. @@ -484,9 +480,7 @@ .SS Information About the History List Return the number of bytes that the primary history entries are using. This function returns the sum of the lengths of all the lines in the history. - .SS Moving Around the History List - These functions allow the current index into the history list to be set or changed. @@ -507,9 +501,7 @@ .SS Moving Around the History List If the possibly-incremented history offset refers to a valid history entry, return a pointer to that entry; otherwise, return a \fBNULL\fP pointer. - .SS Searching the History List - These functions allow searching of the history list for entries containing a specific string. Searching may be performed both forward and backward from the current history position. The search may be \fIanchored\fP, @@ -539,7 +531,6 @@ .SS Searching the History List absolute index into the list. If \fIdirection\fP is negative, the search proceeds backward from \fIpos\fP, otherwise forward. Returns the absolute index of the history element where \fIstring\fP was found, or -1 otherwise. - .SS Managing the History File The History library can read the history from and write it to a file. This section documents the functions for managing a history file. @@ -574,9 +565,7 @@ .SS Managing the History File \fInlines\fP lines. If \fIfilename\fP is \fBNULL\fP, then \fI\*~/.history\fP is truncated. Returns 0 on success, or \fBerrno\fP on failure. - .SS History Expansion - These functions implement history expansion. .F2 int history_expand "const char *string" "char **output" @@ -623,9 +612,7 @@ .SS History Expansion Extract a string segment consisting of the \fIfirst\fP through \fIlast\fP arguments present in \fIstring\fP. Arguments are split using \fBhistory_tokenize()\fP. - .SS History Variables - This section describes the externally-visible variables exported by the GNU History Library. -- 2.30.2
signature.asc
Description: PGP signature
