Monday, April 19, 2010

ASDoc HTML elements - Flash Builder 4

When you update your Flex 3 code to Flex 4, you might also need to update the HTML you have inside your ASDoc.  How to specify HTML elements in asdoc have not changed much between Flex 3 and Flex 4, but still there are some minor things that might trick you up.


For reference, see http://livedocs.adobe.com/flex/3/html/help.html?content=asdoc_8.html and http://help.adobe.com/en_US/Flex/4.0/UsingSDK/WSd0ded3821e0d52fe1e63e3d11c2f44bc36-8000.html.


About Ampersand (&)

Flex 3 used "&".
Flex 4 uses "&" and the documentation says to not use the Flex 3 styled "&".


About non-breaking spaces

Both Flex 3 and 4 documentation was clear that you should use " ", but maybe for some reason, like us, you instead had " ". It worked fine in Flex 3 and still works fine in Flex 4 HTML documents. However, if you are in Flash Builder and taking advantage of "fat" swc (asdoc content for inline code hinting and the "asdoc" tab), then only " " works fine. Both " " and " " will show in Flash Builder as " ". So trust the documentation, stick with " " and you will be fine :)

0 comments: