Get dartdoc in the SDK and working correctly.

lib/dartdoc/dartdoc.dart

-// Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
+// Copyright (c) 2012, 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.
 
 /**
  * To use it, from this directory, run:
  *
  *     $ ./dartdoc <path to .dart file>
  *
  * This will create a "docs" directory with the docs for your libraries. To
  * create these beautiful docs, dartdoc parses your library and every library
@@ skipping 32 matching lines @@
  * This dramatically reduces the generated size of the HTML since a large
  * fraction of each static page is just redundant navigation links.
  *
  * In this mode, the browser will do a XHR for nav.json which means that to
  * preview docs locally, you will need to enable requesting file:// links in
  * your browser or run a little local server like `python -m SimpleHTTPServer`.
  */
 final MODE_LIVE_NAV = 1;
 
 /**
- * Run this from the `utils/dartdoc` directory.
+ * Run this from the `lib/dartdoc` directory.
  */
 void main() {
   final args = new Options().arguments;
 
   // The entrypoint of the library to generate docs for.
   final entrypoint = args[args.length - 1];
 
   // Parse the dartdoc options.
   bool includeSource = true;
   var mode = MODE_LIVE_NAV;
@@ skipping 12 matching lines @@
       case '--mode=live-nav':
         mode = MODE_LIVE_NAV;
         break;
 
       default:
         print('Unknown option: $arg');
     }
   }
 
   final files = new VMFileSystem();
+  // TODO(rnystrom): Note that the following line gets munged by create-sdk to
+  // work with the SDK's different file layout. If you change it here, make
+  // sure SDK builds still work.
   parseOptions('../../frog', ['', '', '--libdir=../../frog/lib'], files);
   initializeWorld(files);
 
   var dartdoc;
   final elapsed = time(() {
     dartdoc = new Dartdoc();
     dartdoc.includeSource = includeSource;
     dartdoc.mode = mode;
 
     dartdoc.document(entrypoint);
@@ skipping 1112 matching lines @@
 
     return new md.Element.text('code', name);
   }
 
   // TODO(rnystrom): Move into SourceSpan?
   int getSpanColumn(SourceSpan span) {
     final line = span.file.getLine(span.start);
     return span.file.getColumn(line, span.start);
   }
 }