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