Re: groff_man_style.7: Hyperlink macros: \: before or after '#', '?'?

[G. Branden Robinson]

Hi Ralph,

At 2022-02-12T10:41:09+0000, Ralph Corderoy wrote:
> Hi Branden,
> 
> > On the other hand, as I noted before, in an HTTP GET request, these
> > symbols, to be meaningful, must be followed by further content.
> 
> No, they mustn't.  The first ‘?’ starts the query which terminates at
> the ‘#’ or the end of the string.  The query may contain as many
> literal ‘?’ or ‘&’ is it likes.  Nothing needs to come between them or
> after the last.
> 
> You're probably thinking of the W3C recommendation that form
> submissions become a query string with ‘&’ as the separator.

That may be it.  After a brief stint in the dot-com bubble, I've spent
most of my software development years avoiding HTML and CSS (and
JavaScript), and I feel that was mostly time well-spent.  Mostly.

My pending commit does not attempt to put a thumb on the scale.

commit 1faa12312f5155eba5bafcaa400bad23ddef74b6
Author:     G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Feb 12 20:14:06 2022 +1100
Commit:     G. Branden Robinson <g.branden.robinson@gmail.com>
CommitDate: Sat Feb 12 22:28:17 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.

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 0485b9660..f541de54a 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1229,11 +1229,14 @@ 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 and ampersands in HTTP GET URIs.
+.
+_endif()dnl
 .B \e:
 escape sequences are ignored when supplied to device control commands
 for hyperlink-aware output drivers.
-_endif()dnl
 .
 .
 .TP

Regards,
Branden

signature.asc
Description: PGP signature