diff options
| author |   Ingo Schwarze <schwarze@openbsd.org> | 2017-06-04 00:13:15 +0000 |
|---|---|---|
| committer | Ingo Schwarze <schwarze@openbsd.org> | 2017-06-04 00:13:15 +0000 |
| commit | d019f1f6d4b986db56f6fa599968bc395d7ce072 (patch) | |
| tree | dde68bc644d6109fea6ba0717068a41e15879a7e /roff.7 | |
| parent | 34091a7ac02b59ae92c9258e551d73f383869db9 (diff) | |
| download | mandoc-d019f1f6d4b986db56f6fa599968bc395d7ce072.tar.gz mandoc-d019f1f6d4b986db56f6fa599968bc395d7ce072.tar.zst mandoc-d019f1f6d4b986db56f6fa599968bc395d7ce072.zip | |
Pure preprocessor implementation of the roff(7) .ec and .eo requests
(escape character control), touching nothing after the preprocessing
stage and keeping even the state variable local to the preprocessor.
Since the escape character is also used for line continuation, this
requires pulling the implementation of line continuation from the
input reader to the preprocessor, which also considerably shortens
the code required for that.
When the escape character is changed, simply let the preprocessor
replace bare by escaped backslashes and instances of the non-standard
escape character with bare backslashes - that's all we need.
Oh, and if anybody dares to use these requests in OpenBSD manuals,
sending a medium-sized pack of axe-murderers after them might be a
worthwhile part of the punishment, but probably insuffient on its own.
Diffstat (limited to 'roff.7')
| -rw-r--r-- | roff.7 | 12 |
1 files changed, 7 insertions, 5 deletions
@@ -1,4 +1,4 @@ -.\" $Id: roff.7,v 1.82 2017/06/02 19:21:23 schwarze Exp $ +.\" $Id: roff.7,v 1.83 2017/06/04 00:13:15 schwarze Exp $ .\" .\" Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv> .\" Copyright (c) 2010,2011,2013-2015,2017 Ingo Schwarze <schwarze@openbsd.org> @@ -15,7 +15,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: June 2 2017 $ +.Dd $Mdocdate: June 4 2017 $ .Dt ROFF 7 .Os .Sh NAME @@ -808,8 +808,11 @@ This is a Heirloom extension and currently unsupported. Set a trap within a diversion. Currently unsupported. .It Ic \&ec Op Ar char -Change the escape character. -Currently unsupported. +Enable the escape mechanism and change the escape character. +The +.Ar char +argument defaults to the backslash +.Pq Sq \e . .It Ic \&ecr Restore the escape character. Currently unsupported. @@ -839,7 +842,6 @@ See .Ic \&EQ . .It Ic \&eo Disable the escape mechanism completely. -Currently unsupported. .It Ic \&EP End a picture started by .Ic \&BP . |