Re: API Docs improvement
Ludovic Rousseau <[email protected]>
| Newsgroups | gmane.comp.lib.muscle |
|---|---|
| Message-ID | <CAGstE8Aa5d2h3-Oe9d4wb_ds-tR+6Bj_hNUr0rT2kss8FZQksA@mail.gmail.com> |
2016-03-09 18:47 GMT+01:00 Maksim Ivanov <[email protected]>: > Hello all, > Hello Maksim, > Several improvement suggestions for the PC/SC-Lite API documentation: > > * SCardGetStatusChange: Indicate that the return code SCARD_E_CANCELLED is > possible. > Fixed in f590a950283ca46cb0f3e8b3a640254c61f31ff2 > > * SCardEstablishContext: the mentioned SCARD_SCOPE_GLOBAL value of the > dwScope argument is not defined in any public header file. > Fixed in a9dbb3c3ca1527228711f3e6c61fee15a1a80971 > * SCardStatus: There is some mess regarding whether the reader name is a > multi-string or a simple string: the argument mszReaderName is sometimes > referred as szReaderName; the documentation of the pcchReaderLen argument > also says "multistring". > Fixed in 2a80f615fc5084838a9c299609fa468772fae71b > * SCardTransmit: the pioSendPci argument is marked as [in,out], while > actually it's an input-only argument (it's even a pointer-to-const). > Fixed in bfc6c15ec7b5941efaa48a1c1e5ff7d2cd8b0fa4 > * SCardTransmit: the example code passes a pointer to > uninitialized SCARD_IO_REQUEST structure as the pioRecvPci argument value - > while it's an in-out argument (and the SCardTransmit implementation > actually reads data from it). > Fixed in aed8486d13da8de4a77b620e28c617cc9cb18cd9 > * SCardListReaderGroups: It is stated that SCARD_E_INVALID_PARAMETER is > returned when the mszGroups argument value is NULL, while it doesn't > mention that this only happens when *pcchGroups is equal to > SCARD_AUTOALLOCATE. > Fixed in 43bac6981940ae3e8f05122342df6515aacb7fe8 Thanks. Great work. -- Dr. Ludovic Rousseau _______________________________________________ Pcsclite-muscle mailing list [email protected] http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pcsclite-muscle