-
Welcome to B4X forum!
B4X is a set of simple and powerful cross platform RAD tools:
- B4A (free) - Android development
- B4J (free) - Desktop and Server development
- B4i - iOS development
- B4R (free) - Arduino, ESP8266 and ESP32 development
Android Tutorial [java] Auto generate library documentation with xml2bb
- Thread starter warwound
- Start date
- Similar Threads Similar Threads
I just added the word doesn't to a library class and generated the xml file.
Looking in the xml file with a text editor i see the apostrophe has not been escaped.
Uploading the xml file to my xml2bb script and generating BB or HTML documentation works as expected - no errors relating to the apostrophe.
Do you want to upload the xml file that causes this error and i'll take a look?
Martin.
Looking in the xml file with a text editor i see the apostrophe has not been escaped.
Uploading the xml file to my xml2bb script and generating BB or HTML documentation works as expected - no errors relating to the apostrophe.
Do you want to upload the xml file that causes this error and i'll take a look?
Martin.
No i changed nothing in the script or on my server.
Anyway if it works now it works!
Martin.
Showing my Interest
Hi Martin thanks for this great tool, i've used it a few times for the few libraries i've wrapped, unfortunately i just tried using it to create the documentation for an updated library but i keep getting an error, It says "String could not be parsed", do you have any idea why this is, i've double checked my xml file and i don't see anything out of the ordinary, i'd really appreciate it if you could take a look and let me know what you find out.
Thanks,
Walter
Here:
Wow i can't believe that, in the documention i have an example to set a custom label format where I put the Euro sign "€",LOL i can't believe this was it, any how i've changed it to the Dollar sign "$" it seems like it doesn't complain about this one. Thanks Martin, appreciate it.
Cheers,
Walter
Martin,
Ive noticed your wonderful tool doesn't handle a few cases as they should be handled. For example;
@Events(values={"ButtonPress(Result as Int)", "Cancel()", "Dismiss()"... etc
Comes out as
Events:
Cancel() needs to be Cancel.
But it would be nice if it would handle these cases automatically.
Thanks again for your tool, I would be lost without it.
Trevor
Ive noticed your wonderful tool doesn't handle a few cases as they should be handled. For example;
@Events(values={"ButtonPress(Result as Int)", "Cancel()", "Dismiss()"... etc
Comes out as
Events:
- ButtonPress (Result as Int As )
- Cancel ( As )
- Dismiss ( As )
- Show ( As )
Cancel() needs to be Cancel.
But it would be nice if it would handle these cases automatically.
Thanks again for your tool, I would be lost without it.
Trevor
@tchart
Yes, the tool fails to correctly handle various Events.
Events that return a value also fail.
The tool uses a PHP script to parse the library XML file and it's not easy to update it to handle each and every possibility.
Rather than try to fix the existing tool my plan is to create a new tool based on the BADoclet class.
The BADoclet correctly handles all possible scenarios in the library classes and produces the XML required for the b4a IDE.
So i thought it'd be easier to modify the BADoclet or create a new Doclet with similar functionality and this doclet would output an HTML help document instead of the b4a IDE XML file.
I've no idea when i'll have time to look at this update - it's 'on the back burner' as they say!
Yes, the tool fails to correctly handle various Events.
Events that return a value also fail.
The tool uses a PHP script to parse the library XML file and it's not easy to update it to handle each and every possibility.
Rather than try to fix the existing tool my plan is to create a new tool based on the BADoclet class.
The BADoclet correctly handles all possible scenarios in the library classes and produces the XML required for the b4a IDE.
So i thought it'd be easier to modify the BADoclet or create a new Doclet with similar functionality and this doclet would output an HTML help document instead of the b4a IDE XML file.
I've no idea when i'll have time to look at this update - it's 'on the back burner' as they say!
Maybe you want to share the php-code?
I could share - no problems there.
But having looked at BADoclet using JD-GUI i see the java Doclet class is the tool for this job and not php.
The Doclet class is intended to read class comments and generate documentation so its the obvious choice.
Ideally we could use the Doclet class in b4j and create our own custom library reference generators.
Just needs one of us members to go first and put an example together which others could modify to suit.
But having looked at BADoclet using JD-GUI i see the java Doclet class is the tool for this job and not php.
The Doclet class is intended to read class comments and generate documentation so its the obvious choice.
Ideally we could use the Doclet class in b4j and create our own custom library reference generators.
Just needs one of us members to go first and put an example together which others could modify to suit.
Hi Martin ,
This great tool is not working for me any more .
After clicking upload , the page seems to reload but without BBCode box
This great tool is not working for me any more .
After clicking upload , the page seems to reload but without BBCode box
Sorry for delay , I was busy .
It does work now , thanks a lot