dartdoc not functional again

[DartBot]

This issue was originally filed by [email protected]

---

Sorry to bug you, but dartdoc and apidoc do not work correctly.

first, dartdoc itself calls 'dart' (on line 58) - you need to add the excutable to the current path to get that working or add the missing paths inside the script itself.

second, after adding dart to the path and running, both client scripts are compiled but 2 libraries are not found and no docs are rendered for io and utf8.

$ ./dartdoc dartdoc.dart
Compiled client-static.dart.
Compiled client-live-nav.dart.
error: File not found: dart:io
error: File not found: dart:utf8
Documented 11 libraries, 279 types, and 2549 members in 9324msec.

Let me suggest, that you add the apidoc script or 'dartdoc dartdoc.dart' or 'dartdoc html' to the buildbot configuration and by that functional test the docs generation.

[madsager]

cc @munificent.
Added Area-Samples, Triaged labels.

[munificent]

Should be working (again). I am working on integrating it into our build process so that hopefully it won't be broken as frequently.

---

Added Fixed label.

[DartBot]

This comment was originally written by [email protected]

---

Thank you for fixing this. Do you think that adding "dart/out/Debug_ia32/dart-sdk/bin" to the path should be documented? (dartdoc line 57)

Btw, when running "dartdoc dartdoc.dart" i get 2 entries for 'uri' (...dart/lib/dartdoc/docs/uri.html), i'll try to find the problem and report back.

Anyway, thanks for making the apidocs run again
Michael

[munificent]

Do you think that adding "dart/out/Debug_ia32/dart-sdk/bin" to the path should be documented?

We need to figure out some coherent way of telling people how to run dart and how to configure it so that scripts can run dart. What I may end up doing for dartdoc is just getting rid of the bash script completely. That way you can just invoke the dart script directly using whatever path to dart you want.

Btw, when running "dartdoc dartdoc.dart" i get 2 entries for 'uri' (...dart/lib/dartdoc/docs/uri.html), i'll try to find the problem and report back.

Strange, what do you mean by two entries?