efi: fix documentation warnings
authorVincent Stehlé <vincent.stehle@arm.com>
Wed, 25 May 2022 09:20:22 +0000 (11:20 +0200)
committerHeinrich Schuchardt <heinrich.schuchardt@canonical.com>
Sat, 28 May 2022 08:59:27 +0000 (10:59 +0200)
This fixes the following warnings:

  ./lib/efi_loader/efi_firmware.c:283: warning: Function parameter or member 'package_version' not described in 'efi_firmware_fit_get_image_info'
  ./lib/efi_loader/efi_firmware.c:283: warning: Function parameter or member 'package_version_name' not described in 'efi_firmware_fit_get_image_info'
  ./lib/efi_loader/efi_firmware.c:369: warning: bad line: firmware image
  ./lib/efi_loader/efi_firmware.c:395: warning: Function parameter or member 'package_version' not described in 'efi_firmware_raw_get_image_info'
  ./lib/efi_loader/efi_firmware.c:395: warning: Function parameter or member 'package_version_name' not described in 'efi_firmware_raw_get_image_info'

Signed-off-by: Vincent Stehlé <vincent.stehle@arm.com>
Cc: Heinrich Schuchardt <xypron.glpk@gmx.de>
Reviewed-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
lib/efi_loader/efi_firmware.c

index 27953fe..fe4e084 100644 (file)
@@ -197,8 +197,8 @@ static efi_status_t efi_fill_image_desc_array(
  * @descriptor_version:                Pointer to version number
  * @descriptor_count:          Pointer to number of descriptors
  * @descriptor_size:           Pointer to descriptor size
- * package_version:            Package version
- * package_version_name:       Package version's name
+ * @package_version:           Package version
+ * @package_version_name:      Package version's name
  *
  * Return information bout the current firmware image in @image_info.
  * @image_info will consist of a number of descriptors.
@@ -296,15 +296,15 @@ const struct efi_firmware_management_protocol efi_fmp_fit = {
 
 /**
  * efi_firmware_raw_get_image_info - return information about the current
                                   firmware image
*                                  firmware image
  * @this:                      Protocol instance
  * @image_info_size:           Size of @image_info
  * @image_info:                        Image information
  * @descriptor_version:                Pointer to version number
  * @descriptor_count:          Pointer to number of descriptors
  * @descriptor_size:           Pointer to descriptor size
- * package_version:            Package version
- * package_version_name:       Package version's name
+ * @package_version:           Package version
+ * @package_version_name:      Package version's name
  *
  * Return information bout the current firmware image in @image_info.
  * @image_info will consist of a number of descriptors.