bcfab01e87
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>