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