New feature: built-in documentation

[Erel]

Basic4android V2.00 will include a new built-in documentation feature.

Comments above subs, such as:

Will automatically appear in the pop-up window:

If you want to add a code example you can use <code> tags:

'Parses a raw mail message and returns a Message object
'Mail - The mail raw text
'AttachmentsDir - Attachments will be saved in this folder
'
'Example: <code>
'Dim m As Message
'm = MailParser.ParseMail("Content-Type: text/plain; charset=" & QUOTE & "utf-8" & QUOTE, File.DirRootExternal)
'Log(m)</code>

The code will be syntax highlighted:

 

[PaulR]

It is a way to add notes to Autocomplete to describe your Subs.

Here is a screenshot...

Every line must have a '. Including the code....

 

[Olaan]

Hi PaulR,
Please help me edit my widget to complete. I should understand this thread.
I read the last replied. I'm very dizzy.
Best Regards
Theera
:sign0013:

 

[klaus]

I modified your code.
In the example code at line 30 a = Root add ( and you will see the help like in the attached picture.
The help must be before the Sub line without empty lines.

Best regards.

 

[Olaan]

Why different between your picture and mine?

Hi Klaus,
I have start understand what do you figure me about text tool tip. But why mine doesn't like your picture attached.
Best Regards
Theera

 

[Olaan]

Hi Klaus,PaulR,and Ricky D
Thank you very much for everybody. I have understand already. The last my reply. I must add <code>...</code> .This thread make me very teribly.
Best Regards
Theera

 

[JackKirk]

OK, I know this is an old thread but it seems the best place to pose this question.

I realise the question may not strictly relate to the built-in documentation feature but it is at least heavily associated with it.

If I have this method in a class module (note no return type on sub declaration because it never returns anything):

And then use it in another module (main say):

I get a spurious return type (highlit in red).

And I can not find a way to suppress it - I have seen other methods that do not return anything that do not have spurious return types so I assume it is possible.

Thanks in anticipation...

 

[Roycefer]

All B4X methods without a specified return type are given a return type of String when the B4X code is transpiled into Java. The only way to get no return type listed in the documentation is to have a return type of type void. B4X doesn't have a void type. The methods you are seeing without specified return type are most likely in libraries written in Java.

As an aside, I'm pretty sure Erel will insist that this should have been a new thread.