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