[packagekit] API Documentation

[Thomas Wood]

I have a few queries about the API documentation:

* The Search methods do not seem explain what the method is supposed to
do. For example, it is not clear what search group should do. Should it
search the available groups or search within a group? If searching
within a group, what field should it search on?

* I presume the 101 progress value is now deprecated, and the "no
progress updates" function should be used instead?

* There is no stipulation on how many times the progress callback can be
used and what the valid values are. pkcon appears to have difficulties
if 100% is sent multiple times.

* Sub-percentage is not explained, and there doesn't appear to be any
way for the backend to communicate how many sub-transactions there are
and which sub-transaction is currently being reported (maybe use status
method?).

Could anyone give me some pointers on these? Are there any plans to use
gtk-doc for the backend methods and signals?

Regards,

Thomas

-- 
OpenedHand Ltd.

Unit R Homesdale Business Center / 216-218 Homesdale Road /
Bromley / BR1 2QZ / UK             Tel: +44 (0)20 8819 6559

Expert Open Source For Consumer Devices - http://o-hand.com/
------------------------------------------------------------