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