Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(45)

Unified Diff: pkg/dartdoc/comment_map.dart

Issue 10919260: Reorganize dartdoc to new package layout. (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart
Patch Set: Created 8 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « pkg/dartdoc/client-static.dart ('k') | pkg/dartdoc/dartdoc.dart » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: pkg/dartdoc/comment_map.dart
diff --git a/pkg/dartdoc/comment_map.dart b/pkg/dartdoc/comment_map.dart
deleted file mode 100644
index d86a71a79c1b9e35b7654248207f6443708c0340..0000000000000000000000000000000000000000
--- a/pkg/dartdoc/comment_map.dart
+++ /dev/null
@@ -1,118 +0,0 @@
-// 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.
-
-/**
- * The cached lookup-table to associate doc comments with spans. The outer map
- * is from filenames to doc comments in that file. The inner map maps from the
- * token positions to doc comments. Each position is the starting offset of the
- * next non-comment token *following* the doc comment. For example, the position
- * for this comment would be the position of the "class" token below.
- */
-class CommentMap {
- /**
- * Maps from (filename, pos) to doc comment preceding the token at that
- * position.
- */
- Map<String, Map<int, String>> _comments;
-
- /** Doc comments before #library() directives. */
- Map<String, String> _libraryComments;
-
- CommentMap()
- : _comments = <String, Map<int, String>>{},
- _libraryComments = <String, String>{};
-
- /** Finds the doc comment preceding the given source span, if there is one. */
- String find(Location span) {
- if (span == null) return null;
-
- _ensureFileParsed(span.source);
- final comment = _comments[span.source.uri.toString()][span.start];
- if (comment == null) return '';
- return comment;
- }
-
- /**
- * Finds the doc comment associated with the `#library` directive for the
- * given file.
- */
- String findLibrary(Source source) {
- _ensureFileParsed(source);
- final comment = _libraryComments[source.uri.toString()];
- if (comment == null) return '';
- return comment;
- }
-
- _ensureFileParsed(Source source) {
- _comments.putIfAbsent(source.uri.toString(), () =>
- _parseComments(source));
- }
-
- _parseComments(Source source) {
- final comments = new Map<int, String>();
-
- final scanner = new dart2js.StringScanner(source.text, true);
- var lastComment = null;
-
- var token = scanner.tokenize();
- while (token.kind != dart2js.EOF_TOKEN) {
- if (token.kind == dart2js.COMMENT_TOKEN) {
- final text = token.slowToString();
- if (text.startsWith('/**')) {
- // Remember that we've encountered a doc comment.
- lastComment = stripComment(token.slowToString());
- } else if (text.startsWith('///')) {
- var line = text.substring(3);
- // Allow a leading space.
- if (line.startsWith(' ')) line = line.substring(1);
- if (lastComment == null) {
- lastComment = line;
- } else {
- lastComment = '$lastComment$line';
- }
- }
- } else if (token.kind == dart2js.HASH_TOKEN) {
- // Look for #library() to find the library comment.
- final next = token.next;
- if ((lastComment != null) && (next.stringValue == 'library')) {
- _libraryComments[source.uri.toString()] = lastComment;
- lastComment = null;
- }
- } else if (lastComment != null) {
- // We haven't attached the last doc comment to something yet, so stick
- // it to this token.
- comments[token.charOffset] = lastComment;
- lastComment = null;
- }
- token = token.next;
- }
-
- return comments;
- }
-
- /**
- * Pulls the raw text out of a doc comment (i.e. removes the comment
- * characters).
- */
- stripComment(String comment) {
- StringBuffer buf = new StringBuffer();
-
- for (var line in comment.split('\n')) {
- line = line.trim();
- if (line.startsWith('/**')) line = line.substring(3);
- if (line.endsWith('*/')) line = line.substring(0, line.length - 2);
- line = line.trim();
- if (line.startsWith('* ')) {
- line = line.substring(2);
- } else if (line.startsWith('*')) {
- line = line.substring(1);
- }
-
- buf.add(line);
- buf.add('\n');
- }
-
- return buf.toString();
- }
-}
« no previous file with comments | « pkg/dartdoc/client-static.dart ('k') | pkg/dartdoc/dartdoc.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698