Add versioning information for packages and the SDK.

pkg/docgen/lib/src/generator.dart

 // Copyright (c) 2014, 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.
 
 library docgen.generator;
 
 import 'dart:async';
 import 'dart:collection';
 import 'dart:convert';
 import 'dart:io';
 
 import 'package:markdown/markdown.dart' as markdown;
 import 'package:path/path.dart' as path;
 
 import '../../../../sdk/lib/_internal/compiler/compiler.dart' as api;
 import '../../../../sdk/lib/_internal/compiler/implementation/filenames.dart';
 import '../../../../sdk/lib/_internal/compiler/implementation/mirrors/analyze.dart'
     as dart2js;
 import '../../../../sdk/lib/_internal/compiler/implementation/source_file_provider.dart';
 
 import 'exports/dart2js_mirrors.dart' as dart2js_mirrors;
 import 'exports/libraries.dart';
 import 'exports/mirrors_util.dart' as dart2js_util;
 import 'exports/source_mirrors.dart';
 
 import 'io.dart';
 import 'library_helpers.dart';
 import 'models.dart';
-import 'package_helpers.dart' show packageNameFor, rootDirectory;
+import 'package_helpers.dart';
 
 const String DEFAULT_OUTPUT_DIRECTORY = 'docs';
 
 /// The directory where the output docs are generated.
 String get outputDirectory => _outputDirectory;
 String _outputDirectory;
 
 /// Library names to explicitly exclude.
 ///
 ///   Set from the command line option
@@ skipping 156 matching lines @@
       }
     }
   }
 
   // Outputs a JSON file with all libraries and their preview comments.
   // This will help the viewer know what libraries are available to read in.
   Map<String, dynamic> libraryMap = {
       'libraries': filteredEntities.where((e) => e is Library).map((e) =>
           e.previewMap).toList(),
       'introduction': _readIntroductionFile(introFileName, includeSdk),
-      'filetype': 'json'
+      'filetype': 'json',
+      'sdkVersion': packageVersion(coreLibrary.mirror)
     };
 
   var encoder = new JsonEncoder.withIndent(indentJson ? '  ' : null);
 
   _writeOutputFiles(libraryMap, filteredEntities, startPage, encoder);
 }
 
 /// Output all of the libraries and classes into json files for consumption by a
 /// viewer.
 void _writeOutputFiles(Map<String, dynamic> libraryMap, Iterable<Indexable>
@@ skipping 71 matching lines @@
 /// For this run of docgen, determine the packageRoot value.
 ///
 /// If packageRoot is not explicitly passed, we examine the files we're
 /// documenting to attempt to find a package root.
 String _obtainPackageRoot(String packageRoot, bool parseSdk,
     List<String> files) {
   if (packageRoot == null && !parseSdk) {
     var type = FileSystemEntity.typeSync(files.first);
     if (type == FileSystemEntityType.DIRECTORY) {
       var files2 = listDir(files.first, recursive: true);
-      // Return '' means that there was no pubspec.yaml and therefor no p
-      // ackageRoot.
+      // Return '' means that there was no pubspec.yaml and therefore no
+      // packageRoot.
       packageRoot = files2.firstWhere((f) => f.endsWith(
           '${path.separator}pubspec.yaml'), orElse: () => '');
       if (packageRoot != '') {
         packageRoot = path.join(path.dirname(packageRoot), 'packages');
       }
     } else if (type == FileSystemEntityType.FILE) {
       logger.warning('WARNING: No package root defined. If Docgen fails, try '
           'again by setting the --package-root option.');
     }
   }
@@ skipping 152 matching lines @@
   * [Samples](http://www.dartlang.org/samples/)
   * [A Tour of the Dart Libraries](http://www.dartlang.org/docs/dart-up-and-running/contents/ch03.html)
 
 This API reference is automatically generated from the source code in the
 [Dart project](https://code.google.com/p/dart/).
 If you'd like to contribute to this documentation, see
 [Contributing](https://code.google.com/p/dart/wiki/Contributing)
 and
 [Writing API Documentation](https://code.google.com/p/dart/wiki/WritingApiDocumentation).
 """;