This is implemented, in addition to the ML-style one, because Rust does it. If we don't, we'll never hear the end of it. This commit also refactors some duplicate parts of the parser into a dedicated function. |
||
|---|---|---|
| .. | ||
| externs.js | ||
| main.js | ||
| README.md | ||
| scrape-examples.js | ||
| search.js | ||
| settings.js | ||
| src-script.js | ||
| storage.js | ||
Rustdoc JS
These JavaScript files are incorporated into the rustdoc binary at build time, and are minified and written to the filesystem as part of the doc build process.
We use the Closure Compiler dialect of JSDoc to comment our code and annotate params and return types. To run a check:
./x.py doc library/std
npm i -g google-closure-compiler
google-closure-compiler -W VERBOSE \
build/<YOUR PLATFORM>/doc/{search-index*.js,crates*.js} \
src/librustdoc/html/static/js/{search.js,main.js,storage.js} \
--externs src/librustdoc/html/static/js/externs.js >/dev/null