[BACK]Return to arg.in CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc / regress / mdoc / Eo

File: [cvsweb.bsd.lv] / mandoc / regress / mdoc / Eo / arg.in (download)

Revision 1.1, Fri Dec 21 17:15:22 2018 UTC (5 years, 5 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_6, VERSION_1_14_5, HEAD

Rename mandoc_getarg() to roff_getarg() and pass it the roff parser
struct as an argument such that after copy-in, it can call roff_expand()
once again, which used to be called roff_res() before this.  This
fixes a subtle low-level roff(7) parsing bug reported by Fabio
Scotoni <fabio at esse dot ch> in the 4.4BSD-Lite2 mdoc.samples(7)
manual page, because that page used an escaped escape sequence in
a macro argument.

To expand escaped escape sequences in quoted mdoc(7) arguments, too,
stop bypassing the call to roff_getarg() in mdoc_argv.c, function args()
for this case.  This does not solve the case of escaped escape sequences
in quoted .Bl -column phrases yet.

Because roff_expand() can make the string longer, roff_getarg() can no
longer operate in-place but needs to malloc(3) the returned string.
In the high-level parsers, free(3) that string after processing it.

.\" $OpenBSD: arg.in,v 1.1 2018/12/21 16:58:49 schwarze Exp $
.Dd $Mdocdate: December 21 2018 $
.Dt EO-ARG 1
.Os
.Sh NAME
.Nm Eo-arg
.Nd escapes in arguments of enclosure macros
.Sh DESCRIPTION
.ds o \(Fo
.ds c \(Fc
.Eo \*o
unquoted unescaped
.Ec \*c
.Pp
.Eo "\*o"
quoted unescaped
.Ec "\*c"
.Pp
.Eo \\*o
unquoted escaped
.Ec \\*c
.Pp
.Eo "\\*o"
quoted escaped
.Ec "\\*c"