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(); |
- } |
-} |