| # Notes for developers |
| |
| ## Developing locally together with dart2js: |
| |
| * Use a path dependency on this repo to prepare changes. |
| |
| ## Submitting changes. |
| |
| * Submit changes in this repo first. |
| * Update the sdk/DEPS and sdk/tools/deps/dartium.deps/DEPS to use the latest |
| hash of this repo. |
| * Submit dart2js changes together with the roll in DEPS. |
| |
| ## Updating the dart2js\_info dart docs |
| |
| We use `dartdoc` and host the generated documentation as a [github page][1] in |
| this repo. Here is how to update it: |
| |
| * Make sure you have the dartdoc tool installed: |
| |
| ``` |
| pub global activate dartdoc |
| ``` |
| |
| * Run the dartdoc tool on the root of the repo in master, specify an out |
| directory different than `doc`: |
| |
| ```sh |
| dartdoc --output _docs |
| ``` |
| |
| * Switch to the `gh-pages` branch: |
| |
| ``` |
| git checkout gh-pages |
| git pull |
| ``` |
| |
| * Override the existing docs by hand: |
| |
| ``` |
| rm -r doc/api |
| mv _docs doc/api |
| git diff # validate changes look right |
| git commit -a -m "Update documentation ... " |
| ``` |
| |
| * Update the gh-pages branch in the server |
| ``` |
| git push origin gh-pages |
| ``` |
| |
| |
| [1]: http://dart-lang.github.io/dart2js_info/doc/api/dart2js_info.info/AllInfo-class.html |
