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