mozilla/rust — pull request #2762 by Dretch (2012-06-30 11:39:26+00:00)
Title: Prettydocs

Work for issue #2498.

Notes:

1. I have changed the test suite to use `//~ ERROR` instead of `//! ERROR` to work around a conflict with the sugared doc syntax.

2. There is a new script: `etc/sugarise-doc-comments.py` to convert unsugared doc attributes, but I have not actually committed the results of running this script. I did not want the pull request to become too large and prone to merge conflicts (although I had to update the test suite in order to `make check`). It handles 95% of cases but will require some manual editing to deal with (mostly) lines that become too long.

3. I plan on updating https://github.com/mozilla/rust/wiki/Doc-using-rustdoc once this pull request has been accepted.