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