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