Update documentation.

Add a note about freefare_get_tags() invalidating previously found targets.
This commit is contained in:
Romain Tartiere 2010-04-26 11:09:04 +00:00
parent 1ea30f37bb
commit a0da16bf65

View file

@ -78,14 +78,14 @@ returns a NULL-terminated list of
.Vt MifareTag
present on
.Vt device .
This list has to be freed after usage by either
This list has to be freed after usage by either:
.Bl -hyphen
.It
Calling the
calling the
.Fn freefare_free_tags
function. All tags in the list are automatically freed;
.It
Calling the
calling the
.Fn freefare_free_tag
function to free each tag in the list individually, and freeing the list itself
using the
@ -93,6 +93,13 @@ using the
function.
.El
.Pp
Because of the nature of the target detection process, any previously detected
target will be in an inconsistent state after a call to
.Fn freefare_get_tags .
It is the programmer's responsibility to free these targets before calling the
.Fn freefare_get_tags
function.
.Pp
Information about a given
.Vt MifareTag
can be gathered using the