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