Add versioning information for packages and the SDK.

pkg/docgen/lib/src/library_helpers.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.library_helpers;
 
 import 'package:logging/logging.dart';
 import 'package:markdown/markdown.dart' as markdown;
 
 import 'exports/source_mirrors.dart';
@@ skipping 28 matching lines @@
 bool isFullChainVisible(Indexable item) {
   return includePrivateMembers || (!item.isPrivate && (item.owner != null ?
       isFullChainVisible(item.owner) : true));
 }
 
 /// Logger for printing out progress of documentation generation.
 final Logger logger = new Logger('Docgen');
 
 /// The dart:core library, which contains all types that are always available
 /// without import.
-Library _coreLibrary;
+Library coreLibrary;
 
 /// Set of libraries declared in the SDK, so libraries that can be accessed
 /// when running dart by default.
 Iterable<LibraryMirror> get sdkLibraries => _sdkLibraries;
 Iterable<LibraryMirror> _sdkLibraries;
 
 ////// Top level resolution functions
 /// Converts all [foo] references in comments to <a>libraryName.foo</a>.
 markdown.Node globalFixReference(String name) {
   // Attempt the look up the whole name up in the scope.
@@ skipping 35 matching lines @@
     if (!added) {
       accumulatedHtml += token;
     }
   }
   return new markdown.Text(accumulatedHtml);
 }
 
 String findElementInScopeWithPrefix(String name, String packagePrefix) {
   var lookupFunc = determineLookupFunc(name);
   // Look in the dart core library scope.
-  var coreScope = _coreLibrary == null ? null : lookupFunc(_coreLibrary.mirror,
+  var coreScope = coreLibrary == null ? null : lookupFunc(coreLibrary.mirror,
       name);
-  if (coreScope != null) return packagePrefix + _coreLibrary.docName;
+  if (coreScope != null) return packagePrefix + coreLibrary.docName;
 
   // If it's a reference that starts with a another library name, then it
   // looks for a match of that library name in the other sdk libraries.
   if (name.contains('.')) {
     var index = name.indexOf('.');
     var libraryName = name.substring(0, index);
     var remainingName = name.substring(index + 1);
     foundLibraryName(library) => library.uri.pathSegments[0] == libraryName;
 
     if (_sdkLibraries.any(foundLibraryName)) {
@@ skipping 24 matching lines @@
   Map<String, Indexable> docgenObj = lookupIndexableMap(mirror);
 
   if (docgenObj == null) {
     return new DummyMirror(mirror, owner);
   }
 
   var setToExamine = new Set();
   if (owner != null) {
     var firstSet = docgenObj[owner.docName];
     if (firstSet != null) setToExamine.add(firstSet);
-    if (_coreLibrary != null && docgenObj[_coreLibrary.docName] != null) {
-      setToExamine.add(docgenObj[_coreLibrary.docName]);
+    if (coreLibrary != null && docgenObj[coreLibrary.docName] != null) {
+      setToExamine.add(docgenObj[coreLibrary.docName]);
     }
   } else {
     setToExamine.addAll(docgenObj.values);
   }
 
   Set<Indexable> results = new Set<Indexable>();
   for (Indexable indexable in setToExamine) {
     if (indexable.mirror.qualifiedName == mirror.qualifiedName &&
         indexable.isValidMirror(mirror)) {
       results.add(indexable);
     }
   }
 
   if (results.length > 0) {
     // This might occur if we didn't specify an "owner."
     return results.first;
   }
   return new DummyMirror(mirror, owner);
 }
 
 void initializeTopLevelLibraries(MirrorSystem mirrorSystem) {
   _sdkLibraries = mirrorSystem.libraries.values.where(
       (each) => each.uri.scheme == 'dart');
-  _coreLibrary = new Library(_sdkLibraries.singleWhere((lib) =>
+  coreLibrary = new Library(_sdkLibraries.singleWhere((lib) =>
       lib.uri.toString().startsWith('dart:core')));
 }
 
 /// For a given name, determine if we need to resolve it as a qualified name
 /// or a simple name in the source mirors.
 LookupFunction determineLookupFunc(String name) => name.contains('.') ?
   dart2js_util.lookupQualifiedInScope :
     (mirror, name) => mirror.lookupInScope(name);
 
 /// Chunk the provided name into individual parts to be resolved. We take a
@@ skipping 23 matching lines @@
         append = true;
       }
       index++;
     }
   }
   return tokens;
 }
 
 // HTML escaped version of '<' character.
 const _LESS_THAN = '&lt;';