Package: groff / 1.22.4-6

document-sgr.patch Patch series | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
From f2f6b818bf32c37fbd1d10737b5370680b0b4442 Mon Sep 17 00:00:00 2001
From: Colin Watson <cjwatson@debian.org>
Date: Thu, 25 Jun 2020 15:09:48 +0100
Subject: Document Debian-specific man/mdoc SGR defaults

Bug-Debian: https://bugs.debian.org/963490
Forwarded: not-needed
Last-Update: 2020-06-25

Patch-Name: document-sgr.patch
---
 src/devices/grotty/grotty.1.man | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index 1d9b5f8c..2a3b462b 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -124,6 +124,22 @@ environment variable or using the \[oq]sgr\[cq] X command (see below).
 .
 .
 .LP
+(Debian-specific: The old behaviour is the default when using the
+.B man
+and
+.B mdoc
+macro packages, because most pagers either fail to cope with SGR escape
+sequences or need special options to do so.
+SGR output can be re-enabled permanently by editing
+.I /etc/groff/man.local
+and
+.IR /etc/groff/mdoc.local ,
+or temporarily by setting the
+.I GROFF_SGR
+environment variable to something non-empty.)
+.
+.
+.LP
 For SGR support, it is necessary to use the
 .B \-R
 option of
@@ -266,6 +282,18 @@ Use
 .BR grotty 's
 old output format (see above).
 This also disables color output.
+(Debian-specific: This option is enabled by default when using the
+.B man
+and
+.B mdoc
+macro packages.
+It can be disabled by default permanently by editing
+.I /etc/groff/man.local
+and
+.IR /etc/groff/mdoc.local ,
+or temporarily by setting the
+.I GROFF_SGR
+environment variable to something non-empty.)
 .
 .TP
 .B \-d