TITLE( mtext @@ Write text into the margins of a plot )
USAGE(
mtext(text=, side=3, line=0, outer=FALSE, at=, ...)
)
ALIAS(mtext)
ARGUMENTS(
ARG(text @@ character string to be written  )
ARG(side @@ on which side of the plot (1=bottom, 2=left, 3=top, 4=right))
ARG(line @@ on which MARgin line, starting at 0 counting outwards  )
ARG(outer @@ use outer margins if available )
ARG(at @@ give location in user-coordinates  )
ARG(... @@ further graphic parameters: LANG(adj), LANG(cex), DOTS )
)
COMMENT( --- mtext is defined via do_mtext(.) in  src/main/plot.c --- )
DESCRIPTION(
LANG(text) is written in one of the four margins (LANG(side)) of the plot.
LANG(line) measures the distance outwardly in character size units.
PARA
LANG(...) : The following further graphical parameters are recognized:
ITEM(adj @@ length = 1 or 2 : adjustment in x- and y )
ITEM(cex @@ character expansion factor (default = 1))
ITEM(col @@ color to use)
ITEM(font @@ font for text)
)
SECTION(Side-effects @@
The given text is written onto the current plot.
)
SEEALSO(
LANG(LINK(title)), LANG(LINK(text)), LANG(LINK(plot)).
)
EXAMPLES(
plot(1:10, (-4:5)^2, main="Parabola Points", xlab="xlab")
mtext("10 of them")
for(s in c(1:2,4))
    mtext(paste("mtext(..,side=",s,")"), side=s)
mtext("mtext(.., line= -2)", line = -2)
mtext("mtext(.., line= -1, adj = 0)", line = -1, adj =0)
##--- log axis :
plot(1:10, exp(1:10), log='y', main="log='y'", xlab="xlab")
for(s in 1:4) mtext(paste("mtext(..,side=",s,")"), side=s)
)

