\Header{mtext}{Write text into the margins of a plot}
\keyword{aplot}{mtext}
\begin{Usage}
\begin{verbatim}
mtext(text, side=3, line=0, outer=FALSE, at=NULL, adj = NA, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\texttt{text}] character string to be written.
\item[\texttt{side}] on which side of the plot (1=bottom, 2=left, 3=top, 4=right).
\item[\texttt{line}] on which MARgin line, starting at 0 counting outwards.
\item[\texttt{outer}] use outer margins if available.
\item[\texttt{at}] give location in user-coordinates.  If \texttt{length(at)==0}
(default), the location will correspond to \texttt{par("adj")}.
\item[\texttt{adj}] length = 1 or 2 : adjustment in x- (and optionally y-)
direction.  If \texttt{adj} isn't finite (default), a default is setup,
using \texttt{par("las")} (and \emph{not} \texttt{par("adj")}!
\item[\texttt{...}] Further graphical parameters; currently supported are:
\item[\texttt{cex}] character expansion factor (default = 1).
\item[\texttt{col}] color to use.
\item[\texttt{font}] font for text.
\end{ldescription}
\end{Arguments}
\begin{Description}
\texttt{text} is written in one of the four margins (\texttt{side}) of the plot.
\texttt{line} measures the distance outwardly in character size units.\end{Description}
\begin{Section}{Side Effects}
The given text is written onto the current plot.\end{Section}
\begin{SeeAlso}
\texttt{\Link{title}}, \texttt{\Link{text}}, \texttt{\Link{plot}}.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
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)
\end{ExampleCode}
\end{Examples}

