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