URIScheme break asdoc

[GoogleCodeExporter]

things like that in comment
----
   /**
    * generic syntax:
    *
<scheme>://[<username>[:<password>]@]<host>[:<port>]/<path>[?<query][#<fragment>
]
    */
----

make asdoc fail big time

with for ex
----
     [exec] An unexpected error occurred.
     [exec] Error #1085: The element type "]<host" must be terminated by
the matching end-tag "</]<host>".
     [exec] 
     [exec] (Location of error unknown)XSLT Error
(javax.xml.transform.TransformerException): java.io.FileNotFoundException:
/buRRRn/products/MaasHaack/framework-trunk/docs/maashaack/toplevel_classes.xml
(No such file or directory)

----

Original issue reported on code.google.com by zwetan on 4 Mar 2009 at 8:16

[GoogleCodeExporter]

Original comment by zwetan on 4 Mar 2009 at 8:25

• Added labels: Milestone-Release0.2, Project-framework

[GoogleCodeExporter]

In the documentation (ASDoc) the * are a problem and the html tags too.. must 
use
%html notation 

Original comment by ekamel...@gmail.com on 4 Mar 2009 at 8:36

[GoogleCodeExporter]

Solution : http://livedocs.adobe.com/flex/3/html/help.html?content=asdoc_3.html

i try to fix it this week-end

[quote]
Using special characters

The ASDoc tool might fail if your source files contain non-UTF-8 characters 
such as
curly quotes. If it does fail, the error messages it displays should refer to a 
line
number in the interim XML file that was created for that class. That can help 
you
track down the location of the special character.

ASDoc passes all HTML tags and tag entities in a comment to the output. 
Therefore, if
you want to use special characters in a comment, you must enter them using HTML 
code
equivalents. For example, to use a less-than (<) or greater-than (>) symbols in 
a
comment, use < and >. To use the at-sign (@) in a comment, use &64;. Otherwise,
these characters will be interpreted as literal HTML characters in the output.

For a list of common HTML tags and their entity equivalents, see Summary of 
commonly
used HTML elements.

Because asterisks (*) are used to delimit comments, ASDoc does not support 
asterisks
within a comment. To use an asterisk in an ASDoc comment, you must use the 
double
tilde (~~). 
[/quote]

Original comment by ekamel...@gmail.com on 13 Mar 2009 at 9:34

• Changed state: Started

[GoogleCodeExporter]

try to fix the problem in the revision 629 : 
http://code.google.com/p/maashaack/source/detail?r=629

The unit tests are ok but i can't test the build for the moment (i must install 
the
Flex SDK ;))

We must verified the fix

Original comment by ekamel...@gmail.com on 13 Mar 2009 at 9:41

• Changed state: Fixed