[groff] 08/11: NEWS: Add OSC 8 testing guidance.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 12aa38c7f20e2656b1a5d0d38699d89b33e48b43
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Oct 5 18:38:42 2021 +1100

    NEWS: Add OSC 8 testing guidance.
    
    I surveyed pager OSC 8 recognition and handling on a Debian buster-based
    system.
    
    * less 487 lacks support, emitting garbage characters (version 566
      claims support, and I confirmed it as working in version 581.2).
    * pg from util-linux 2.33.1 lacks support, emitting garbage characters.
      (pg does not ship in Debian, is deprecated upstream, and does not
      build by fault.)
    * most 5.0.0a lacks support, emitting garbage characters.
    
    However:
    * more from util-linux 2.33.1 works fine.
---
 NEWS | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/NEWS b/NEWS
index 4eebea1..d8da06e 100644
--- a/NEWS
+++ b/NEWS
@@ -130,6 +130,12 @@ o The an (man) macro package can now produce clickable 
hyperlinks within
   sequences in pager programs.  The package now recognizes a "U"
   register to configure hyperlink support for any output driver.
 
+  Use a command like
+    printf '\033]8;;man:grotty(1)\033\\grotty(1)\033]8;;\033\\\n' | more
+  to check your terminal and pager for OSC 8 support.  If it you see
+  "grotty(1)" and no additional garbage characters, then you may wish to
+  edit "man.local" to remove the lines that disable this feature.
+
 o Part of the an (man) macro package has been renamed from "an-old.tmac"
   to "an.tmac", replacing a file that sourced the "andoc.tmac" wrapper.
   This means that the "-man" argument to groff (or nroff, or troff) will