Missing information in ReAction autodocs.

Have a question about our Software Developer Kit? Ask them here.

Missing information in ReAction autodocs.

Postby Deniil » Sat Aug 06, 2011 6:01 pm

I find there is a lot of things you have to guess or try and crash regarding ReAction attributes and methods.

For example:
LISTBROWSER_Selected
What happens if you supply a value that is out of range? Does it crash in true RA/intuition style, does it truncate, does it nothing, or will it deselect as if providing -1?

Another example:
LBM_ADDNODE
struct Node *lba_Node; // Insert() after this node

What happens if you supply NULL here? Are you supposed to supply NULL if you want to add at the beginning? Applying trial'n'crashing on this is very tedious since RA/intuition is very crash/lockup-prone if you make any mistake.

There are many more such examples but these were the only ones I could come up with now.
Deniil
 
Posts: 108
Joined: Mon Jul 11, 2011 7:59 pm

Re: Missing information in ReAction autodocs.

Postby Rigo » Mon Aug 15, 2011 2:19 pm

I have added some clarification to the listbrowser_gc.doc regarding LISTBROWSER_Selected.

Regarding the lba_Node and it's contents, this is listed in the autodoc section immediately following the LBM_ADDNODE structure definition and states:

The lba_Node field can be one of follwing three values:
* NULL -- add node to the head of the list
* ~0 -- add node to the tail of the list
* Node* -- new node will be inserted after this Node

Simon
User avatar
Rigo
AmigaOS Core Developer
AmigaOS Core Developer
 
Posts: 326
Joined: Mon Jan 17, 2011 10:42 pm

Re: Missing information in ReAction autodocs.

Postby trixie » Thu Aug 18, 2011 9:17 am

The ReAction gadget autodocs list the useful "GA_" tags but GA_TabCycle is not among them. I think it would be handy to list it as well, for two reasons:

  • Many people are still unaware that the tab-cycling feature can be used with most gadgets, not just strings and integers (this fact is, I believe, only documented in the old "BOOPSI in Release 3" AmigaMail article).
  • Programmers coming to ReAction with a previous GadTools experience may get confused because GA_TabCycle in string and integer gadgets defaults to TRUE in GadTools, while ReAction's GA_TabCycle default is FALSE for all gadgets.
Smoke me a kipper, I'll be back for breakfast!
SAM440ep-flex @ 667MHz / 1GB RAM / Radeon 9250 / AmigaOS 4.1 Final Edition
User avatar
trixie
 
Posts: 357
Joined: Thu Jun 30, 2011 3:54 pm
Location: Czech Republic


Return to SDK Support

Who is online

Users browsing this forum: No registered users and 1 guest