[groff] 23/28: groff_man*(7): Discuss hyperlink breaking more.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 11d858292109283be801bd46d33e9eea9f145933
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Feb 12 20:14:06 2022 +1100

    groff_man*(7): Discuss hyperlink breaking more.
    
    Tell readers of both groff_man(7) and groff_man_style(7) that \: escape
    sequences in device control command arguments don't bother the output
    driver.
    
    Identify @, #, ?, and & as possible break points for email addresses and
    URIs.  Refrain from making a style recommendation either way at this
    point.  (We consistently break after @ in our own pages.)
    
    Thanks to Alejandro Colomar and Ralph Corderoy for the discussion.
---
 tmac/groff_man.7.man.in | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 0485b966..7a6344c0 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1229,11 +1229,16 @@ Thus,
 .RE
 has several potential break points in the URI shown.
 .
-The
+Consider adding break points before or after at signs in email
+addresses,
+and question marks,
+ampersands,
+and number signs in HTTP(S) URIs.
+.
+_endif()dnl
 .B \e:
 escape sequences are ignored when supplied to device control commands
 for hyperlink-aware output drivers.
-_endif()dnl
 .
 .
 .TP