Commit graph

64 commits

Author SHA1 Message Date
rnystrom@google.com 1b58511a2c Fix broken dartdoc.
Review URL: http://codereview.chromium.org//8879004

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@2216 260f80e4-7a28-3924-810f-c04153c831b5
2011-12-08 02:08:20 +00:00
nweiz@google.com a811209d78 Add a script to generate HTML and DOM docs with cross-links to one another.
This entails adding callbacks to dartdoc for injecting additional
comments, as well as adding somewhat deeper support for hashing and
equality testing of Frog objects.

The next step is to inject the annotations into the HTML and DOM library source itself.

Review URL: http://codereview.chromium.org//8771054

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@2199 260f80e4-7a28-3924-810f-c04153c831b5
2011-12-07 22:15:12 +00:00
rnystrom@google.com 0b7c641d40 Bunch more dartdoc changes in response to feedback:
- Remove "Library" from libraries in index.
- Use different icon for exception classes in nav.
- Group classes, interfaces, and exceptions together on lib page.
- Don't show "Class" or "Interface" before types on lib pages.
- Show type bounds on generic classes.
- Don't show private constructors.
- Sort named constructors.
- Document function-typed parameters correctly. (See Collection<T>)
- Document named optional parameters and default values.
- Document type bounds in class definitions.
- Show raw types without type arguments.
- In type annotations for instantiated generic types, link the type
  argument appropriately (i.e. List<String> will link String>).

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@2159 260f80e4-7a28-3924-810f-c04153c831b5
2011-12-07 02:34:27 +00:00
rnystrom@google.com cbbae74150 Bunch of dartdoc changes:
- Add special fake entrypoints so you can build docs for just corelib,
  dom, or html.
- Better main index page.
- Only show classes in nav for current library.
- Link to index page.
- Fix word wrap on icons.
- Sort case-insensitively.

Review URL: http://codereview.chromium.org//8822001

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@2143 260f80e4-7a28-3924-810f-c04153c831b5
2011-12-06 21:20:34 +00:00
rnystrom@google.com d2130d11e8 Navigation in generated docs.
Review URL: http://codereview.chromium.org//8772067

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@2102 260f80e4-7a28-3924-810f-c04153c831b5
2011-12-05 23:14:43 +00:00
rnystrom@google.com f02660f3a0 Link to factory class if an interface has one.
Review URL: http://codereview.chromium.org//8763016

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@2048 260f80e4-7a28-3924-810f-c04153c831b5
2011-12-03 01:43:41 +00:00
rnystrom@google.com cafe727361 Create separate HTML pages for each type.
This also writes everything to an index.html inside an appropriate
directory. This keeps the URLs nice and pretty like: core_lib/String.
The downside is that you'll need to run a little local web server
to get them to be served up right instead of just opening them as
files in your browser.

Review URL: http://codereview.chromium.org//8758010

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@2031 260f80e4-7a28-3924-810f-c04153c831b5
2011-12-02 19:41:08 +00:00
rnystrom@google.com f7f610fdb5 Find [references] to top-level members.
Review URL: http://codereview.chromium.org//8692017

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@1932 260f80e4-7a28-3924-810f-c04153c831b5
2011-11-30 18:34:10 +00:00
rnystrom@google.com 64a619f032 Use right path to html lib.
Review URL: http://codereview.chromium.org//8726038

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@1899 260f80e4-7a28-3924-810f-c04153c831b5
2011-11-29 18:04:04 +00:00
rnystrom@google.com 95f64cbf9f Lots of stuff hooking up markdown to dartdoc.
- Add support for [foo] implicit links to markdown.
- Add hook so that outside code can define what markup a [foo] link creates.
- Make dartdoc look up [foo] names to resolve the identifier.
- Fix unmatched tag unwinding bug.
- Add [:...:] code support to dartdoc.
- Fix text and URLs for generic types in docs.
- Sort classes by name.
- Don't generate docs for private types.
- Fix generated docs for inheritance chain.
- Make source code in generated docs optional.
- Fix showing base class in docs.
- Implement insertRange() for List in frog.
- Add dartdoc shell script.

Review URL: http://codereview.chromium.org//8725007

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@1886 260f80e4-7a28-3924-810f-c04153c831b5
2011-11-29 02:47:18 +00:00
nweiz@google.com 4b756816ea Add a script for determining which DOM methods correspond to which HTML methods.
Ultimately, this will be used for generating documentation. Currently, though,
it just prints out information to the console.

This also includes some annotations to the HTML library, where the DOM
correspondence couldn't be auto-detected.

Review URL: http://codereview.chromium.org//8548019

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@1767 260f80e4-7a28-3924-810f-c04153c831b5
2011-11-22 23:39:59 +00:00
rnystrom@google.com 92f55bcfd5 Clean and create output directory when generating docs.
Review URL: http://codereview.chromium.org//8572044

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@1627 260f80e4-7a28-3924-810f-c04153c831b5
2011-11-17 20:59:14 +00:00
nweiz@google.com 07a7a968a8 StopWatch -> Stopwatch in dartdoc.
TBR=rnystrom

Review URL: http://codereview.chromium.org//8567015

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@1523 260f80e4-7a28-3924-810f-c04153c831b5
2011-11-15 00:10:29 +00:00
rnystrom@google.com a1fa8e8245 Move doc generator out of frog samples.
It's on its way to being a real library now so it isn't a sample anymore.

Review URL: http://codereview.chromium.org//8515029

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@1482 260f80e4-7a28-3924-810f-c04153c831b5
2011-11-11 23:41:34 +00:00