Skip to content

Releases: dart-lang/dartdoc

v0.43.0

12 May 16:21
e6a9b7c
Compare
Choose a tag to compare
  • Add experimental lookup code for comment references eventually
    destined to replace most of lib/src/markdown_processor.dart. Most
    of this work is disabled by default but does impact internal APIs.
    (#2637, #2634, #2630, #2622)
  • Fix duplicate nullability suffix in some cases with markdown output.
    (#2632)
  • Update analyzer requirement to 1.5.0 and fix/allow experimental
    features in 2.14. (#2625, #2618)
  • Improvement to browser search, making browser find prioritize the
    main text area. (#2621)
  • BREAKING CHANGE: hasDisplayedCategories replaced with
    hasCategoryNames. (#2614)
  • Fix the public mixins link in the category sidebar. (#2613)
  • Do not show late fields as 'read/write'. (#2608)
  • Print version information when an exception is encountered. (#2607)
  • A number of minor, internal cleanups.

v0.42.0

05 Apr 15:45
505f163
Compare
Choose a tag to compare
  • Add some tests and verify basic support for triple-shift, and check
    to be sure that using the function as type parameter feature does not crash
    dartdoc (#2518, #2517, #2603).
  • BREAKING CHANGE: Refactor of dartdoc features and annotations. Use
    hasFeatures in templates in place of checking featuresAsString as a
    boolean (#2600), and linkedNameWithParameters for getting rendered
    annotations (#2605).
  • Implement generic type parameters on annotations. (#2600, #2516).
  • No longer depend on mustache. (#2596)
  • BREAKING CHANGE: Replace mustache with mustachio. Use asCallable instead
    of hasCallable in templates to handle casts correctly. (#2564)

v0.41.0

29 Mar 19:49
e2d010e
Compare
Choose a tag to compare
  • Write out doc files for static methods on extensions. (#2588, #2591)
  • Fix a crash where dartdoc tried to create a duplicate field in the event
    a static const extension member is declared. (#2585)
  • Implementation of generic type aliases. (#2584, #2575, #2558)
  • BREAKING CHANGE: Refactors to better support new type handling.
    With #2573 and changes building on it, linkedReturnType must be changed
    to either modelType or modelType.returnType in templates. (#2583, #2573)
  • Add an option for setting arguments for tool compilation. (#2576)
  • Make signature of categoriesWithPublicLibraries more accurate. (#2571)
  • Improve analysis performance by avoiding hints/lints when resolving
    files. (#2566)
  • Additional implementation for Mustachio. (#2568, #2555, #2554, #2549, #2547,
    #2546)
  • Update highlight.js to include plaintext support and optionally, warn if the
    user does not specify a language on code blocks. (#2560, #2559, #2593)
  • Fix invalid json generation on an empty categories list. (#2550)
  • Many minor internal cleanups related to new lints and ecosystem changes.

v0.40.0

25 Feb 20:45
174021f
Compare
Choose a tag to compare
  • More implementation added for Mustachio (#2481, #2482, #2488, #2491, #2497,
    #2498, #2512, #2515, #2519, #2523, #2525)
  • originalMember is now an optional parameter to ModelElement(). #2507
  • Use custom handling for search, deleting jquery/typeahead libraries. (#2486,
    #2483)
  • Small change to dartdoc exit/error text output. (#2489)
  • Fixed problem with stdout corruption in tool output due to null-safety
    warnings. (#2493)
  • Connect interface types across intermediate classes. (#2495, #2485)
  • Update analyzer to 1.0.0 (#2524) This version of dartdoc requires Dart 2.12
    as a result.
  • Many minor internal cleanups updating code to newer Dart style and idioms.

v0.39.0

14 Jan 17:39
9e61a4f
Compare
Choose a tag to compare
  • More implementation added for Mustachio. (#2452, #2458, #2467)
  • Use = to document values for named parameters. (#2453, #2087)
  • Add a link to the null safety feature indicator. (#2455)
  • Fixed a problem where searching by URL failed in SDK docs. (#2470)
  • Fix a regression where members were not being marked as inherited in
    sidebars (#2473, #2472).
  • Breaking change: Removed bootstrap CSS files. (#2460)
  • Breaking change: Removed the URI.js library. (#2471)
  • Update Highlight.js to 10.5.0, including better support for
    highlighting non-nullable code. (#2474)

v0.38.0

08 Dec 17:57
a1d86f2
Compare
Choose a tag to compare
  • Correctly handle intermediate abstract classes containing external
    implementations. (#2449, #2251)
  • More implementation added for Mustachio. (#2448, #2447, #2442)
  • Change analyzer minor version, updating to 0.41. (#2445)
  • Breaking change: Refactor sidebar handling to improve performance.
    Sidebar templates are now required to exist in custom sets, though
    you do not have to use them. See referred PR. (#2444)
  • Breaking change: Complete extraction of sorted methods used by
    templates. This moves sorting of elements closer to the presentation
    layer but requires renaming references in custom templates. See
    sed script example in referred PR. (#2443)
  • Fix missing null checks for YAML data. (#2441, #2378)
  • Give the correct exception for missing FLUTTER_ROOT even where pub get
    has already run. (#2440, #2407)
  • Internal change, prefer analyzer's InterfaceType.allSupertypes. (#2439)

v0.37.0

19 Nov 18:12
d79877d
Compare
Choose a tag to compare
  • Change scope for the dartdoc warning configuration to the library
    being documented rather than where the symbol was originally
    defined. (#2432, #2428)
  • Breaking change: Correct null dereference exception on unusual
    import URIs through change to PackageGraph.allLibraries. (#2429, #2426)
  • Adding (as yet unused) code for mustachio, a builder for mustache
    templates. (#2417, #2421, #2427, #2430, #2434).
  • Corrected a problem with tests erroneously passing in the grinder on
    latest SDK. (#2422, #2423, #2424)

v0.36.2

03 Nov 16:54
6935dcd
Compare
Choose a tag to compare
  • Tag Null safety only where the code is actually null safe. (#2411, #2403)
  • Infrastructure and minor cleanups. (#2414, #2413, #2412)

v0.36.1

22 Oct 15:00
72c69f8
Compare
Choose a tag to compare
  • Fix NPE in Accessor.computeDocumentationComment when encountering
    static fields in extension methods (#2402, #2404)

v0.36.0

20 Oct 17:08
39cec16
Compare
Choose a tag to compare
  • Fix problem with linking to non-canonical elements via documentation
    references. (#2397, #2389)
  • Allow for markdown 3.0.0. (#2394)
  • Breaking change: Behavior of --exclude-packages is changed so that
    packages so excluded will never be treated as "remote". This version is now
    incompatible with old workarounds for #1431 (and those workarounds are no
    longer needed). Also removes PackageGraph.packageDocumentedFor.
    (#2387, #2382, #1431)
  • Enable NNBD support by default in dartdoc. If a package is non-nullable,
    it will now be documented that way (with null safety tags). No change in
    behavior for packages that have not been migrated. (#2384)
  • Breaking change: Adjust interfaces for mustache and remove constant
    templates, including removing TemplateData.packageGraph. (#2375, #2373,
    #2379)
  • Internal type changes for upcoming analyzer 0.41 (#2380, #2392)
  • Breaking change: Remove typeParameters setter for ModelFunctionTyped and
    change Typedef inheritance (#2376)