aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/roff.7
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2018-08-21 18:15:22 +0000
committerIngo Schwarze <schwarze@openbsd.org>2018-08-21 18:15:22 +0000
commit1483cf671448b44a8bf37ea7129c88e24f588abd (patch)
tree491940c1180723f98f3b4e05133b1a62ba0dd3af /roff.7
parent9faad2ae0e7caf95d294df3c2ba845e98e0fff85 (diff)
downloadmandoc-1483cf671448b44a8bf37ea7129c88e24f588abd.tar.gz
mandoc-1483cf671448b44a8bf37ea7129c88e24f588abd.tar.zst
mandoc-1483cf671448b44a8bf37ea7129c88e24f588abd.zip
Implement the \\$@ escape sequence (insert all macro arguments,
quoted) in addition to the already supported \\$* (similar, but unquoted). Then use \\$@ to improve the implementation of the .als request (macro alias). Needed by groff_hdtbl(7). Gosh, it feels like the manual pages of the groff package are exercising every bloody roff(7) feature under the sun. In the manual page source code itself, not merely in the implementation of the used macro packages, that is.
Diffstat (limited to 'roff.7')
-rw-r--r--roff.79
1 files changed, 7 insertions, 2 deletions
diff --git a/roff.7 b/roff.7
index 5bf3ed25..3c403604 100644
--- a/roff.7
+++ b/roff.7
@@ -1,4 +1,4 @@
-.\" $Id: roff.7,v 1.101 2018/08/19 17:46:14 schwarze Exp $
+.\" $Id: roff.7,v 1.102 2018/08/21 18:15:22 schwarze Exp $
.\"
.\" Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
.\" Copyright (c) 2010-2018 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: August 19 2018 $
+.Dd $Mdocdate: August 21 2018 $
.Dt ROFF 7
.Os
.Sh NAME
@@ -634,6 +634,8 @@ produces
in the input stream, and thus in the output: \fI\^XtFree\^\fP.
Each occurrence of \e\e$* is replaced with all the arguments,
joined together with single space characters.
+The variant \e\e$@ is similar, except that each argument is
+individually quoted.
.Pp
Since macros and user-defined strings share a common string table,
defining a macro
@@ -1838,6 +1840,9 @@ Discard the rest of the physical input line and continue the logical
input line on the next physical input line, joining the text on
both lines together as if it were on a single input line.
This is a groff extension.
+.Ss \e$ Ns Ar arg
+Macro argument expansion, see
+.Sx de .
.Ss \e%
Hyphenation allowed at this point of the word; ignored by
.Xr mandoc 1 .