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