[PATCH 09/19] man/curs_termcap.3x: Permit URL to break.

[G. Branden Robinson]

When adding support for the groff extension macros `UR` and `UE` to this
page in my patch submission of 9 September, I forgot to check the case
where the link target URL is formatted.  With the hyphenless breakpoint
escape sequence (another groff extension already used in
curs_variables.3x), the URL formats better even when the line is
adjusted.  Define `:` string to house the escape sequence where
supported.

Consequently, drop `na` and `ad` requests, recalling rationale from
January revision of the capability tables in terminfo(5).

'Stop bracketing [material] with requests to [manipulate] adjustment.
This doesn't work as people expect; if a site's local man(7)
configuration turned off adjustment [(with `.na` or `.ad l`, for
instance)], the `ad` request at the end [the bracketed material] would
turn it back on again.  This reënablement of adjustment also frustrates
diffing of man page changes due to changes in adjustment parity.  See
"MKterminfo.sh" ... for the new approach.'

For example, when diffing my changes to ncurses man pages, I turn
adjustment off at rendering time with groff 1.23 man(7)'s `AD` string.

--- ncurses-20240914.groff-git  2024-09-17 00:33:13.494182606 -0500
+++ ncurses-20240914gbr.groff-git       2024-09-21 11:30:11.265674663 -0500
...
 SEE ALSO
-     TCTEST ‐ A Termcap Test Utility
+     TCTEST —— A Termcap Test Utility

-     ncurses(3NCURSES),               terminfo(3NCURSES),               
putc(3),
+     ncurses(3NCURSES), terminfo(3NCURSES), putc(3),
      terminfo_variables(3NCURSES), terminfo(5)

We can see that in ncurses 20240914, adjustment sprang back to life in
an undesired way, and that my change restores its disablement, as
directed by the `-d AD=l` option to nroff(1).

Also use em dash instead of hyphen to set title of Thomas Dickey's
"TCTEST" web page.
---
 man/curs_termcap.3x | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/man/curs_termcap.3x b/man/curs_termcap.3x
index ad1119f71..8b9b4893c 100644
--- a/man/curs_termcap.3x
+++ b/man/curs_termcap.3x
@@ -40,6 +40,9 @@
 .el   .ds '' ""
 .\}
 .
+.ie \n(.g .ds : \:
+.el       .ds : \" empty
+.
 .de bP
 .ie n  .IP \(bu 4
 .el    .IP \(bu 2
@@ -677,11 +680,9 @@ .SH BUGS
 the \fItermcap\fP interface to accommodate the latter's limitation in
 this respect.
 .SH "SEE ALSO"
-.na
-.UR https://invisible\-island.net/ncurses/tctest.html
-\fITCTEST - A Termcap Test Utility\fP
+.UR https://\*:invisible\-\*:island\*:.net/\*:ncurses/\*:tctest\*:.html
+.I "TCTEST \(em A Termcap Test Utility"
 .UE
-.ad
 .PP
 \fB\%curses\fP(3X),
 \fB\%curs_terminfo\fP(3X),
-- 
2.30.2

signature.asc
Description: PGP signature