[Bug 24656] Improve documentation

[bugzilla-daemon at freedesktop.org]

http://bugs.freedesktop.org/show_bug.cgi?id=24656





--- Comment #5 from Simon McVittie <simon.mcvittie at collabora.co.uk>  2009-11-18 10:31:26 PST ---
(In reply to comment #3)
> > + * Another way to create an Account object is to just call the create method.
> > 
> > Could you expand on this a little to make it clear that ValidAccounts is the
> > list of stored accounts, and create() adds a new one? At the moment it reads as
> > though this is some sort of alternative API for the same thing.
> This actually does not create a new account. This is the Account::create
> method, not the AccountManager::createAccount method, which actually attempts
> to create a new account

Perhaps for 0.4, we should stop calling pseudo-constructors create(), and call
them createObject(), or createProxy(), or even construct(), to avoid this
source of confusion. If so, we should add the new version soon, deprecate the
old version after a while, then delete the old deprecated version just before
0.4.


-- 
Configure bugmail: http://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.