| OLD | NEW |
| 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 /// **docgen** is a tool for creating machine readable representations of Dart | 5 /// **docgen** is a tool for creating machine readable representations of Dart |
| 6 /// code metadata, including: classes, members, comments and annotations. | 6 /// code metadata, including: classes, members, comments and annotations. |
| 7 /// | 7 /// |
| 8 /// docgen is run on a `.dart` file or a directory containing `.dart` files. | 8 /// docgen is run on a `.dart` file or a directory containing `.dart` files. |
| 9 /// | 9 /// |
| 10 /// $ dart docgen.dart [OPTIONS] [FILE/DIR] | 10 /// $ dart docgen.dart [OPTIONS] [FILE/DIR] |
| (...skipping 20 matching lines...) Expand all Loading... |
| 31 import '../../../sdk/lib/_internal/compiler/implementation/mirrors/mirrors.dart'
; | 31 import '../../../sdk/lib/_internal/compiler/implementation/mirrors/mirrors.dart'
; |
| 32 import '../../../sdk/lib/_internal/compiler/implementation/source_file_provider.
dart'; | 32 import '../../../sdk/lib/_internal/compiler/implementation/source_file_provider.
dart'; |
| 33 import '../../../sdk/lib/_internal/libraries.dart'; | 33 import '../../../sdk/lib/_internal/libraries.dart'; |
| 34 | 34 |
| 35 var logger = new Logger('Docgen'); | 35 var logger = new Logger('Docgen'); |
| 36 | 36 |
| 37 const String USAGE = 'Usage: dart docgen.dart [OPTIONS] fooDir/barFile'; | 37 const String USAGE = 'Usage: dart docgen.dart [OPTIONS] fooDir/barFile'; |
| 38 | 38 |
| 39 | 39 |
| 40 List<String> skippedAnnotations = const [ | 40 List<String> skippedAnnotations = const [ |
| 41 'metadata.DocsEditable', 'metadata.DomName']; | 41 'metadata.DocsEditable', '_js_helper.JSName', '_js_helper.Creates', |
| 42 '_js_helper.Returns', 'observe-src-metadata.Reflectable']; |
| 42 | 43 |
| 43 /// Current library being documented to be used for comment links. | 44 /// Current library being documented to be used for comment links. |
| 44 LibraryMirror _currentLibrary; | 45 LibraryMirror _currentLibrary; |
| 45 | 46 |
| 46 /// Current class being documented to be used for comment links. | 47 /// Current class being documented to be used for comment links. |
| 47 ClassMirror _currentClass; | 48 ClassMirror _currentClass; |
| 48 | 49 |
| 49 /// Current member being documented to be used for comment links. | 50 /// Current member being documented to be used for comment links. |
| 50 MemberMirror _currentMember; | 51 MemberMirror _currentMember; |
| 51 | 52 |
| (...skipping 1183 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 1235 String docName(DeclarationMirror m) { | 1236 String docName(DeclarationMirror m) { |
| 1236 if (m is LibraryMirror) { | 1237 if (m is LibraryMirror) { |
| 1237 return (m as LibraryMirror).qualifiedName.replaceAll('.','-'); | 1238 return (m as LibraryMirror).qualifiedName.replaceAll('.','-'); |
| 1238 } | 1239 } |
| 1239 var owner = m.owner; | 1240 var owner = m.owner; |
| 1240 if (owner == null) return m.qualifiedName; | 1241 if (owner == null) return m.qualifiedName; |
| 1241 // For the unnamed constructor we just return the class name. | 1242 // For the unnamed constructor we just return the class name. |
| 1242 if (m.simpleName == '') return docName(owner); | 1243 if (m.simpleName == '') return docName(owner); |
| 1243 return docName(owner) + '.' + m.simpleName; | 1244 return docName(owner) + '.' + m.simpleName; |
| 1244 } | 1245 } |
| OLD | NEW |