\HeaderA{normalizePath}{Express File Paths in Canonical Form}{normalizePath}
\keyword{utilities}{normalizePath}
\begin{Description}\relax
Convert file paths to canonical form for the platform, to display them
in a user-understandable form.
\end{Description}
\begin{Usage}
\begin{verbatim}
normalizePath(path)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{path}] character vector of file paths.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Where the platform supports it this turns paths into absolute paths
in their canonical form (no \code{./}, \code{../} nor symbolic links).

If the path is not a real path the result is undefined.
On Unix-alikes, this will likely be the corresponding input element.
On Windows, it will likely result in an error being signalled.
\end{Details}
\begin{Value}
A character vector.
\end{Value}
\begin{Examples}
\begin{ExampleCode}
cat(normalizePath(c(R.home(), tempdir())), sep = "\n")
\end{ExampleCode}
\end{Examples}

