Skip to content

dart doc prints a warnings #3779

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
mit-mit opened this issue Jun 3, 2024 · 2 comments · Fixed by #3782
Closed

dart doc prints a warnings #3779

mit-mit opened this issue Jun 3, 2024 · 2 comments · Fixed by #3782
Labels
P1 A high priority bug; for example, a single project is unusable or has many test failures type-bug Incorrect behavior (everything from a crash to more subtle misbehavior)

Comments

@mit-mit
Copy link
Member

mit-mit commented Jun 3, 2024

When running dart doc with a recent dev channel build (3.5.0-191), I get the warning The '--resources-dir' option is deprecated, and will soon be removed.

Full output:

mit-macbookpro8:~ mit$ dart --version
Dart SDK version: 3.5.0-191.0.dev (dev) (Fri May 24 13:02:57 2024 -0700) on "macos_arm64"

mit-macbookpro8:tmp mit$ dart create -t package mypkg
Creating mypkg using template package...

...

mit-macbookpro8:tmp mit$ cd mypkg

mit-macbookpro8:mypkg mit$ dart doc
Documenting mypkg...
Discovering libraries...
[---------------------------------------------------------------------------------------------------------] (100.00%)

Linking elements...
[---------------------------------------------------------------------------------------------------------] (100.00%)

Precaching local docs for 136909 elements...
[---------------------------------------------------------------------------------------------------------] (100.00%)

Initialized dartdoc with 48 libraries
  warning: deprecated dartdoc usage: The '--resources-dir' option is deprecated, and will soon be removed.
    from package-mypkg: file:///Users/mit/tmp/mypkg
Generating docs for library mypkg.dart from package:mypkg/mypkg.dart...
Found 1 warning and 0 errors.
Documented 1 public library in 9.4 seconds
Success! Docs generated into /Users/mit/tmp/mypkg/doc/api
@mit-mit
Copy link
Member Author

mit-mit commented Jun 3, 2024

cc @srawlins

@srawlins
Copy link
Member

srawlins commented Jun 5, 2024

Hmm I think this flag was deprecated in err. I can revert the deprecation.

@srawlins srawlins added type-bug Incorrect behavior (everything from a crash to more subtle misbehavior) P1 A high priority bug; for example, a single project is unusable or has many test failures labels Jun 5, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
P1 A high priority bug; for example, a single project is unusable or has many test failures type-bug Incorrect behavior (everything from a crash to more subtle misbehavior)
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants