Deprecate the source_maps span classes.

pkg/source_maps/lib/refactor.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 /// Tools to help implement refactoring like transformations to Dart code.
 ///
 /// [TextEditTransaction] supports making a series of changes to a text buffer.
 /// [guessIndent] helps to guess the appropriate indentiation for the new code.
 library source_maps.refactor;
 
 import 'span.dart';
 import 'printer.dart';
+import 'src/span_wrapper.dart';
 
 /// Editable text transaction.
 ///
 /// Applies a series of edits using original location
 /// information, and composes them into the edited string.
 class TextEditTransaction {

[Siggi Cherem (dart-lang), 2014/07/18 01:40:53]

FYI - I'd like to move this file to code_transformers. Should we do it as part
of the deprecation of 0.10.0, or later?

[nweiz, 2014/07/23 23:17:18]

Sure; I'll leave the version number as 0.9.4-dev, and you can deprecate anything
else you want deprecated before you kick out a release.

   final SourceFile file;
   final String original;
   final _edits = <_TextEdit>[];
 
-  TextEditTransaction(this.original, this.file);
+  /// Creates a new transaction.
+  ///
+  /// [file] can be either a `source_map` [SourceFile] or a `source_span`
+  /// `SourceFile`. Using a `source_map` [SourceFile] is deprecated and will be
+  /// unsupported in version 0.10.0.
+  TextEditTransaction(this.original, file)
+      : file = SourceFileWrapper.wrap(file);
 
   bool get hasEdits => _edits.length > 0;
 
   /// Edit the original text, replacing text on the range [begin] and [end]
   /// with the [replacement]. [replacement] can be either a string or a
   /// [NestedPrinter].
   void edit(int begin, int end, replacement) {
     _edits.add(new _TextEdit(begin, end, replacement));
   }
 
@@ skipping 88 matching lines @@
     }
   }
 
   return code.substring(lineStart, whitespaceEnd);
 }
 
 const int _CR = 13;
 const int _LF = 10;
 const int _TAB = 9;
 const int _SPACE = 32;