firka/flutter
firka/flutter
5
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

peg dartdoc to a specific version (#5644)

Browse Source 
* peg dartdoc to a specific version

* add some documentation

* apply the fix to dev/bots/docs instead
This commit is contained in:
Devon Carew 2016-08-29 16:20:18 -07:00 committed by GitHub
parent 119758b822
commit 22fe5db91a
2 changed files with 4 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
dev/bots/docs.sh
View File

@ -2,7 +2,8 @@
set -e set -e
# Install dartdoc. # Install dartdoc.
pub global activate dartdoc # We peg to this version to work around a bug affecting Flutter in 0.9.7+2.
pub global activate dartdoc 0.9.7+1
# Generate flutter docs into dev/docs/doc/api/. # Generate flutter docs into dev/docs/doc/api/.
(cd dev/tools; pub get) (cd dev/tools; pub get)

4
dev/tools/dartdoc.dart
View File

@ -13,7 +13,7 @@ const String kDocRoot = 'dev/docs/doc';
/// This script expects to run with the cwd as the root of the flutter repo. It /// This script expects to run with the cwd as the root of the flutter repo. It
/// will generate documentation for the packages in `//packages/` and write the /// will generate documentation for the packages in `//packages/` and write the
/// documentation to `//dev/docs/doc/api/`. /// documentation to `//dev/docs/doc/api/`.
/// ///
/// This script also updates the index.html file so that it can be placed /// This script also updates the index.html file so that it can be placed
/// at the root of docs.flutter.io. We are keeping the files inside of /// at the root of docs.flutter.io. We are keeping the files inside of
/// docs.flutter.io/flutter for now, so we need to manipulate paths /// docs.flutter.io/flutter for now, so we need to manipulate paths
@ -52,7 +52,7 @@ dependencies:
if (code != 0) if (code != 0)
exit(code); exit(code);
// Generate the documentation; we require dartdoc >= 0.9.4. // Generate the documentation.
List<String> args = <String>[ List<String> args = <String>[
'global', 'run', 'dartdoc', 'global', 'run', 'dartdoc',
'--header', 'styles.html', '--header', 'styles.html',