Add some items and comments.
[gpgme.git] / TODO
1 Hey Emacs, this is -*- outline -*- mode!
2
3 * ABI's to break:
4 ** string representation of non-secret keys and ATTR_IS_SECRET is NULL,
5    which can not be differentiated from the case that it is not
6    representable.
7
8 * Allow to use GTK's main loop instead of the select stuff in
9   wait.c
10
11 * add locking to the key cache?
12
13 * cleanup the namespace - we use log_* assuan_* ascii_* mutex_*
14   But those are only used internally.  Some linker tricks should make
15   it possible to hide them from the user (didn't work last time, try
16   again).
17
18 * Documentation
19 ** Add note about GPGME clearing out pointer return values.
20 ** validity/trust
21 ** Document gpgme.m4
22
23 * Engines
24 ** Move code common to all engines up from gpg to engine.
25 ** engine operations can return General Error on unknown protocol
26    (it's an internal error, as select_protocol checks already).
27 ** When server mode is implemented properly, more care has to be taken to
28     release all resources on error (for example to free assuan_cmd).
29 ** GnuPG
30 *** For pipemode, make sure to release the pipemode callback data object.
31
32 * Operations
33 ** Export status handler need much more work.
34 ** Import should return a useful error when one happened.
35 ** Genkey should return something more useful than General_Error.
36 ** Factor out common code in _op_*_start functions.
37 ** Add ATTR to return the number of subkeys or uids.
38 ** "When returning a GpgmeKey GPGME_ATTR_COMMENT attribute, characters  
39    like ":" are not un-escaped, they are returned as \x3a" Bug
40    reported by Stephane Corthesy.
41
42 * Error Values
43 ** Map ASSUAN/GpgSM ERR error values in a better way than is done now.
44 ** Verify (and document) if Read_Error, Write_Error, Pipe_Error set errno.
45
46 * Tests
47 ** Write a fake gpg-agent so that we can supply known passphrases to
48    gpgsm and setup the configuration files to use the agent.  Without
49    this we are testing a currently running gpg-agent which is not a
50    clever idea.
51 ** t-data
52 *** Test gpgme_data_release_and_get_mem.
53 *** Test gpgme_data_rewind for invalid types.
54 *** Test gpgme_data_read's readable feature.
55
56 * Debug
57 ** Handle malloc and vasprintf errors.  But decide first if they should be
58    ignored (and logged with 255?!), or really be assertions.
59
60 * Build suite
61 ** Make sure everything is cleaned correctly (esp. test area).
62
63 * Architecture support
64 ** (nothing currently)
65
66 Bugs reported by Stephane Corthesy:
67 > BTW, here's another bug: it it not possible to retrieve fingerprints  
68 > for subkeys
69
70 > In GpgmeRecipients, would it be possible to provide a function which  
71 > would return the validity assigned to a name contained in the  
72 > GpgmeRecipients instance?
73
74 > passphrase callback. If I use the same GpgmeContext as the one which  
75 > is currently asking for a passphrase, my app crashes: the r_hd in
76 > the  
77 > callback has become invalid; if I use a brand new one, the callback  
78 > is called recursively, when I ask to enumerate keys.