summaryrefslogtreecommitdiffstats
path: root/man/man3/mach-map.3
diff options
context:
space:
mode:
authorDmitri Vereshchagin <dmitri.vereshchagin@gmail.com>2024-01-31 20:47:13 +0300
committerDan Cross <crossd@gmail.com>2025-07-27 09:58:50 -0400
commit10564b11755ff2d48d0f5073c46571e806fa6fb4 (patch)
tree229252742051d83558fff2352642d0f57ba66615 /man/man3/mach-map.3
parent00446db7d8fdb3ea56fa104643b34823960f7be2 (diff)
downloadplan9port-10564b11755ff2d48d0f5073c46571e806fa6fb4.tar.gz
plan9port-10564b11755ff2d48d0f5073c46571e806fa6fb4.zip
tmac/tmac.an: define .MR in a groff compatible way
groff 1.23.0 added .MR to its -man macro package. The NEWS file states that the inclusion of the macro "was prompted by its introduction to Plan 9 from User Space's troff in August 2020." From d32deab it seems that the name for Plan 9 from User Space's implementation was suggested by groff maintainer G. Brandon Robinson. Not sure if the intention was to make these definitions compatible, but it would be nice if they were. Currently, Plan 9 from User Space's .MR expects its second argument to be parenthesized. groff's .MR does not. This results in extra parentheses appearing in manual references when viewing Plan 9 from User Space's manual pages on a system using groff.
Diffstat (limited to 'man/man3/mach-map.3')
-rw-r--r--man/man3/mach-map.316
1 files changed, 8 insertions, 8 deletions
diff --git a/man/man3/mach-map.3 b/man/man3/mach-map.3
index a0e27402..760b4626 100644
--- a/man/man3/mach-map.3
+++ b/man/man3/mach-map.3
@@ -133,10 +133,10 @@ via
data structures that provides access to an address space
and register set.
The functions described in
-.MR mach-file (3)
+.MR mach-file 3
are typically used to construct these maps.
Related library functions described in
-.MR mach-symbol (3)
+.MR mach-symbol 3
provide similar access to symbol tables.
.PP
Each
@@ -178,7 +178,7 @@ The
.B rw
function is most commonly used to provide
access to executing processes via
-.MR ptrace (2)
+.MR ptrace 2
and to zeroed segments.
.PP
.I Allocmap
@@ -346,7 +346,7 @@ such locations are useful for passing specific constants to
functions expect locations, such as
.I unwind
(see
-.MR mach-stack (3) ).
+.MR mach-stack 3 ).
.PP
.I Loccmp
compares two locations, returning negative, zero, or positive
@@ -360,7 +360,7 @@ which are ordered before indirections.
.PP
.I Locfmt
is a
-.MR print (3) -verb
+.MR print 3 -verb
that formats a
.B Loc
structure
@@ -371,7 +371,7 @@ Indirection locations are needed in some contexts (e.g., when
using
.I findlsym
(see
-.MR mach-symbol (3) )),
+.MR mach-symbol 3 )),
but bothersome in most.
.I Locsimplify
rewrites indirections as absolute memory addresses, by evaluating
@@ -397,8 +397,8 @@ function families as necessary.
.SH SOURCE
.B \*9/src/libmach
.SH "SEE ALSO"
-.MR mach (3) ,
-.MR mach-file (3)
+.MR mach 3 ,
+.MR mach-file 3
.SH DIAGNOSTICS
These routines set
.IR errstr .