Improve some docs

Author: Blaisorblade

compiler/src/dotty/tools/dotc/typer/Inliner.scala

@@ -151,7 +151,6 @@ object Inliner {
   def dropInlined(inlined: tpd.Inlined)(implicit ctx: Context): Tree = {
     if (enclosingInlineds.nonEmpty) inlined // Remove in the outer most inlined call
     else {
-      // Position used for any tree that was inlined (including recursive inlines)
       val inlinedAtPos = inlined.call.pos
 
       /** Removes all Inlined trees, replacing them with blocks.
@@ -166,7 +165,8 @@ object Inliner {
               val transformed = super.transform(tree)
               enclosingInlineds match {
                 case call :: _ if call.symbol.sourceFile != ctx.owner.sourceFile =>
-                  // reposition tree inlined from some other file
+                  // Until we implement JSR-45, we cannot represent in output positions in other source files.
+                  // So, reposition inlined code from other files with the call position:
                   transformed.withPos(inlinedAtPos)
                 case _ => transformed
               }