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