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