Dartdoc: विस्तार विधियों के भीतर संदर्भ लिंक लागू नहीं किए गए हैं

को निर्मित 3 अक्तू॰ 2019 · 12टिप्पणियाँ · स्रोत: dart-lang/dartdoc

जैसे पुस्तकालय दिया गया है:

extension Foo on String {
  /// Print this and [another].
  void doStuff(String another) {
    print(this + another);
  }
}

रनिंग डार्ट डॉक क्रैश। अगर मैं [another] हटा दूं तो ऐसा नहीं होगा। जब यह संदर्भ को हल करने का प्रयास करता है तो एक प्रकार की त्रुटि होती है।

dartdoc failed: type 'Extension' is not a subtype of type 'Class'
package:dartdoc/src/markdown_processor.dart 209:66            _getMatchingLinkElement
package:dartdoc/src/markdown_processor.dart 758:12            _linkDocReference
package:dartdoc/src/markdown_processor.dart 1006:22           Documentation._renderMarkdownToHtml._linkResolver
package:markdown/src/inline_parser.dart 720:14                LinkSyntax._resolveReferenceLink
package:markdown/src/inline_parser.dart 742:9                 LinkSyntax._tryAddReferenceLink
package:markdown/src/inline_parser.dart 692:12                LinkSyntax.onMatchEnd
package:markdown/src/inline_parser.dart 1216:16               TagState.close
package:markdown/src/inline_parser.dart 1155:7                TagState.tryMatch
package:markdown/src/inline_parser.dart 106:57                InlineParser.parse.<fn>
dart:_internal                                                ListIterable.any
package:markdown/src/inline_parser.dart 106:12                InlineParser.parse
package:dartdoc/src/markdown_processor.dart 903:53            MarkdownDocument._parseInlineContent
package:dartdoc/src/markdown_processor.dart 908:9             MarkdownDocument._parseInlineContent
package:dartdoc/src/markdown_processor.dart 928:5             MarkdownDocument.renderLinesToHtml
package:dartdoc/src/markdown_processor.dart 1016:21           Documentation._renderMarkdownToHtml
package:dartdoc/src/markdown_processor.dart 986:9             Documentation._renderHtmlForDartdoc
package:dartdoc/src/markdown_processor.dart 977:7             Documentation.asOneLiner
package:dartdoc/src/model.dart 3901:25                        ModelElement.computeOneLineDoc
package:dartdoc/src/model.dart 3907:21                        ModelElement.oneLineDoc
dart:mirrors                                                  _InstanceMirror.getField
package:mustache/src/renderer.dart 245:29                     Renderer._getNamedProperty
package:mustache/src/renderer.dart 212:16                     Renderer.resolveValue
package:mustache/src/renderer.dart 90:17                      Renderer.visitVariable
package:mustache/src/node.dart 45:43                          VariableNode.accept
package:mustache/src/renderer.dart 64:53                      Renderer.render.<fn>
dart:_internal                                                ListIterable.forEach
package:mustache/src/renderer.dart 64:36                      Renderer.render
package:mustache/src/renderer.dart 195:16                     Renderer.visitPartial
package:mustache/src/node.dart 81:43                          PartialNode.accept
package:mustache/src/node.dart 66:37                          SectionNode.visitChildren.<fn>
dart:core                                                     List.forEach
package:mustache/src/node.dart 66:14                          SectionNode.visitChildren
package:mustache/src/renderer.dart 184:10                     Renderer._renderWithValue
package:mustache/src/renderer.dart 126:28                     Renderer._renderSection.<fn>
dart:core                                                     Iterable.forEach
package:mustache/src/renderer.dart 126:13                     Renderer._renderSection
package:mustache/src/renderer.dart 115:7                      Renderer.visitSection
package:mustache/src/node.dart 63:43                          SectionNode.accept
package:mustache/src/node.dart 66:37                          SectionNode.visitChildren.<fn>
dart:core                                                     List.forEach
package:mustache/src/node.dart 66:14                          SectionNode.visitChildren
package:mustache/src/renderer.dart 184:10                     Renderer._renderWithValue
package:mustache/src/renderer.dart 130:7                      Renderer._renderSection
package:mustache/src/renderer.dart 115:7                      Renderer.visitSection
package:mustache/src/node.dart 63:43                          SectionNode.accept
package:mustache/src/node.dart 66:37                          SectionNode.visitChildren.<fn>
dart:core                                                     List.forEach
package:mustache/src/node.dart 66:14                          SectionNode.visitChildren
package:mustache/src/renderer.dart 184:10                     Renderer._renderWithValue
package:mustache/src/renderer.dart 144:7                      Renderer._renderSection
package:mustache/src/renderer.dart 115:7                      Renderer.visitSection
package:mustache/src/node.dart 63:43                          SectionNode.accept
package:mustache/src/renderer.dart 58:30                      Renderer.render.<fn>
dart:core                                                     List.forEach
package:mustache/src/renderer.dart 58:13                      Renderer.render
package:mustache/src/template.dart 40:14                      Template.render
package:mustache/src/template.dart 33:5                       Template.renderString
package:dartdoc/src/html/html_generator_instance.dart 414:31  HtmlGeneratorInstance._build
package:dartdoc/src/html/html_generator_instance.dart 312:5   HtmlGeneratorInstance.generateExtension
package:dartdoc/src/html/html_generator_instance.dart 175:11  HtmlGeneratorInstance._generateDocs
package:dartdoc/src/html/html_generator_instance.dart 37:7    HtmlGeneratorInstance.generate
dart:async                                                    _AsyncAwaitCompleter.start
package:dartdoc/src/html/html_generator_instance.dart 35:18   HtmlGeneratorInstance.generate
package:dartdoc/src/html/html_generator.dart 117:23           HtmlGenerator.generate
dart:async                                                    _AsyncAwaitCompleter.start
package:dartdoc/src/html/html_generator.dart 83:18            HtmlGenerator.generate
package:dartdoc/dartdoc.dart 107:25                           Dartdoc.generateDocsBase
dart:async                                                    _completeOnAsyncReturn
package:dartdoc/src/model.dart                                PackageBuilder.buildPackageGraph

P1 bug

स्रोत

natebosch

👍2

सबसे उपयोगी टिप्पणी

टिप्पणी संदर्भ लुकअप के पुनर्लेखन और कार्यान्वयन की शुरुआत के लिए एक डिज़ाइन है, लेकिन, एक बड़ा टुकड़ा होने के कारण, यह अन्य नए फीचर काम के पीछे पटकता रहता है।

jcollins-g 19 फ़र॰ 2021

👍2

सभी 12 टिप्पणियाँ

एक्सटेंशन विधियों के लिंक के समाधान के आसपास कुछ लापता मामले प्रतीत होते हैं। इन्हें जोड़ने का प्रयास करेंगे।

jcollins-g 8 अक्तू॰ 2019

ऐसा लगता है कि ज्यादातर मामलों में जहां हम एक विस्तार विधि का जिक्र कर रहे हैं या दस्तावेज़ीकरण संदर्भ के माध्यम से इसके पैरामीटर लागू नहीं किए गए हैं, और जोखिम क्रैश हो गया है। बग को P0 तक बढ़ाना।

jcollins-g 8 अक्तू॰ 2019

@ jcollins-g यह D26 के लिए एक अवरोधक हो सकता है, क्योंकि हमारे सभी उपकरणों को विस्तार विधियों और मुख्य पुस्तकालयों का समर्थन करने की आवश्यकता है, विशेष रूप से dart:ffi अब विस्तार विधियों का उपयोग कर रहे हैं (जिसके लिए dartdoc विफल रहता है)

mkustermann 9 अक्तू॰ 2019

यह केवल विस्तार सदस्यों के संदर्भ में नहीं प्रतीत होता है, बल्कि इस तरह के दस्तावेज़ीकरण में कोई संदर्भ है।
दोनों:

extension Foo on int {
  /// Returns [toRadixString] or something.
  String toHexString() => toRadixString(16);
}

तथा

extension Foo on int {
  /// Returns [int.toRadixString] or something.
  String toHexString() => toRadixString(16);
}

दुर्घटना। न तो किसी एक्सटेंशन सदस्य का संदर्भ लें, लेकिन इसे एक्सटेंशन के संदर्भ में अपेक्षाकृत एक पहचानकर्ता को हल करना होगा।

lrhn 10 अक्तू॰ 2019

हां, विस्तार विधियों में संदर्भों को शामिल करने वाली हर चीज अभी टूटी हुई है। आज मेरे पास इसे ठीक करने के लिए एक पीआर होगा जिसे अभी तक लागू नहीं किया गया है।

jcollins-g 11 अक्तू॰ 2019

2040 इसे खत्म कर देता है, लेकिन हमें अभी भी वास्तविक कार्यान्वयन की आवश्यकता है।

jcollins-g 14 अक्तू॰ 2019

jcollins-g 19 फ़र॰ 2021

👍2

किसी भी मौके पर हमारे पास एक अस्थायी बैंडएड हो सकता है जो सिर्फ चेतावनी को शांत करता है? मैं फ़्लटर कोडबेस के लिए एक विस्तार विधि करना चाहता हूं और यह बग ऐसा करना असंभव बनाता है (क्योंकि हमें हर चीज पर दस्तावेज़ीकरण की भी आवश्यकता होती है)। (विडंबना यह है कि हम आम तौर पर विस्तार विधियों को अस्वीकार करते हैं, इसलिए यह सामान्य रूप से कोई फर्क नहीं पड़ता लेकिन इस मामले में यह विशेष रूप से एक बहिष्करण माइग्रेशन सहायता है ...)

Hixie 17 मार्च 2021

किसी भी मौके पर हमारे पास एक अस्थायी बैंडएड हो सकता है जो सिर्फ चेतावनी को शांत करता है? मैं फ़्लटर कोडबेस के लिए एक विस्तार विधि करना चाहता हूं और यह बग ऐसा करना असंभव बनाता है (क्योंकि हमें हर चीज पर दस्तावेज़ीकरण की भी आवश्यकता होती है)। (विडंबना यह है कि हम आम तौर पर विस्तार विधियों को अस्वीकार करते हैं, इसलिए यह सामान्य रूप से कोई फर्क नहीं पड़ता लेकिन इस मामले में यह विशेष रूप से एक बहिष्करण माइग्रेशन सहायता है ...)

चेतावनी को शांत करने के लिए, आप dartdoc में "लागू नहीं की गई" चेतावनी को अक्षम कर सकते हैं। अभी इस समस्या के लिए इसका उपयोग किया जाता है।

jcollins-g 17 मार्च 2021

आह कमाल, धन्यवाद।

Hixie 17 मार्च 2021

यह काम नहीं किया क्योंकि हाइपरलिंक स्वयं अभी भी हल नहीं हुए हैं। :-) वैसे भी मैं अभी के लिए हाइपरलिंक्स को हटा दूँगा।

Hixie 18 मार्च 2021

यह अब dartdoc 1.0.0 में तय किया गया है।

jcollins-g 30 जून 2021

क्या यह पृष्ठ उपयोगी था?

0 / 5 - 0 रेटिंग्स

Dartdoc: विस्तार विधियों के भीतर संदर्भ लिंक लागू नहीं किए गए हैं

सबसे उपयोगी टिप्पणी

सभी 12 टिप्पणियाँ

2040 इसे खत्म कर देता है, लेकिन हमें अभी भी वास्तविक कार्यान्वयन की आवश्यकता है।

संबंधित मुद्दों