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