This change enables GitHub flavored markdown for APIdoc
comments. The code example in map.js shows how to use markdown
for code snippets. doc/index.md is now included again as start
page for the docs. Everything in the doc/tutorials directory
will also be added to the docs as tutorial. As an example, I
moved the ol3.md file with the architecture to the tutorials
directory.
Currently properties and methods annotated with @inheritDoc
or @override won't be documented at all. This is a known issue,
so I added a custom JSDoc plugin with a hack to avoid this.
The dependencies for build/src/external/src/types.js were wrong, which
meant that build/src/external/src/types.js would always be rebuilt,
which meant that almost everything else would be rebuilt too.
Instead, assume that phantomjs.exe is already in the user's path. It can
also be overridden on the build.py command line:
build.py PHANTOMJS=path/to/phantomjs
or with an environment variable:
set PHANTOMJS=path/to/phantomjs
build.py
The original decision to avoid index.html was because it only works with a build step. Since we've all accepted a build step, the more sensible name is index.html. Without this change, every hosted example has a link to http://openlayers.github.com/ol3/master/examples/example-list.html which 404s.
Take this example:
```
goog.require('ol.projection.addCommonProjections');
ol.projection.addCommonProjections();
```
Without this patch, the build_check_requires_timestamp target would report
that ``ol.projection`` is missing.
This is because ``ol.projection.addCommonProjections();`` would match both
``ol.projection.addCommonProjections and ``ol.projection`` provide
directives.
Add jquery and update the externs for the examples (code from @bartvde).
The lib is saved into the repository to be able to run the examples
and the check-examples target offline.
