Find a file
Parker Lougheed bcfab01e87 [meta] Cleanup API docs and clarify superseded annotation status
This CL standardizes some comment formats, adds a few missing doc comments, and updates a few others.

It also adds text to a few annotations indicating they are likely to be deprecated in a future release and what the migration path is.

Contributes to https://github.com/dart-lang/sdk/issues/54389

Change-Id: I4fc6d9767378b855a1ab2a1978747fbe18850605
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/342281
Reviewed-by: Samuel Rawlins <srawlins@google.com>
Auto-Submit: Parker Lougheed <parlough@gmail.com>
Commit-Queue: Samuel Rawlins <srawlins@google.com>
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
2024-01-10 02:10:36 +00:00
.dart_tool [infra] re-land work to auto-generate .dart_tool/package_config.json 2022-04-12 17:21:02 +00:00
.github Bump actions/stale from 8.0.0 to 9.0.0 2023-12-19 15:34:36 +00:00
benchmarks [benchmark] Utf8Decode chunked and polymorphic benchmark 2023-11-15 18:21:23 +00:00
build [Fuchsia] Remove product.experimental 2024-01-08 18:54:43 +00:00
docs [docs] minor cleanup of the docs/ directory 2023-11-15 20:06:51 +00:00
pkg [meta] Cleanup API docs and clarify superseded annotation status 2024-01-10 02:10:36 +00:00
runtime [vm] Don't create UnboxedConstantInstr(kUnboxedInt64) for RISCV32. 2024-01-09 20:44:38 +00:00
samples [gardening] Update samples/ffi/sqlite sdk constraint to ^3.0.0 to enable class modifiers 2023-11-03 08:39:48 +00:00
sdk [doc/async] Remove excessive statement from Timer.periodic() documentation 2024-01-09 09:10:44 +00:00
tests [vm] Remove dual mapping of code 2024-01-09 12:36:55 +00:00
third_party [dap] Move dap to third_party 2024-01-09 10:45:30 +00:00
tools [infra] Disable Goma by default on Linux. 2024-01-09 11:44:28 +00:00
utils [vm] Don't create UnboxedConstantInstr(kUnboxedInt64) for RISCV32. 2024-01-09 20:44:38 +00:00
.clang-format
.gitattributes Remove the legacy "_2" tests. \o/ 2023-11-17 20:17:23 +00:00
.gitconfig [infra] Add documentation to .gitconfig 2018-06-11 18:24:16 +00:00
.gitignore [tool] Bisection tool 2023-07-13 13:22:26 +00:00
.gn [build] Switch to Fuchsia core SDK. 2023-11-10 19:23:11 +00:00
.mailmap Fixed various typos in a lot of files 2022-07-25 12:21:59 +00:00
.style.yapf Mass format python with yapf 2019-08-05 20:34:31 +00:00
AUTHORS Simplify the license situation 2022-09-14 21:06:22 +00:00
BUILD.gn Reland "[ DDS ] Fix DDS AOT snapshot build rules" 2023-12-19 21:17:15 +00:00
CHANGELOG.md [dart:js_interop(_unsafe)] Add changelog entries for importModule and has 2024-01-06 01:03:28 +00:00
codereview.settings [infra] Default presubmits to use python3 2021-08-24 08:20:47 +00:00
CONTRIBUTING.md Update CONTRIBUTING.md 2023-11-20 09:29:37 +00:00
DEPS [deps] rev async, ecosystem, leak_tracker, markdown, native, protobuf, shelf, tools, webdev 2024-01-09 22:23:08 +00:00
LICENSE Update LICENSE 2021-04-08 07:57:10 +00:00
OWNERS Assign owners to each top level file. 2023-12-14 12:38:11 +00:00
PATENT_GRANT Rename patent file 2019-08-16 12:03:17 +00:00
PRESUBMIT.py presubmit: fix file path 2023-12-18 09:41:58 +00:00
README.dart-sdk Update README.dart-sdk for inclusion of AOT snapshots 2023-11-21 10:33:22 +00:00
README.md Update readme content 2023-12-18 15:30:58 +00:00
sdk.code-workspace [cleanup] Remove co19_2 and other references to _2 suites 2023-11-22 11:15:57 +00:00
sdk_args.gni Fix typos 2022-06-15 11:08:28 +00:00
SECURITY.md Add link to published advisories 2022-02-08 19:45:07 +00:00
WATCHLISTS [analyzer] Properly close analyzer WATCHLISTS entry 2023-12-10 18:02:25 +00:00

Dart

An approachable, portable, and productive language for high-quality apps on any platform

Dart is:

  • Approachable: Develop with a strongly typed programming language that is consistent, concise, and offers modern language features like null safety and patterns.

  • Portable: Compile to ARM, x64, or RISC-V machine code for mobile, desktop, and backend. Compile to JavaScript or WebAssembly for the web.

  • Productive: Make changes iteratively: use hot reload to see the result instantly in your running app. Diagnose app issues using DevTools.

Dart's flexible compiler technology lets you run Dart code in different ways, depending on your target platform and goals:

  • Dart Native: For programs targeting devices (mobile, desktop, server, and more), Dart Native includes both a Dart VM with JIT (just-in-time) compilation and an AOT (ahead-of-time) compiler for producing machine code.

  • Dart Web: For programs targeting the web, Dart Web includes both a development time compiler (dartdevc) and a production time compiler (dart2js).

Dart platforms illustration

License & patents

Dart is free and open source.

See LICENSE and PATENT_GRANT.

Using Dart

Visit dart.dev to learn more about the language, tools, and to find codelabs.

Browse pub.dev for more packages and libraries contributed by the community and the Dart team.

Our API reference documentation is published at api.dart.dev, based on the stable release. (We also publish docs from our beta and dev channels, as well as from the primary development branch).

Building Dart

If you want to build Dart yourself, here is a guide to getting the source, preparing your machine to build the SDK, and building.

There are more documents on our wiki.

Contributing to Dart

The easiest way to contribute to Dart is to file issues.

You can also contribute patches, as described in Contributing.