Add a comment.
Reorder some handlers inside TestAssertions.

HeaderDoc 8.9.14 (http://opensource.apple.com/source/headerdoc/headerdoc-8.9.14/), patched with the patches found here:

    http://www.darwin-development.org/headerdoc_patches/Xcode_5/

(headerdoc-8.9.14-8.9.24.diff, headerdoc-8.9.24-8.9.25.diff, and
headerdoc-8.9.25-8.9.26.diff) generates nearly perfect documentation.
HeaderDoc seems still a bit confused by the code of shouldRaise()
and shouldNotRaise(), which causes most assertion handlers
to be documented as global functions instead of being
documented as members of the nested TestedAssertions script.
Putting those handlers at the bottom of the script definition
fixes the problem.
Add a couple of comments.
Convert source to UTF8 before building the documentation.

Use iconv to convert ASUnit.applescript from UTF16-LE
(the encoding used by AS Editor) to UTF8. This is
necessary because HeaderDoc does not understand UTF16.
Update api task to use a local patched version of HeaderDoc.

This is a temporary change. Hopefully, the next
version of Xcode will ship with the patched HeaderDoc.

To build the documentation, you need to download
HeaderDoc 8.9.14 from

    http://opensource.apple.com/release/developer-tools-46/

and the patches headerdoc-8.9.14-8.9.24.diff,
headerdoc-8.9.24-8.9.25.diff, and headerdoc-8.9.25-8.9.26.diff
from

    http://www.darwin-development.org/headerdoc_patches/Xcode_5/

Download the patches inside the HeaderDoc main folder
and apply them with

    patch -p1 < headerdoc-8.9.14-8.9.24.diff

and similarly for the other two. Then, `make`.

The api task now assumes that the headerdoc-8.9.14 folder
is inside your ~/Downloads folder.