depau/libfprint
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

lib: Document FP_IMG_DEV

Browse source 
...and add "Returns" docs to fpi-dev.c

We might need to do this more, documenting what the function does in
prose, as well as a short explanation of the returned data.
This commit is contained in:
Bastien Nocera 2018-11-12 14:55:17 +01:00
parent 46ad86fab2
commit e57f037a10
1 changed files with 12 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
libfprint/fpi-dev.c
View file

@ -35,6 +35,8 @@
* @dev: a struct #fp_img_dev * @dev: a struct #fp_img_dev
* *
* Returns the struct #fp_dev associated with @dev, or %NULL on failure. * Returns the struct #fp_dev associated with @dev, or %NULL on failure.
*
* Returns: a struct #fp_dev or %NULL
*/ */
struct fp_dev * struct fp_dev *
FP_DEV(struct fp_img_dev *dev) FP_DEV(struct fp_img_dev *dev)
@ -50,7 +52,9 @@ FP_DEV(struct fp_img_dev *dev)
* FP_IMG_DEV: * FP_IMG_DEV:
* @dev: a struct #fp_dev representing an imaging device. * @dev: a struct #fp_dev representing an imaging device.
* *
* Returns: a struct #fp_img_dev or %NULL on failure. * Returns a struct #fp_img_dev associated with @dev, or %NULL on failure.
*
* Returns: a struct #fp_img_dev or %NULL
*/ */
struct fp_img_dev * struct fp_img_dev *
FP_IMG_DEV(struct fp_dev *dev) FP_IMG_DEV(struct fp_dev *dev)
@ -102,7 +106,10 @@ FP_INSTANCE_DATA (struct fp_dev *dev)
* fpi_dev_get_usb_dev: * fpi_dev_get_usb_dev:
* @dev: a struct #fp_dev * @dev: a struct #fp_dev
* *
* Return the #libusb_device_handle for this device. * Returns the #libusb_device_handle associated with @dev or %NULL
* if none are associated.
*
* Returns: a #libusb_device_handle pointer or %NULL
*/ */
libusb_device_handle * libusb_device_handle *
fpi_dev_get_usb_dev(struct fp_dev *dev) fpi_dev_get_usb_dev(struct fp_dev *dev)
@ -130,9 +137,11 @@ fpi_dev_set_nr_enroll_stages(struct fp_dev *dev,
* fpi_dev_get_verify_data: * fpi_dev_get_verify_data:
* @dev: a struct #fp_dev * @dev: a struct #fp_dev
* *
* Returns the verify data associated with this instance of the device. * Returns the verify data associated with @dev.
* This is usually only necessary for primitive devices which need to * This is usually only necessary for primitive devices which need to
* have access to the raw verify data as it might have been stored on disk. * have access to the raw verify data as it might have been stored on disk.
*
* Returns: a struct #fp_print_data pointer or %NULL
*/ */
struct fp_print_data * struct fp_print_data *
fpi_dev_get_verify_data(struct fp_dev *dev) fpi_dev_get_verify_data(struct fp_dev *dev)