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