doc/
[gpgme.git] / TODO
1 Hey Emacs, this is -*- outline -*- mode!
2
3 * ABI's to break:
4 ** The resulting error of an operation can not be retrieved
5    seperately; the op_foobar operations can't be implemented by the
6    user, they are not merely convenience, but necessity, while the
7    op_foobar_start functions for these are unusable (or render the
8    context unusable, your choice).
9 ** string representation of non-secret keys and ATTR_IS_SECRET is NULL,
10    which can not be differentiated from the case that it is not
11    representable.
12
13 * Implement posix-sema.c
14
15 * Allow to use GTK's main loop instead of the select stuff in
16   wait.c
17
18 * add locking to the key cache?
19
20 * GpgmeKey misses GPGME_ATTR_EXPIRE attribute
21
22 * Add ATTR to return the number of subkeys or uids.
23
24 * Factor out common code in _op_*_start functions.
25
26 * Documentation
27 ** Add note about GPGME clearing out pointer return values.
28 ** validity/trust
29
30 * Engines
31 ** Move code common to all engines up from gpg to engine.
32 ** engine operations can return General Error on unknown protocol
33    (it's an internal error, as select_protocol checks already).
34
35 * Operations
36 ** Export status handler need much more work.
37 ** Import should return a useful error when one happened.
38 ** Genkey should return something more useful than General_Error.
39
40 * Error Values
41 ** Map ASSUAN/GpgSM ERR error values in a better way than is done now.
42 ** Verify (and document) if Read_Error, Write_Error, Pipe_Error set errno.
43
44 * Tests
45 ** t-data
46 *** Test gpgme_data_release_and_get_mem.
47 *** Test gpgme_data_rewind for invalid types.
48 *** Test gpgme_data_read's readable feature.
49
50 * Build suite
51 ** Make sure everything is cleaned correctly (esp. test area).
52 ** There is a spurious 4/10 tests failed in some conditions.
53    Rebuilding from scratch works around that.
54
55 Bugs reported by Stephane Corthesy:
56 > - When returning a GpgmeKey GPGME_ATTR_COMMENT attribute, characters  
57 > like ":" are not un-escaped, they are returned as \x3a
58
59 > BTW, here's another bug: it it not possible to retrieve fingerprints  
60 > for subkeys
61
62 > In GpgmeRecipients, would it be possible to provide a function which  
63 > would return the validity assigned to a name contained in the  
64 > GpgmeRecipients instance?
65
66 > - There is an inconsistent behaviour: if we pass three times an  
67 > invalid (but non empty) passphrase, return code is GPGME_No_Data, but  
68 > if we pass three times an empty (and invalid) passphrase, we get  
69 > GPGME_No_Passphrase.
70
71 > passphrase callback. If I use the same GpgmeContext as the one which  
72 > is currently asking for a passphrase, my app crashes: the r_hd in
73 > the  
74 > callback has become invalid; if I use a brand new one, the callback  
75 > is called recursively, when I ask to enumerate keys.