2005-11-17 Marcus Brinkmann <marcus@g10code.de>
[gpgme.git] / TODO
diff --git a/TODO b/TODO
index 28d5e23..e74c5ab 100644 (file)
--- a/TODO
+++ b/TODO
@@ -1,14 +1,22 @@
 Hey Emacs, this is -*- outline -*- mode!
 
 * Before release:
-** set_locale for thread safe and env independent locale selection.
-** Add gpgme_strerror_r() when gpg_strerror_r() exists.
+** Some gpg tests fail with gpg 1.3.4-cvs (gpg/t-keylist-sig)
+   The test is currently disabled there and in gpg/t-import.
+** When gpg supports it, write binary subpackets directly,
+   and parse SUBPACKET status lines.
+** External key listing for OpenPGP.
+   This probably requires changes at gpg.
+
 
 * ABI's to break:
+** gpgme_edit_cb_t: Add "processed" return argument
+   (see edit.c::command_handler).
 ** I/O and User Data could be made extensible.  But this can be done
    without breaking the ABI hopefully.
+*  All enums that should be enums need to have a maximum value to ensure
+   a certain minimum width for extensibility.
 ** Compatibility interfaces that can be removed in future versions:
-*** ath compatibility modules.
 *** gpgme_data_new_from_filepart
 *** gpgme_data_new_from_file
 *** gpgme_data_new_with_read_cb
@@ -25,32 +33,36 @@ Hey Emacs, this is -*- outline -*- mode!
 *** gpgme_attr_t
 *** All Gpgme* typedefs.
 
+
 * Thread support:
 ** When GNU Pth supports sendmsg/recvmsg, wrap them properly.
+** Without timegm (3) support our ISO time parser is not thread safe.
+   There is a configure time warning, though.
 
 * New features:
+** Extended notation support.  When gpg supports arbitrary binary
+   notation data, provide a user interface for that.
 ** notification system
    We need a simple notification system, probably a simple callback
    with a string and some optional arguments.  This is for example
-   required to notify an application of a changed smartcard,  The
+   required to notify an application of a changed smartcard, The
    application can then do whatever is required.  There are other
    usages too.  This notfication system should be independent of any
    contextes of course.
 ** --learn-code support
    This might be integrated with import. we still need to work out how
    to learn a card when gpg and gpgsm have support for smartcards.
-** How to terminate a pending operation?  Something like gpgme_op_reset,
-   but where are you allowed to call it (think callback handlers).
-   Then gpgme_op_*list_end can go.  Update: The only place where this
-   can go is returning errors from callback handlers, and a function
-   to be called for example from the user event loop code.  The user
-   must observe the threading rules!  A blocking thread can not be
-   cancelled.
 ** Might need a stat() for data objects and use it for length param to gpg.
-** Allow to export secret keys.
 ** Implement support for photo ids.
+** Allow selection of subkeys
+** Allow to return time stamps in ISO format
+  This allows us to handle years later than 2037 properly.  With the
+  time_t interface they are all mapped to 2037-12-31
 ** New features requested by our dear users, but rejected or left for
    later consideration:
+*** Allow to export secret keys.
+    Rejected because this is conceptually flawed.  Secret keys on a
+    smart card can not be exported, for example.
 *** Selecting the key ring, setting the version or comment in output.
     Rejected because the naive implementation is engine specific, the
     configuration is part of the engine's configuration or readily
@@ -60,6 +72,7 @@ Hey Emacs, this is -*- outline -*- mode!
 
 * Documentation
 ** Document validity and trust issues.
+** In gpgme.texi: Register callbacks under the right letter in the index.
 
 * Engines
 ** Do not create/destroy engines, but create engine and then reset it.
@@ -69,7 +82,8 @@ Hey Emacs, this is -*- outline -*- mode!
    about where to guarantee what (ie, what happens if start fails, are
    the fds unregistered immediately - i think so?)
 ** Optimize the case where a data object has an underlying fd we can pass
-   directly to the engine.
+   directly to the engine.  This will be automatic with socket I/O and
+   descriptor passing.
 ** Move code common to all engines up from gpg to engine.
 ** engine operations can return General Error on unknown protocol
    (it's an internal error, as select_protocol checks already).
@@ -80,8 +94,6 @@ Hey Emacs, this is -*- outline -*- mode!
 ** If an operation failed, make sure that the result functions don't return
    corrupt partial information. !!!
    NOTE: The EOF status handler is not called in this case !!!
-** If no passphrase cb is installed, status handler is not run even if
-   password is required by crypto engine. !!
 ** Verify must not fail on NODATA premature if auto-key-retrieval failed.
    It should not fail silently if it knows there is an error. !!!
 ** All operations: Better error reporting. !!
@@ -95,19 +107,6 @@ Hey Emacs, this is -*- outline -*- mode!
 ** Return ENC_TO output in verify result.  Again, this is not available
    for gpgsm.
 ** Genkey should return something more useful than General_Error.
-** Decrypt:
-   On Fri, Jun 27, 2003 at 06:28:23PM +0200, Heiko Abraham wrote:
-   > I have a cipher text and I use 'gpgme_op_decrypt_verify(..)'
-   > for decrypt and get the plaintext. But also I wish a list
-   > of all reciepient, that can also decrypt this file.
-   >
-   > If I store the file and check it with 'gpg --list-packets ${filename}'
-   > then I will become also a recipient-list.
-   > It this also possible with gpgme?
-
-   Currently not, but it is easy to add this to GPGME 0.4.1.  At least the key
-   ID and a user ID hint is available from gpg (of course key IDs are not
-   necessarily unique!).  I will put it on the TODO list.
 ** If possible, use --file-setsize to set the file size for proper progress
    callback handling.  Write data interface for file size.
 ** Optimize the file descriptor list, so the number of open fds is
@@ -129,6 +128,9 @@ Hey Emacs, this is -*- outline -*- mode!
 ** t-data
 *** Test gpgme_data_release_and_get_mem.
 *** Test gpgme_data_seek for invalid types.
+** t-keylist
+   Write a test for ext_keylist.
+** Test reading key signatures.
 
 * Debug
 ** Handle malloc and vasprintf errors.  But decide first if they should be
@@ -136,4 +138,22 @@ Hey Emacs, this is -*- outline -*- mode!
 
 * Build suite
 ** Make sure everything is cleaned correctly (esp. test area).
-** Cofnigure test for gpg and gpgsm version (as a warning).
+** Enable AC_CONFIG_MACRO_DIR and bump up autoconf version requirement.
+   (To fix "./autogen.sh; ./configure --enable-maintainer-mode; touch
+   configure.ac; make").  Currently worked around with ACLOCAL_AMFLAGS???
+
+* Error checking 
+** engine-gpgsm, with-validation
+   Add error checking some time after releasing a new gpgsm.
+
+
+Copyright 2004, 2005 g10 Code GmbH
+
+This file is free software; as a special exception the author gives
+unlimited permission to copy and/or distribute it, with or without
+modifications, as long as this notice is preserved.
+
+This file is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
+implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+PURPOSE.