gpgme: check_version() MUST be called, but examples miss it

[Bernhard Reiter]

http://cvs.gnupg.org/cgi-bin/viewcvs.cgi/trunk/doc/gpgme.texi?rev=1298
explains for check_version()_:
          In either case, the function initializes some
          sub-systems, and for this reason alone it must be invoked early in
          your program, before you make use of the other functions in
          @acronym{GPGME}.

But the remaining examples codes in the documentation do not contain a hint
towards it. It is a must to add it in the @node I/O Callback Example .

I strongly recommend to add it to shorter examples as well as some 
(experienced) programmers will look at the examples first and might miss
the requirement to use check_version().
It could be done using a pseudo-function like
	MY_GPGME_INIT()
or 
     [init gpgme]
So people now initialisation must be done before using the snipplet.

Bernhard

-- 
Managing Director - Owner: www.intevation.net       (Free Software Company)
Germany Coordinator: fsfeurope.org. Coordinator: www.Kolab-Konsortium.com.
Intevation GmbH, Osnabrück, DE; Amtsgericht Osnabrück, HRB 18998
Geschäftsführer Frank Koormann, Bernhard Reiter, Dr. Jan-Oliver Wagner
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 1571 bytes
Desc: not available
URL: </pipermail/attachments/20080304/12f70c04/attachment.bin>