mirror of
https://github.com/dart-lang/sdk
synced 2024-09-05 00:13:50 +00:00
![Janice Collins](/assets/img/avatar_default.png)
Borrowed the list of warnings directly from Flutter. Release notes: https://github.com/dart-lang/dartdoc/releases/tag/v1.0.0 Change-Id: Ic93229218a470c9ef469b89982dc2a3510d502da Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/205340 Reviewed-by: Devon Carew <devoncarew@google.com> Commit-Queue: Janice Collins <jcollins@google.com>
66 lines
1.8 KiB
Python
Executable file
66 lines
1.8 KiB
Python
Executable file
#!/usr/bin/env python3
|
|
# Copyright (c) 2019, the Dart project authors. Please see the AUTHORS file
|
|
# for details. All rights reserved. Use of this source code is governed by a
|
|
# BSD-style license that can be found in the LICENSE file.
|
|
|
|
import argparse
|
|
import sys
|
|
import utils
|
|
|
|
|
|
def ParseArgs(args):
|
|
args = args[1:]
|
|
parser = argparse.ArgumentParser(
|
|
description='A script to write a custom dartdoc_options.yaml to a file')
|
|
|
|
parser.add_argument(
|
|
'--output', '-o', type=str, required=True, help='File to write')
|
|
|
|
return parser.parse_args(args)
|
|
|
|
|
|
def Main(argv):
|
|
args = ParseArgs(argv)
|
|
# TODO(jcollins-g): switch to version numbers when github has its tags synced
|
|
revision = utils.GetGitRevision()
|
|
if revision is None:
|
|
revision = 'master'
|
|
output = '''dartdoc:
|
|
categoryOrder: ["Core", "VM", "Web"]
|
|
linkToSource:
|
|
root: '.'
|
|
uriTemplate: 'https://github.com/dart-lang/sdk/blob/%s/sdk/%%f%%#L%%l%%'
|
|
errors:
|
|
# Default errors of dartdoc:
|
|
- duplicate-file
|
|
- invalid-parameter
|
|
- no-defining-library-found
|
|
- tool-error
|
|
- unresolved-export
|
|
# Warnings that are elevated to errors:
|
|
- ambiguous-doc-reference
|
|
- ambiguous-reexport
|
|
- broken-link
|
|
- category-order-gives-missing-package-name
|
|
- deprecated
|
|
- ignored-canonical-for
|
|
- missing-from-search-index
|
|
- no-canonical-found
|
|
- no-documentable-libraries
|
|
- no-library-level-docs
|
|
- not-implemented
|
|
- orphaned-file
|
|
- reexported-private-api-across-packages
|
|
# - unknown-directive # Disabled due to https://github.com/dart-lang/dartdoc/issues/2353
|
|
- unknown-file
|
|
- unknown-macro
|
|
- unresolved-doc-reference
|
|
''' % revision
|
|
with open(args.output, 'w') as f:
|
|
f.write(output)
|
|
return 0
|
|
|
|
|
|
if __name__ == '__main__':
|
|
sys.exit(Main(sys.argv))
|