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