Problems with asdoc

[GoogleCodeExporter]

What steps will reproduce the problem?
1. Try to compile the documentation using asdoc utility
2. The compiler will give fatal erros and generate a log error file
3. I used the head repository version

-------------

Here is the log error:

Text for param in br.com.stimuli.loading:BulkLoader/add is not valid.
org.xml.sax.SAXParseException: The end-tag for element type "td" must end
with a '>' delimiter.

Text for return in br.com.stimuli.loading:BulkProgressEvent/loadingStatus
is not valid.
No matching start tag.

-------------

The first one seems to be a problem with the columns and arrows in the
asdoc of add() method of BulkLoader class, the problem started because we
have multiple non-closed <td> tags starting at line 484.

The second issue is the <code> tag malformated at line 104 of
BulkProgressEvent class

-------------

I attached the files with the necessary corrections.

Thanks,

Ruy

Original issue reported on code.google.com by ruyado...@gmail.com on 28 Oct 2009 at 8:40

Attachments:

• BulkLoader.as
• BulkProgressEvent.as

[GoogleCodeExporter]

Hi Ruy.

Thanks for the heads up. 
I can (and routinely do ) run asdoc on BulkLoader without issues. Rather than 
just 
apply the fixes, I'd rather know __what__ went wrong.

If you could post full version information for the asdoc tool and the sdk, and 
also the 
arguments to the command line, it would help a lot.

Thanks
Arthur

Original comment by debert on 28 Oct 2009 at 8:43

[GoogleCodeExporter]

Arthur,

Os problemas são só umas tags malformatadas, na classe BulkLoader começa na 
linha 484:
         *           <td>priority</td.
e segue nas outras linhas:
         *           <td>maxTries</td.
         *           <td>weight</td.
         *           <td>headers</td.
         *           <td>context</td.
         *           <td>pausedAtStart</td.

E na classe BulkProgressEvent a linha 104 ta assim:
         * @return A code>String</code> will loading information.

Também um pequeno probleminha na tag <code>, só isso, mudei aqui e funcionou 
beleza!

valeu!

=)

----------

Anyway, I'm using flex4 sdk asdoc and the errors looked like this:

Buildfile: build.xml

properties:

docs:
     [exec] Chargement du fichier de configuration /Users/ruy/Applications/Adobe
Flash Builder Plug-in Beta2/sdks/4.0.0/frameworks/flex-config.xml
     [exec] Chargement du fichier de configuration
/Users/ruy/Documents/workspace/lesite-flash-framework/build/config-doc.xml
     [exec] [Fatal Error] :20:36: The end-tag for element type "td" must end with a
'>' delimiter.
     [exec] [Fatal Error] :1:22: The element type "test" must be terminated by the
matching end-tag "</test>".
     [exec] Texte incorrectement mis en forme rencontr#. Veuillez consulter
/Users/ruy/Documents/workspace/lesite-flash-framework/docs/validation_errors.log
 pour
plus de d#tails.
     [exec] Source file
/Users/ruy/Documents/workspace/lesite-flash-framework/docs/tempdita/packages.dit
a
does not exist
     [exec] Result: 2

BUILD SUCCESSFUL
Total time: 8 seconds

Original comment by ruyado...@gmail.com on 28 Oct 2009 at 8:52

[GoogleCodeExporter]

Hi Ruy.

Just fixed this in revision 309, thanks for the report.

Oddly, my asdoc (sdk 3.3.0) was building the documentation without issues. Sigh.

Original comment by debert on 31 Oct 2009 at 4:45

• Changed state: Fixed