2003-09-03 Marcus Brinkmann <marcus@g10code.de>
[gpgme.git] / doc / ChangeLog
1 2003-09-03  Marcus Brinkmann  <marcus@g10code.de>
2
3         * gpgme.texi (Header): We don't use the assuan namespace anymore.
4         Document new thread options.
5
6 2003-08-14  Marcus Brinkmann  <marcus@g10code.de>
7
8         * gpgme.texi (Creating a Signature): Change type of member class
9         to unsigned int.
10
11 2003-08-04  Marcus Brinkmann  <marcus@g10code.de>
12
13         * gpgme.texi (Verify): Get error code from SIG->status in the code
14         for gpgme_get_sig_status.
15
16 2003-07-31  Marcus Brinkmann  <marcus@g10code.de>
17
18         * gpgme.texi (Key Management): Add can_authenticate flag.
19
20         * gpgme.texi (Listing Keys): Document GPG_ERR_AMBIGUOUS_NAME for
21         gpgme_get_key.
22
23 2003-07-29  Marcus Brinkmann  <marcus@g10code.de>
24
25         * Makefile.am (EXTRA_DIST): Remove variable.
26
27         * gpgme.texi (Encrypting a Plaintext): Bad passphrase is only
28         possible with symmetric encryption, change the wording to reflect
29         that.
30
31         * gpgme.texi (Creating a Signature): Document
32         GPG_ERR_UNUSABLE_SECKEY.
33
34         * gpgme.texi (Encrypting a Plaintext): Mention encrypt and sign
35         operations in result function.
36         (Creating a Signature): Likewise.
37
38 2003-07-23  Marcus Brinkmann  <marcus@g10code.de>
39
40         * gpgme.texi (Key Listing Mode): Remove word duplication.
41         (Listing Keys): Remove mentioning of force argument.
42         (Verify): Don't mention r_stat.  Fix some typos.
43         (Decrypt and Verify): Correct info how to get the result.  Don't
44         mention r_stat.
45         (Manipulating Data Buffers): Fix documentation of return value.
46         (Listing Keys): Update examples.
47         (Decrypt): Result might also be available when operation failed.
48         (Verify): Result might also be available when operation failed.
49         All spotted by St├ęphane Corth├ęsy.
50
51 2003-07-22  Marcus Brinkmann  <marcus@g10code.de>
52
53         * gpgme.texi (Error Sources): Fix cut and paste error.
54
55 2003-07-09  Marcus Brinkmann  <marcus@g10code.de>
56
57         * gpgme.texi (Key Management): Clarify difference between can_sign
58         and can_certify.
59         (Information About Keys): Likewise for GPGME_ATTR_CAN_SIGN and
60         GPGME_ATTR_CAN_CERTIFY.
61
62 2003-07-08  Marcus Brinkmann  <marcus@g10code.de>
63
64         * gpgme.texi (Progress Meter Callback): Change return type of
65         gpgme_progress_cb_t to void.
66
67 2003-06-22  Marcus Brinkmann  <marcus@g10code.de>
68
69         * gpgme.texi: Add 2003 to copyright notice.
70
71         * gpgme.texi (Header): Fix name space documentation on
72         libgpg-error.
73
74 2003-06-22  Marcus Brinkmann  <marcus@g10code.de>
75
76         * gpgme.texi (Multi Threading): Remove reference to
77         gpgme_recipients_t.
78
79 2003-06-06  Marcus Brinkmann  <marcus@g10code.de>
80
81         * gpgme.texi (Crypto Operations): Rename gpgme_invalid_user_id_t
82         to gpgme_invalid_key_t.
83
84 2003-06-06  Marcus Brinkmann  <marcus@g10code.de>
85
86         * gpgme.texi: Change error codes to GPG_ERR_* variants.
87         (Error Handling): Rewritten.
88
89 2003-05-29  Marcus Brinkmann  <marcus@g10code.de>
90
91         * gpgme.texi (Exporting Keys): Change and document prototypes.
92         Add new gpgme_op_export_ext and gpgme_op_export_ext_start
93         variants.
94         (Selecting Recipients): Section removed.
95         (Encrypting a Plaintext): Change prototypes and document the
96         changes.
97
98 2003-05-28  Marcus Brinkmann  <marcus@g10code.de>
99
100         * gpgme.texi (Exporting Keys): Change argument type from
101         gpgme_recipient_t to gpgme_user_id_t.
102         (Encrypting a Plaintext): Likewise.
103         (Selecting Recipients): Rewritten.
104
105 2003-05-27  Marcus Brinkmann  <marcus@g10code.de>
106
107         * gpgme.texi (Protocol Selection): Do not use @acronym in @node
108         because that breaks texi2dvi.
109
110         * gpgme.texi (Passphrase Callback): Document new prototype.
111
112 2003-05-18  Marcus Brinkmann  <marcus@g10code.de>
113
114         * gpgme.texi (Header): Remove Gpgme as namespace prefix.  Add
115         _GPGME to namespace prefix.
116         * gpgme.texi (Multi Threading): Add note about link order.
117
118 2003-05-04  Marcus Brinkmann  <marcus@g10code.de>
119
120         * gpgme.texi (Listing Keys): Document what happens if key is not
121         found.
122
123         * gpgme.texi (Importing Keys): Fix cut and paste error.
124
125 2003-04-30  Marcus Brinkmann  <marcus@g10code.de>
126
127         * gpgme.texi (Encrypting a Plaintext): Remove reference to
128         gpgme_get_op_info.
129         (Detailed Results): Subsection removed.
130
131         * gpgme.texi (Key Listing Mode): Add GPGME_KEYLIST_MODE_SIGS.
132         (Manipulating Keys): Add obsoleteness note.
133         (Key Signatures): Likewise.
134         (Information About Keys): Likewise.
135         (Key Management): Add new data types GpgmeSubkey, GpgmeKeySig,
136         GpgmeUserID, and all the information about GpgmeKey.
137
138 2003-04-29  Marcus Brinkmann  <marcus@g10code.de>
139
140         * gpgme.texi (Listing Keys): Remove force_update argument from
141         gpgme_get_key.
142
143         * gpgme.texi (Trust Item Management): Add data members of
144         GpgmeTrustItem type.
145         (Information About Trust Items): Add note about obsoleteness.
146         (Manipulating Trust Items): Add gpgme_trust_item_ref and
147         gpgme_trust_item_unref.
148
149 2003-04-28  Marcus Brinkmann  <marcus@g10code.de>
150
151         * gpgme.texi (Verify): Rewritten to take into account new and
152         deprecated functions and data types.
153
154         * gpgme.texi (Decrypt): Descript gpgme_op_decrypt_result and
155         GpgmeDecryptResult.
156
157 2003-04-27  Marcus Brinkmann  <marcus@g10code.de>
158
159         * gpgme.texi (Encrypting a Plaintext): Add info about
160         GpgmeEncryptResult and gpgme_op_encrypt_result.
161
162         * gpgme.texi (Creating a Signature): Add info about
163         GpgmeNewSignature, GpgmeSignResult and gpgme_op_sign_result.
164         (Crypto Operations): Add GpgmeInvalidUserID.
165         (Algorithms): New chapter.
166
167         * gpgme.texi (Deleting Keys): Document
168         GPGME_Ambiguous_Specification.
169         (Error Values): Remove GPGME_Invalid_Type and GPGME_Invalid_Mode.
170         Add GPGME_Unknown_Reason, GPGME_Not_Found,
171         GPGME_Ambiguous_Specification, GPGME_Wrong_Key_Usage,
172         GPGME_Key_Revoked, GPGME_Key_Expired, GPGME_No_CRL_Known,
173         GPGME_CRL_Too_Old, GPGME_Policy_Mismatch, GPGME_No_Secret_Key,
174         GPGME_Key_Not_Trusted, GPGME_Issuer_Missing, GPGME_Chain_Too_Long,
175         GPGME_Unsupported_Algorithm, GPGME_Sig_Expired,
176         GPGME_Bad_Signature, GPGME_No_Public_Key.
177
178 2003-04-25  Marcus Brinkmann  <marcus@g10code.de>
179
180         * gpgme.texi (Importing Keys): Change GPGME_IMPORT_PRIVATE to
181         GPGME_IMPORT_SECRET.
182
183         * gpgme.texi (Importing Keys): Remove note about gpgme_get_op_info.
184         (Detailed Results): Remove note about import.
185
186         * gpgme.texi (Importing Keys): Add documentation for
187         GpgmeImportStatus, GpgmeImportResult and gpgme_op_import_result.
188
189         * gpgme.texi (Generating Keys): Fix documentation of public and
190         secret arguments.
191
192 2003-04-24  Marcus Brinkmann  <marcus@g10code.de>
193
194         * gpgme.texi (Generating Keys): Document changed gpgme_op_genkey
195         and new gpgme_op_genkey_result function.  Document
196         GpgmeGenKeyResult data type.
197
198         * gpgme.texi (Error Values): Rename GPGME_No_Passphrase to
199         GPGME_Bad_Passphrase.
200         * gpgme.texi (Decrypt): Likewise.
201         (Decrypt and Verify): Likewise.
202         (Creating a Signature): Likewise.
203         (Encrypting a Plaintext): Likewise.
204
205         * gpgme.texi (Error Values): Rename GPGME_No_Recipients to
206         GPGME_No_UserID and GPGME_Invalid_Recipient to
207         GPGME_Invalid_UserID.
208         (Encrypting a Plaintext): Likewise.
209
210         * gpgme.texi (Error Values): Remove GPGME_Busy and GPGME_No_Request.
211         (Listing Keys): Likewise.
212         (Listing Trust Items): Likewise.
213
214 2003-02-06  Marcus Brinkmann  <marcus@g10code.de>
215
216         * gpgme.texi (Cancelling an Operation): Removed.
217         (Passphrase Callback): Document new type for GpgmePassphraseCb.
218
219 2003-01-30  Marcus Brinkmann  <marcus@g10code.de>
220
221         * gpgme.texi (Engine Information): Rename member part to
222         file_name.
223
224         * gpgme.texi (Protocols and Engines): Document
225         gpgme_get_protocol_name.
226
227         * gpgme.texi (Engine Information): Rewritten.
228
229 2003-01-29  Marcus Brinkmann  <marcus@g10code.de>
230
231         * gpgme.texi (I/O Callback Interface): Document new even
232         GPGME_EVENT_START.
233         (Waiting For Completion): Document new possible return values.
234         (I/O Callback Interface): Document return type of GpgmeIOCb.
235
236 2003-01-29  Marcus Brinkmann  <marcus@g10code.de>
237
238         * gpgme.texi (Hooking Up Into Idle Time): Section removed.
239
240 2002-12-24  Marcus Brinkmann  <marcus@g10code.de>
241
242         * gpgme.texi (Verify): Drop R_STAT argument in gpgme_op_verify.
243         * gpgme.texi (Decrypt and Verify): Likewise for
244         gpgme_op_decrypt_verify.
245
246 2002-12-23  Marcus Brinkmann  <marcus@g10code.de>
247
248         * gpgme.texi (Information About Keys): Document that
249         GPGME_ATTR_IS_SECRET is not representable as a string anymore.
250
251 2002-12-22  Marcus Brinkmann  <marcus@g10code.de>
252
253         * gpgme.texi (Key Signatures): New section.
254         (Listing Keys): Add gpgme_get_key.
255
256 2002-12-06  Marcus Brinkmann  <marcus@g10code.de>
257
258         * gpgme.texi (Memory Based Data Buffers): New subsection.
259         (File Based Data Buffers): Likewise.
260         (Callback Based Data Buffers): Likewise.
261         (Manipulating Data Buffers): Update interfaces.  Add
262         gpgme_data_seek.
263         * gpgme.texi (Engine Version Check): Remove gpgme_check_engine.
264         
265 2002-11-21  Marcus Brinkmann  <marcus@g10code.de>
266
267         * gpgme.texi (Verify): Document the new interface.
268
269 2002-11-19  Marcus Brinkmann  <marcus@g10code.de>
270
271         * gpgme.texi (Generating Keys): Document new argument to
272         gpgme_op_genkey.
273
274 2002-11-05  Marcus Brinkmann  <marcus@g10code.de>
275
276         * gpgme.texi (Verify): Fix prototype of gpgme_get_sig_key.
277         Reported by Miguel Coca <e970095@zipi.fi.upm.es>.
278
279 2002-08-30  Marcus Brinkmann  <marcus@g10code.de>
280
281         * gpgme.texi (Selecting Signers): Fix reference count.
282
283 2002-08-21  Marcus Brinkmann  <marcus@g10code.de>
284
285         * gpgme.texi (Header): Document name space.
286
287 2002-08-20  Marcus Brinkmann  <marcus@g10code.de>
288
289         * gpgme.texi (Importing Keys): Document gpgme_op_import_ext.
290
291         * gpgme.texi (Importing Keys): Undocument EOF.
292
293 2002-08-14  Werner Koch  <wk@gnupg.org>
294
295         * gpgme.texi (Information About Keys): Changed GPGME_ATTR_TYPE.
296
297 2002-07-25  Marcus Brinkmann  <marcus@g10code.de>
298
299         * gpgme.texi (Deleting Keys): Say that secret keys might not be
300         deleted.
301
302 2002-07-25  Marcus Brinkmann  <marcus@g10code.de>
303
304         * gpgme.texi (Information About Keys): Document (badly) the new
305         key attributes.
306
307         * gpgme.texi (Manipulating Data Buffers): Mention that backend
308         tries to detect encoding automatically.
309
310 2002-07-03  Marcus Brinkmann  <marcus@g10code.de>
311
312         * gpgme.texi (Run Control): Update this section.
313         (Waiting For Completion): Likewise for this subsection.
314         (Cancelling an Operation): Likewise for this subsection.
315         (Using External Event Loops): New subsection with several
316         subsubsections.
317
318 2002-06-28  Marcus Brinkmann  <marcus@g10code.de>
319
320         * gpgme.texi (Multi Threading): Remove item about the need to
321         synchronize anything against gpgme_wait (except gpgme_wait
322         itself).
323
324 2002-06-27  Marcus Brinkmann  <marcus@g10code.de>
325
326         * gpgme.texi (Information About Keys): Fix documentation for IDX.
327         (Information About Trust Items): Likewise.
328
329 2002-06-26  Werner Koch  <wk@gnupg.org>
330
331         * gpgme.texi (Importing Keys): Document the return value -1 of
332         gpgme_op_import.
333
334 2002-06-20  Werner Koch  <wk@gnupg.org>
335
336         * gpgme.texi (Verify): Explain the new whatidx variable.
337
338 2002-06-10  Werner Koch  <wk@gnupg.org>
339
340         * gpgme.texi (Verify): Document attribute GPGME_ATTR_ERRTOK.
341
342 2002-06-04  Marcus Brinkmann  <marcus@g10code.de>
343
344         * gpgme.texi (Multi Threading): Document new autodetection.
345
346 2002-06-04  Marcus Brinkmann  <marcus@g10code.de>
347
348         * Makefile.am (DISTCLEANFILES): New variable.
349
350 2002-05-26  Marcus Brinkmann  <marcus@g10code.de>
351
352         * gpgme.texi: Some typographical correctons throughout.
353
354 2002-05-09  Marcus Brinkmann  <marcus@g10code.de>
355
356         * gpgme.texi (Using Automake): New section.
357
358 2002-05-09  Marcus Brinkmann  <marcus@g10code.de>
359
360         * gpgme.texi (Multi Threading): Escape { and }.
361
362 2002-05-09  Marcus Brinkmann  <marcus@g10code.de>
363
364         * gpgme.texi (Overview): Replace note about thread-safeness.
365         (Multi Threading): New section.
366
367 2002-05-03  Werner Koch  <wk@gnupg.org>
368
369         * gpgme.texi (Manipulating Data Buffers): Changed some data types
370         to void*.
371         (Protocol Selection): Added gpgme_get_protocol.
372         (Verify): Updated to include the new attribute fucntions and
373         status codes.
374
375 2002-04-27  Werner Koch  <wk@gnupg.org>
376
377         * gpgme.texi (Manipulating Data Buffers): New type GpgmeDataEncoding.
378
379 2002-04-23  Marcus Brinkmann  <marcus@g10code.de>
380
381         * gpgme.texi (Passphrase Callback): Document that either return
382         argument can be NULL.
383         (Progress Meter Callback): Likewise.
384
385 2002-04-22  Marcus Brinkmann  <marcus@g10code.de>
386
387         * gpgme.texi (Passphrase Callback): Fix small typo.  Document the
388         new function gpgme_get_passphrase_cb.
389         (Progress Meter Callback): Document the new function
390         gpgme_get_progress_cb.
391
392 2002-04-16  Marcus Brinkmann  <marcus@g10code.de>
393
394         * gpgme.texi (Creating a Signature): Fix function name.  Reported
395         by Wichert Ackerman <wichert@debian.org>.
396
397 2002-03-29  Marcus Brinkmann  <marcus@g10code.de>
398
399         * gpgme.texi (direntry): End index entry with a full stop.
400         Patch submitted by Jose Carlos Garcia Sogo <jsogo@debian.org>.
401         
402 2002-03-17  Marcus Brinkmann  <marcus@g10code.de>
403
404         * gpgme.texi (Detailed Results): Fix syntax error in last change.
405
406 2002-03-08  Werner Koch  <wk@gnupg.org>
407
408         * gpgme.texi (Detailed Results): Import does also return info.
409
410 2002-03-06  Marcus Brinkmann  <marcus@g10code.de>
411
412         * gpgme.texi (Encrypting a Plaintext): Document symmetric
413         encryption.
414
415 2002-03-06  Marcus Brinkmann  <marcus@g10code.de>
416
417         * gpgme.texi (Error Strings): Add example.
418         * gpgme.texi (Listing Keys): Likewise.
419
420 2002-03-03  Marcus Brinkmann  <marcus@g10code.de>
421
422         * gpgme.texi (Information About Keys): Document GPGME_ATTR_EXPIRE.
423
424 2002-03-03  Marcus Brinkmann  <marcus@g10code.de>
425
426         * gpgme.texi (Verify): Document verification of normal and
427         cleartext signatures.
428
429 2002-02-27  Marcus Brinkmann  <marcus@g10code.de>
430
431         * gpgme.texi (Listing Keys): Document gpgme_op_keylist_ext_start.
432
433 2002-02-27  Marcus Brinkmann  <marcus@g10code.de>
434
435         * gpgme.texi (Encrypting a Plaintext): Document
436         GPGME_Invalid_Recipients.
437         (Error Values): Likewise.
438
439 2002-02-26  Marcus Brinkmann  <marcus@g10code.de>
440
441         * gpgme.texi (Encrypting a Plaintext): Document
442         gpgme_op_encrypt_sign and gpgme_op_encrypt_sign_start.
443
444 2002-02-25  Marcus Brinkmann  <marcus@g10code.de>
445
446         * gpgme.texi (Creating a Signature): Add a note about
447         certificates to include.
448         (Included Certificates): New section.
449
450 2002-02-09  Marcus Brinkmann  <marcus@g10code.de>
451
452         * gpgme.texi (Detailed Results): Remove literal tags.
453         (Generating Keys): Update documentation.
454
455         * gpgme.texi (Generating Keys): Fix syntax error.
456
457 2002-02-06  Marcus Brinkmann  <marcus@g10code.de>
458
459         * gpgme.texi (Waiting For Completion): Adjust doc to changes in
460         the code.
461
462 2002-02-06  Marcus Brinkmann  <marcus@g10code.de>
463
464         * gpgme.texi (Key Listing Mode): Update documentation.
465
466 2002-01-31  Marcus Brinkmann  <marcus@g10code.de>
467
468         * gpgme.texi (Generating Keys): Document error at creation
469         failure.
470
471 2002-01-30  Marcus Brinkmann  <marcus@g10code.de>
472
473         * gpgme.texi (Deleting Keys): Document new error values.
474
475 2002-01-30  Marcus Brinkmann  <marcus@g10code.de>
476
477         * gpgme.texi (Importing Keys): Add reference to gpgme_get_op_info.
478
479 2002-01-30  Marcus Brinkmann  <marcus@g10code.de>
480
481         * gpgme.texi: Some spell checking.
482
483 2002-01-30  Marcus Brinkmann  <marcus@g10code.de>
484
485         * gpgme.texi: Add all the gpgme_op_*_start functions.
486         Fill the concept index with many, many entries.
487
488 2002-01-29  Marcus Brinkmann  <marcus@g10code.de>
489
490         * gpgme.texi (Run Control): New section.
491         (Verify): Docuent gpgme_get_notation.
492         (More Information): New section describing gpgme_get_op_info.
493
494 2002-01-22  Marcus Brinkmann  <marcus@g10code.de>
495
496         * gpgme.texi (Passphrase callback): Change GpgmePassphraseCb's
497         R_HD type from void* to void**.
498
499 2002-01-22  Marcus Brinkmann  <marcus@g10code.de>
500
501         * gpgme.texi (Creating data buffers): Change
502         gpgme_data_new_from_filepart's LENGTH type from off_t to size_t.
503
504 2002-01-22  Marcus Brinkmann  <marcus@g10code.de>
505
506         * gpgme.texi (Generating keys): New subsection.
507         (Exporting keys): Likewise.
508         (Importing keys): Likewise.
509         (Deleting keys): Likewise.
510
511 2002-01-16  Marcus Brinkmann  <marcus@g10code.de>
512
513         * gpgme.texi: g10Code -> g10 Code
514
515         * gpgme.texi (Top): Complete detailmenu.
516         
517         * gpgme.texi: Convert embarassing cruft to the real thing.
518
519 2002-01-16  Marcus Brinkmann  <marcus@g10code.de>
520
521         * ChangeLog: New file.
522         * gpgme.texi: Likewise.
523         * gpl.texi: Likewise.
524         * fdl.texi: Likewise.
525         * Makefile.am (info_TEXINFOS): New variable.
526         (gpgme_TEXINFOS): Likewise.
527
528  Copyright 2002 g10 Code GmbH
529
530  This file is free software; as a special exception the author gives
531  unlimited permission to copy and/or distribute it, with or without
532  modifications, as long as this notice is preserved.
533
534  This file is distributed in the hope that it will be useful, but
535  WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
536  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.