Added some feature requests.
[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 * New features:
18 ** notification system
19    We need a simple notification system, probably a a simple callback
20    with a string and some optional arguments.  This is for example
21    required to notify an application of a changed smartcard,  The
22    application can then do whatever is required.  There are other
23    usages too.  This notfication system should be independent of any
24    contextes of course.
25 ** --learn-code support
26    This might be integrated with import. we still need to work out how
27    to learn a card when gpg and gpgsm have support for smartcards.
28
29 * Documentation
30 ** Add note about GPGME clearing out pointer return values.
31 ** validity/trust
32
33 * Engines
34 ** Move code common to all engines up from gpg to engine.
35 ** engine operations can return General Error on unknown protocol
36    (it's an internal error, as select_protocol checks already).
37 ** When server mode is implemented properly, more care has to be taken to
38     release all resources on error (for example to free assuan_cmd).
39 ** GnuPG
40 *** For pipemode, make sure to release the pipemode callback data object.
41     Note, pipemode will eventually be replaced by an Assuan interface to gpg.
42
43 * Operations
44 ** Passphrase callback should not copy password. !!!
45 ** Export status handler need much more work.
46 ** Import should return a useful error when one happened.
47 ** Genkey should return something more useful than General_Error.
48 ** Factor out common code in _op_*_start functions.
49 ** Add ATTR to return the number of subkeys or uids.
50 ** "When returning a GpgmeKey GPGME_ATTR_COMMENT attribute, characters  
51    like ":" are not un-escaped, they are returned as \x3a" Bug
52    reported by Stephane Corthesy.
53
54 * Error Values
55 ** Map ASSUAN/GpgSM ERR error values in a better way than is done now. !!
56 ** Verify (and document) if Read_Error, Write_Error, Pipe_Error set errno.
57
58 * Tests
59 ** Write a fake gpg-agent so that we can supply known passphrases to
60    gpgsm and setup the configuration files to use the agent.  Without
61    this we are testing a currently running gpg-agent which is not a
62    clever idea. !
63 ** t-data
64 *** Test gpgme_data_release_and_get_mem.
65 *** Test gpgme_data_rewind for invalid types.
66 *** Test gpgme_data_read's readable feature.
67
68 * Debug
69 ** Handle malloc and vasprintf errors.  But decide first if they should be
70    ignored (and logged with 255?!), or really be assertions. !
71
72 * Build suite
73 ** Make sure everything is cleaned correctly (esp. test area).
74
75 Bugs reported by Stephane Corthesy:
76 > BTW, here's another bug: it it not possible to retrieve fingerprints  
77 > for subkeys
78 --> This seems to work now (wk 2002-08-20)
79
80 > In GpgmeRecipients, would it be possible to provide a function which  
81 > would return the validity assigned to a name contained in the  
82 > GpgmeRecipients instance?
83
84 > passphrase callback. If I use the same GpgmeContext as the one which  
85 > is currently asking for a passphrase, my app crashes: the r_hd in
86 > the  
87 > callback has become invalid; if I use a brand new one, the callback  
88 > is called recursively, when I ask to enumerate keys.
89
90
91
92