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