Document Debian-specific man/mdoc SGR defaults
Closes: #963490
Colin Watson
3 years ago
| 0 | 0 | # see git-dpm(1) from git-dpm package |
| 1 | a46726f43123659a2c3ace01d52bf9a53b6aaa76 | |
| 2 | a46726f43123659a2c3ace01d52bf9a53b6aaa76 | |
| 1 | f2f6b818bf32c37fbd1d10737b5370680b0b4442 | |
| 2 | f2f6b818bf32c37fbd1d10737b5370680b0b4442 | |
| 3 | 3 | ef16ff6c6e7ff7744b318b73feaeb9a2fadaa748 |
| 4 | 4 | ef16ff6c6e7ff7744b318b73feaeb9a2fadaa748 |
| 5 | 5 | groff_1.22.4.orig.tar.gz |
| 0 | groff (1.22.4-6) UNRELEASED; urgency=medium | |
| 1 | ||
| 2 | * Document Debian-specific man/mdoc SGR defaults in grotty(1) (closes: | |
| 3 | #963490). | |
| 4 | ||
| 5 | -- Colin Watson <cjwatson@debian.org> Thu, 25 Jun 2020 15:11:33 +0100 | |
| 6 | ||
| 0 | 7 | groff (1.22.4-5) unstable; urgency=medium |
| 1 | 8 | |
| 2 | 9 | [ Debian Janitor ] |
| 0 | From f2f6b818bf32c37fbd1d10737b5370680b0b4442 Mon Sep 17 00:00:00 2001 | |
| 1 | From: Colin Watson <cjwatson@debian.org> | |
| 2 | Date: Thu, 25 Jun 2020 15:09:48 +0100 | |
| 3 | Subject: Document Debian-specific man/mdoc SGR defaults | |
| 4 | ||
| 5 | Bug-Debian: https://bugs.debian.org/963490 | |
| 6 | Forwarded: not-needed | |
| 7 | Last-Update: 2020-06-25 | |
| 8 | ||
| 9 | Patch-Name: document-sgr.patch | |
| 10 | --- | |
| 11 | src/devices/grotty/grotty.1.man | 28 ++++++++++++++++++++++++++++ | |
| 12 | 1 file changed, 28 insertions(+) | |
| 13 | ||
| 14 | diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man | |
| 15 | index 1d9b5f8c..2a3b462b 100644 | |
| 16 | --- a/src/devices/grotty/grotty.1.man | |
| 17 | +++ b/src/devices/grotty/grotty.1.man | |
| 18 | @@ -124,6 +124,22 @@ environment variable or using the \[oq]sgr\[cq] X command (see below). | |
| 19 | . | |
| 20 | . | |
| 21 | .LP | |
| 22 | +(Debian-specific: The old behaviour is the default when using the | |
| 23 | +.B man | |
| 24 | +and | |
| 25 | +.B mdoc | |
| 26 | +macro packages, because most pagers either fail to cope with SGR escape | |
| 27 | +sequences or need special options to do so. | |
| 28 | +SGR output can be re-enabled permanently by editing | |
| 29 | +.I /etc/groff/man.local | |
| 30 | +and | |
| 31 | +.IR /etc/groff/mdoc.local , | |
| 32 | +or temporarily by setting the | |
| 33 | +.I GROFF_SGR | |
| 34 | +environment variable to something non-empty.) | |
| 35 | +. | |
| 36 | +. | |
| 37 | +.LP | |
| 38 | For SGR support, it is necessary to use the | |
| 39 | .B \-R | |
| 40 | option of | |
| 41 | @@ -266,6 +282,18 @@ Use | |
| 42 | .BR grotty 's | |
| 43 | old output format (see above). | |
| 44 | This also disables color output. | |
| 45 | +(Debian-specific: This option is enabled by default when using the | |
| 46 | +.B man | |
| 47 | +and | |
| 48 | +.B mdoc | |
| 49 | +macro packages. | |
| 50 | +It can be disabled by default permanently by editing | |
| 51 | +.I /etc/groff/man.local | |
| 52 | +and | |
| 53 | +.IR /etc/groff/mdoc.local , | |
| 54 | +or temporarily by setting the | |
| 55 | +.I GROFF_SGR | |
| 56 | +environment variable to something non-empty.) | |
| 57 | . | |
| 58 | .TP | |
| 59 | .B \-d |
| 10 | 10 | avoid-perl-diamond.patch |
| 11 | 11 | mdoc-Lk-arguments.patch |
| 12 | 12 | bsd-updates.patch |
| 13 | document-sgr.patch |
| 120 | 120 | The same effect can be achieved by setting either the |
| 121 | 121 | .I GROFF_NO_SGR |
| 122 | 122 | environment variable or using the \[oq]sgr\[cq] X command (see below). |
| 123 | . | |
| 124 | . | |
| 125 | .LP | |
| 126 | (Debian-specific: The old behaviour is the default when using the | |
| 127 | .B man | |
| 128 | and | |
| 129 | .B mdoc | |
| 130 | macro packages, because most pagers either fail to cope with SGR escape | |
| 131 | sequences or need special options to do so. | |
| 132 | SGR output can be re-enabled permanently by editing | |
| 133 | .I /etc/groff/man.local | |
| 134 | and | |
| 135 | .IR /etc/groff/mdoc.local , | |
| 136 | or temporarily by setting the | |
| 137 | .I GROFF_SGR | |
| 138 | environment variable to something non-empty.) | |
| 123 | 139 | . |
| 124 | 140 | . |
| 125 | 141 | .LP |
| 265 | 281 | .BR grotty 's |
| 266 | 282 | old output format (see above). |
| 267 | 283 | This also disables color output. |
| 284 | (Debian-specific: This option is enabled by default when using the | |
| 285 | .B man | |
| 286 | and | |
| 287 | .B mdoc | |
| 288 | macro packages. | |
| 289 | It can be disabled by default permanently by editing | |
| 290 | .I /etc/groff/man.local | |
| 291 | and | |
| 292 | .IR /etc/groff/mdoc.local , | |
| 293 | or temporarily by setting the | |
| 294 | .I GROFF_SGR | |
| 295 | environment variable to something non-empty.) | |
| 268 | 296 | . |
| 269 | 297 | .TP |
| 270 | 298 | .B \-d |