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