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