title: Scaladoc API of scala.reflect.io?
body: <p>Is there any public Scaladoc API of scala.reflect.io? It seems there are useful IO utilities in there. Would it be more beneficial to use these instead of Java IO?</p>
  
  <p>Saw in <a href="https://github.com/scala/scala/blob/2.11.x/src/compiler/scala/tools/nsc/io/package.scala" rel="nofollow noreferrer">Scala 2.11.8 Source</a>
  there is an object scala.reflect.io.Directory which allows to do operation on dirs:</p>
  
  <pre><code>scala&gt; val cd = scala.reflect.io.Directory(".")
  cd: scala.reflect.io.Directory = .
  
  scala&gt; cd.toCanonical
  res0: scala.reflect.io.Path = /home/myusername/myProject1
  
  scala&gt; cd. &lt;TAB&gt;
  /                   dirs           isDirectory    parent               toCanonical
  addExtension        endsWith       isEmpty        parents              toDirectory
  canRead             equals         isFile         path                 toFile
  canWrite            exists         isFresher      relativize           toString
  changeExtension     extension      isSame         resolve              toURI
  createDirectory     files          jfile          segments             toURL
  createFile          hasExtension   lastModified   separator            truncate
  deepFiles           hashCode       length         separatorStr         walk
  deepList            ifDirectory    list           stripExtension       walkFilter
  delete              ifFile         name           toAbsolute
  deleteRecursively   isAbsolute     normalize      toAbsoluteWithRoot
  </code></pre>