efi_loader: correct function comment style

Replace @return and @param.

Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>

diff --git a/lib/efi_loader/efi_file.c b/lib/efi_loader/efi_file.c
index 9aa003096c6c5311a14317dc4962ef337c21a00e..7a7077e6d03223ccb6aeec8c38bf7bb9bec4fd8e 100644 (file)
--- a/lib/efi_loader/efi_file.c
+++ b/lib/efi_loader/efi_file.c
@@ -1084,7 +1084,7 @@ static const struct efi_file_handle efi_file_handle_protocol = {
  * efi_file_from_path() - open file via device path
  *
  * @fp:                device path
- * @return:    EFI_FILE_PROTOCOL for the file or NULL
+ * Return:     EFI_FILE_PROTOCOL for the file or NULL
  */
 struct efi_file_handle *efi_file_from_path(struct efi_device_path *fp)
 {

diff --git a/lib/efi_loader/efi_freestanding.c b/lib/efi_loader/efi_freestanding.c
index bd0dff162f6b8f129f381273f8d2500509e33640..c85df026f0dd1c5a904dc7ad7ff6307ae7e332b4 100644 (file)
--- a/lib/efi_loader/efi_freestanding.c
+++ b/lib/efi_loader/efi_freestanding.c
@@ -97,8 +97,8 @@ void *memset(void *s, int c, size_t n)
  *
  * We do nothing here.
  *
- * @param func_ptr     Pointer to function being entered
- * @param caller       Pointer to function which called this function
+ * func_ptr:   Pointer to function being entered
+ * caller:     Pointer to function which called this function
  */
 void __attribute__((no_instrument_function))
 __cyg_profile_func_enter(void *func_ptr, void *caller)
@@ -113,8 +113,8 @@ __cyg_profile_func_enter(void *func_ptr, void *caller)
  *
  * We do nothing here.
  *
- * @param func_ptr     Pointer to function being entered
- * @param caller       Pointer to function which called this function
+ * func_ptr:   Pointer to function being entered
+ * caller:     Pointer to function which called this function
  */
 void __attribute__((no_instrument_function))
 __cyg_profile_func_exit(void *func_ptr, void *caller)

diff --git a/lib/efi_loader/efi_gop.c b/lib/efi_loader/efi_gop.c
index 7683a34a965709dd5bbd6b3b7230b79fa5677fb5..2c81859807357d00c6e92bd88bfaaaef79eb294e 100644 (file)
--- a/lib/efi_loader/efi_gop.c
+++ b/lib/efi_loader/efi_gop.c
@@ -407,7 +407,7 @@ out:
  * @width:     width of rectangle
  * @height:    height of rectangle
  * @delta:     length in bytes of a line in the pixel buffer (optional)
- * @return:    status code
+ * Return:     status code
  */
 efi_status_t EFIAPI gop_blt(struct efi_gop *this, struct efi_gop_pixel *buffer,
                            u32 operation, efi_uintn_t sx,

diff --git a/lib/efi_loader/helloworld.c b/lib/efi_loader/helloworld.c
index 3f215e2a46e8e76e1165137b4cfe180332d76bc2..33e4fbc7c80072a1c110bd31ceaebf970f2b1aad 100644 (file)
--- a/lib/efi_loader/helloworld.c
+++ b/lib/efi_loader/helloworld.c
@@ -133,7 +133,7 @@ efi_status_t print_device_path(struct efi_device_path *device_path,
  *
  * @handle:    handle of the loaded image
  * @systab:    system table
- * @return:    status code
+ * Return:     status code
  */
 efi_status_t EFIAPI efi_main(efi_handle_t handle,
                             struct efi_system_table *systab)

diff --git a/lib/efi_selftest/dtbdump.c b/lib/efi_selftest/dtbdump.c
index ed3b985cabdc4aff44493e354d155439fdac57d5..6e1eaa4ef06a1e50f8ce364dfdf6fa838aa1cb6a 100644 (file)
--- a/lib/efi_selftest/dtbdump.c
+++ b/lib/efi_selftest/dtbdump.c
@@ -495,7 +495,7 @@ efi_status_t do_save(u16 *filename)
  *
  * @handle:    handle of the loaded image
  * @systab:    system table
- * @return:    status code
+ * Return:     status code
  */
 efi_status_t EFIAPI efi_main(efi_handle_t image_handle,
                             struct efi_system_table *systab)

diff --git a/lib/efi_selftest/efi_selftest.c b/lib/efi_selftest/efi_selftest.c
index 3da34b1d46d2748e4b9355e97f6143d2a77089a1..474a8b8728f3ee032eddc6aafad5071a868270dc 100644 (file)
--- a/lib/efi_selftest/efi_selftest.c
+++ b/lib/efi_selftest/efi_selftest.c
@@ -149,7 +149,7 @@ static int teardown(struct efi_unit_test *test, unsigned int *failures)
  * Check that a test requiring reset exists.
  *
  * @testname:  name of the test
- * @return:    test, or NULL if not found
+ * Return:     test, or NULL if not found
  */
 static bool need_reset(const u16 *testname)
 {
@@ -170,7 +170,7 @@ static bool need_reset(const u16 *testname)
  * Check that a test exists.
  *
  * @testname:  name of the test
- * @return:    test, or NULL if not found
+ * Return:     test, or NULL if not found
  */
 static struct efi_unit_test *find_test(const u16 *testname)
 {

diff --git a/lib/efi_selftest/efi_selftest_bitblt.c b/lib/efi_selftest/efi_selftest_bitblt.c
index fb33150c4b2a6dfca6c941db02d1a12d11a5b56a..1def843505431d80cc8fca89ca44cfad024d5c7f 100644 (file)
--- a/lib/efi_selftest/efi_selftest_bitblt.c
+++ b/lib/efi_selftest/efi_selftest_bitblt.c
@@ -94,7 +94,7 @@ static void EFIAPI notify(struct efi_event *event, void *context)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -198,7 +198,7 @@ static int setup(const efi_handle_t handle,
 /*
  * Tear down unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {
@@ -225,7 +225,7 @@ static int teardown(void)
 /*
  * Execute unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_block_device.c b/lib/efi_selftest/efi_selftest_block_device.c
index ad53dac796ba3a4c102b784558518ce5780bbcc8..62b3e04db8769ebc380bb118e00341bc5351ff90 100644 (file)
--- a/lib/efi_selftest/efi_selftest_block_device.c
+++ b/lib/efi_selftest/efi_selftest_block_device.c
@@ -180,7 +180,7 @@ static efi_handle_t disk_handle;
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -240,7 +240,7 @@ static int setup(const efi_handle_t handle,
 /*
  * Tear down unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {
@@ -292,7 +292,7 @@ static efi_uintn_t dp_size(struct efi_device_path *dp)
 /*
  * Execute unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_config_table.c b/lib/efi_selftest/efi_selftest_config_table.c
index 2bf12b5bb68e4d8c3be31a94a3b96eda81770216..1961e299348e472b41846eb10be4dba3e60d91e1 100644 (file)
--- a/lib/efi_selftest/efi_selftest_config_table.c
+++ b/lib/efi_selftest/efi_selftest_config_table.c
@@ -68,7 +68,7 @@ static int check_table(const void *table)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -85,7 +85,7 @@ static int setup(const efi_handle_t handle,
  * A table is installed, updated, removed. The table entry and the
  * triggering of events is checked.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_console.c b/lib/efi_selftest/efi_selftest_console.c
index 3187e104c4414b933b862336df8326f1dc44c9b8..fd2b3d09abc25598c78e88124f40fd16e76a047b 100644 (file)
--- a/lib/efi_selftest/efi_selftest_console.c
+++ b/lib/efi_selftest/efi_selftest_console.c
@@ -274,7 +274,7 @@ void efi_st_printc(int color, const char *fmt, ...)
 /*
  * Reads an Unicode character from the input device.
  *
- * @return: Unicode character
+ * Return: Unicode character
  */
 u16 efi_st_get_key(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_crc32.c b/lib/efi_selftest/efi_selftest_crc32.c
index 19153c759aad975010d6d41acf17307b4d345f00..f2be35314a5344ecb94d1405b9306f7bfedfe899 100644 (file)
--- a/lib/efi_selftest/efi_selftest_crc32.c
+++ b/lib/efi_selftest/efi_selftest_crc32.c
@@ -68,7 +68,7 @@ static int check_table(const void *table)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -112,7 +112,7 @@ static int setup(const efi_handle_t handle,
  *
  * Check tables after ExitBootServices()
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_devicepath_util.c b/lib/efi_selftest/efi_selftest_devicepath_util.c
index c846e057d3532bf1f505aef07366244ea316173e..1801e30756ab1bc9b9bf1123eb10c488ed7cff41 100644 (file)
--- a/lib/efi_selftest/efi_selftest_devicepath_util.c
+++ b/lib/efi_selftest/efi_selftest_devicepath_util.c
@@ -49,7 +49,7 @@ static int setup(const efi_handle_t img_handle,
  *
  * @length:    length of the media device node
  * @dp:                device path
- * @return:    status code
+ * Return:     status code
  */
 static int create_single_node_device_path(unsigned int length,
                                          struct efi_device_path **dp)

diff --git a/lib/efi_selftest/efi_selftest_esrt.c b/lib/efi_selftest/efi_selftest_esrt.c
index 99793dee72ebe2f54cb853c6a0bcb33306080199..922ff253c72cf71a266e281d03f2e0323514b094 100644 (file)
--- a/lib/efi_selftest/efi_selftest_esrt.c
+++ b/lib/efi_selftest/efi_selftest_esrt.c
@@ -108,7 +108,7 @@ static void *lib_test_get_esrt(void)
  * @esrt: pointer to the ESRT
  * @img_info: an image_info_descriptor output by the FMP get_image_info
  *
- * @return: true if matching ESRT entry is found and if all the ESRT entry fields match the
+ * Return: true if matching ESRT entry is found and if all the ESRT entry fields match the
  * corresponding @img_info fields.
  */
 static bool lib_test_check_uuid_entry(struct efi_system_resource_table *esrt,
@@ -168,7 +168,7 @@ static bool lib_test_check_uuid_entry(struct efi_system_resource_table *esrt,
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -185,7 +185,7 @@ static int setup(const efi_handle_t handle,
  *
  * Uninstall the test FMP.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_event_groups.c b/lib/efi_selftest/efi_selftest_event_groups.c
index 6dcde50648b8da1c55289f826257891f7ccc7a3c..7a6d9fb162339c14a3fba8674f6fac413d7d46c8 100644 (file)
--- a/lib/efi_selftest/efi_selftest_event_groups.c
+++ b/lib/efi_selftest/efi_selftest_event_groups.c
@@ -38,7 +38,7 @@ static void EFIAPI notify(struct efi_event *event, void *context)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -54,7 +54,7 @@ static int setup(const efi_handle_t handle,
  * Create multiple events in an event group. Signal each event once and check
  * that all events are notified once in each round.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_events.c b/lib/efi_selftest/efi_selftest_events.c
index 1077cbdf9e6aa88a4468065cd03cac249dfd086a..90071536a27eb325277f582ee6231bef1c67ff2b 100644 (file)
--- a/lib/efi_selftest/efi_selftest_events.c
+++ b/lib/efi_selftest/efi_selftest_events.c
@@ -39,7 +39,7 @@ static void EFIAPI notify(struct efi_event *event, void *context)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -69,7 +69,7 @@ static int setup(const efi_handle_t handle,
  *
  * Close the events created in setup.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {
@@ -103,7 +103,7 @@ static int teardown(void)
  * Run a 100 ms single shot timer and check that it is called once
  * while waiting for 100 ms periodic timer for two periods.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_exception.c b/lib/efi_selftest/efi_selftest_exception.c
index d86228a89260c73873f7aee055b8a63e250922b3..dca7f7d3434daf60b22488be9e0fc92ee6f1df79 100644 (file)
--- a/lib/efi_selftest/efi_selftest_exception.c
+++ b/lib/efi_selftest/efi_selftest_exception.c
@@ -99,7 +99,7 @@ static efi_status_t decompress(u8 **image)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -118,7 +118,7 @@ static int setup(const efi_handle_t handle,
  *
  * Load and start the application image.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_exitbootservices.c b/lib/efi_selftest/efi_selftest_exitbootservices.c
index 59ab15407a00b875b60209f992ad31f76b2d51bf..f5e0d9da89bb58ff7fadb57d81fbd7d973fdd438 100644 (file)
--- a/lib/efi_selftest/efi_selftest_exitbootservices.c
+++ b/lib/efi_selftest/efi_selftest_exitbootservices.c
@@ -63,7 +63,7 @@ static void EFIAPI ebs_notify(struct efi_event *event, void *context)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -101,7 +101,7 @@ static int setup(const efi_handle_t handle,
  * Call ExitBootServices again and check that the notification function is
  * not called again.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_fdt.c b/lib/efi_selftest/efi_selftest_fdt.c
index 739f029b8c73369e9eb25a0403306f8b5cb2f4f3..70fe06e0c47eee790cc95684d14a956e4fc6e570 100644 (file)
--- a/lib/efi_selftest/efi_selftest_fdt.c
+++ b/lib/efi_selftest/efi_selftest_fdt.c
@@ -165,7 +165,7 @@ static void *efi_st_get_config_table(const efi_guid_t *guid)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t img_handle,
                 const struct efi_system_table *systable)
@@ -192,7 +192,7 @@ static int setup(const efi_handle_t img_handle,
 /*
  * Execute unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_gop.c b/lib/efi_selftest/efi_selftest_gop.c
index d64294ac79d7dbe66577715e6b9d223322fd4927..e500752fdaa474fbc3341d470d93ff45dd448353 100644 (file)
--- a/lib/efi_selftest/efi_selftest_gop.c
+++ b/lib/efi_selftest/efi_selftest_gop.c
@@ -18,7 +18,7 @@ static struct efi_gop *gop;
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -39,7 +39,7 @@ static int setup(const efi_handle_t handle,
 /*
  * Tear down unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {
@@ -49,7 +49,7 @@ static int teardown(void)
 /*
  * Execute unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_hii.c b/lib/efi_selftest/efi_selftest_hii.c
index f4b70f795085e8245d61d4c7afdf6c922897980c..66ccec1e3f02b9b18fc2a314a3dcbe77158760b5 100644 (file)
--- a/lib/efi_selftest/efi_selftest_hii.c
+++ b/lib/efi_selftest/efi_selftest_hii.c
@@ -28,7 +28,7 @@ static struct efi_hii_string_protocol *hii_string_protocol;
  * @handle:    handle of the loaded image
  * @systable:  system table
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -1033,7 +1033,7 @@ static int test_hii_string_protocol(void)
 /*
  * Execute unit test.
  *
- * @return:    EFI_ST_SUCCESS for success, EFI_ST_FAILURE for failure
+ * Return:     EFI_ST_SUCCESS for success, EFI_ST_FAILURE for failure
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_load_file.c b/lib/efi_selftest/efi_selftest_load_file.c
index bf955cbf6630cb18903897d351f4788b84e2283c..bac0e6b61de3acb8eee39111f2be85b9e4f78bf0 100644 (file)
--- a/lib/efi_selftest/efi_selftest_load_file.c
+++ b/lib/efi_selftest/efi_selftest_load_file.c
@@ -284,7 +284,7 @@ static struct efi_load_file_protocol lf2_prot = {load_file2};
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int efi_st_load_file_setup(const efi_handle_t handle,
                                  const struct efi_system_table *systable)
@@ -326,7 +326,7 @@ static int efi_st_load_file_setup(const efi_handle_t handle,
 /*
  * Tear down unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int efi_st_load_file_teardown(void)
 {
@@ -377,7 +377,7 @@ static int efi_st_load_file_teardown(void)
  * Try loading an image via the EFI_LOAD_FILE_PROTOCOL and the
  * EFI_LOAD_FILE2_PROTOCOL. Finally execute the image.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int efi_st_load_file_execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_loadimage.c b/lib/efi_selftest/efi_selftest_loadimage.c
index 4975d80ff1cbb63eb4784f1fa6bf8e52f8c8d05d..72c8d5168761260599844b8319b727c9fff707e8 100644 (file)
--- a/lib/efi_selftest/efi_selftest_loadimage.c
+++ b/lib/efi_selftest/efi_selftest_loadimage.c
@@ -411,7 +411,7 @@ static efi_status_t decompress(u8 **image)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -447,7 +447,7 @@ static int setup(const efi_handle_t handle,
  *
  * Uninstall protocols and free memory.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {
@@ -486,7 +486,7 @@ static int teardown(void)
  *
  * Load and start the application image.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_miniapp_exit.c b/lib/efi_selftest/efi_selftest_miniapp_exit.c
index 6b5cfb01cf706b65a056d6becfbbf5d538ab485f..2ea19f20ed2d8538e1365746a31b196a97047998 100644 (file)
--- a/lib/efi_selftest/efi_selftest_miniapp_exit.c
+++ b/lib/efi_selftest/efi_selftest_miniapp_exit.c
@@ -21,7 +21,7 @@ static efi_guid_t loaded_image_protocol_guid = EFI_LOADED_IMAGE_PROTOCOL_GUID;
  *
  * @image_handle:      handle of the loaded image
  * @systable:          system table
- * @return:            status code
+ * Return:             status code
  */
 static efi_status_t EFIAPI check_loaded_image_protocol
                (efi_handle_t image_handle, struct efi_system_table *systable)
@@ -60,7 +60,7 @@ static efi_status_t EFIAPI check_loaded_image_protocol
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    status code
+ * Return:     status code
  */
 efi_status_t EFIAPI efi_main(efi_handle_t handle,
                             struct efi_system_table *systable)

diff --git a/lib/efi_selftest/efi_selftest_reset.c b/lib/efi_selftest/efi_selftest_reset.c
index 8b6ac24cb15ac1f2a4444210b0bb8a2b5a148303..f888054894c6cefd07070cd355657fc60047b696 100644 (file)
--- a/lib/efi_selftest/efi_selftest_reset.c
+++ b/lib/efi_selftest/efi_selftest_reset.c
@@ -17,7 +17,7 @@ static struct efi_runtime_services *runtime;
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -29,7 +29,7 @@ static int setup(const efi_handle_t handle,
 /*
  * Execute unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_rng.c b/lib/efi_selftest/efi_selftest_rng.c
index fca9749d072d8fda10d050c601caab7f6d9b32b6..007d1c82e9a1278a9e711c7de0e83a49498056ac 100644 (file)
--- a/lib/efi_selftest/efi_selftest_rng.c
+++ b/lib/efi_selftest/efi_selftest_rng.c
@@ -20,7 +20,7 @@ static efi_guid_t efi_rng_guid = EFI_RNG_PROTOCOL_GUID;
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -35,7 +35,7 @@ static int setup(const efi_handle_t handle,
  * Retrieve available RNG algorithms.
  * Retrieve two random values and compare them.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_rtc.c b/lib/efi_selftest/efi_selftest_rtc.c
index 6f7035dee616968fc1a56e0cacec32af798d87a2..e9e47e96c4bbd40b267bb09e3e26b7fdae09393a 100644 (file)
--- a/lib/efi_selftest/efi_selftest_rtc.c
+++ b/lib/efi_selftest/efi_selftest_rtc.c
@@ -19,7 +19,7 @@ static struct efi_runtime_services *runtime;
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -35,7 +35,7 @@ static int setup(const efi_handle_t handle,
  * Set a new value and read it back.
  * Set the real time clock back the current time.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_set_virtual_address_map.c b/lib/efi_selftest/efi_selftest_set_virtual_address_map.c
index 8e2e8ba17208284ac533735ca26ce5fc5f97acd6..d28ed83eb3713c1032b46bff2365c6074ebd6d20 100644 (file)
--- a/lib/efi_selftest/efi_selftest_set_virtual_address_map.c
+++ b/lib/efi_selftest/efi_selftest_set_virtual_address_map.c
@@ -73,7 +73,7 @@ static void EFIAPI notify(struct efi_event *event, void *context)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -176,7 +176,7 @@ static int setup(const efi_handle_t handle,
  * The triggering of the EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE event is checked via
  * the call count of the notification function.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_snp.c b/lib/efi_selftest/efi_selftest_snp.c
index 818cbfcacd49557332920c9b1c049c7427923e78..15af8d3e18c92fcbde143c618f8582a5c6d89fb8 100644 (file)
--- a/lib/efi_selftest/efi_selftest_snp.c
+++ b/lib/efi_selftest/efi_selftest_snp.c
@@ -77,7 +77,7 @@ static unsigned int net_ip_id;
  *
  * @buf:       IP header
  * @len:       length of header in bytes
- * @return:    checksum
+ * Return:     checksum
  */
 static unsigned int efi_ip_checksum(const void *buf, size_t len)
 {
@@ -175,7 +175,7 @@ static efi_status_t send_dhcp_discover(void)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -282,7 +282,7 @@ static int setup(const efi_handle_t handle,
  * A DHCP discover message is sent. The test is successful if a
  * DHCP reply is received within 10 seconds.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {
@@ -422,7 +422,7 @@ received:
  * Close the timer event created in setup.
  * Shut down the network adapter.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_startimage_exit.c b/lib/efi_selftest/efi_selftest_startimage_exit.c
index 5d4c0a69725fab83f5f58dd67706efbdf84d090d..b65a10b7a4bf7edf1eda2a7c83019175d8ecb18d 100644 (file)
--- a/lib/efi_selftest/efi_selftest_startimage_exit.c
+++ b/lib/efi_selftest/efi_selftest_startimage_exit.c
@@ -79,7 +79,7 @@ static efi_status_t decompress(u8 **image)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -96,7 +96,7 @@ static int setup(const efi_handle_t handle,
 /*
  * Tear down unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {
@@ -117,7 +117,7 @@ static int teardown(void)
  *
  * Load and start the application image.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_startimage_return.c b/lib/efi_selftest/efi_selftest_startimage_return.c
index 44c23644eab45296895037abe06707b388970780..3e0c5a9ffbc0cc6811ff150cdb04c54bf44e0280 100644 (file)
--- a/lib/efi_selftest/efi_selftest_startimage_return.c
+++ b/lib/efi_selftest/efi_selftest_startimage_return.c
@@ -79,7 +79,7 @@ static efi_status_t decompress(u8 **image)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -96,7 +96,7 @@ static int setup(const efi_handle_t handle,
 /*
  * Tear down unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {
@@ -117,7 +117,7 @@ static int teardown(void)
  *
  * Load and start the application image.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_tcg2.c b/lib/efi_selftest/efi_selftest_tcg2.c
index 2eed588eea6d7f275059b4b4883b2a97e8b63060..a2b4a79e9b24e3322a471c61738cbb47a9b14c5e 100644 (file)
--- a/lib/efi_selftest/efi_selftest_tcg2.c
+++ b/lib/efi_selftest/efi_selftest_tcg2.c
@@ -612,7 +612,7 @@ static efi_status_t setup_smbios_table(const struct efi_system_table *systable)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    status code
+ * Return:     status code
  */
 static int efi_st_tcg2_setup(const efi_handle_t img_handle,
                             const struct efi_system_table *systable)
@@ -949,7 +949,7 @@ static int efi_st_tcg2_execute(void)
 /*
  * efi_st_tcg2_teardown() - Tear down unit test
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int efi_st_tcg2_teardown(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_textinput.c b/lib/efi_selftest/efi_selftest_textinput.c
index b90671cdd207c0a9ec7ffd487047b6532ddce6f0..141856a4cf6ce87c4dcd924ab54ea916737af897 100644 (file)
--- a/lib/efi_selftest/efi_selftest_textinput.c
+++ b/lib/efi_selftest/efi_selftest_textinput.c
@@ -21,7 +21,7 @@ static struct efi_boot_services *boottime;
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -34,7 +34,7 @@ static int setup(const efi_handle_t handle,
 /*
  * Execute unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_textinputex.c b/lib/efi_selftest/efi_selftest_textinputex.c
index de44224ce1c08800ef45275989dfe54f7df666b4..bd221d62546ad84a9c5e338ef44c0e1d73c3733d 100644 (file)
--- a/lib/efi_selftest/efi_selftest_textinputex.c
+++ b/lib/efi_selftest/efi_selftest_textinputex.c
@@ -45,7 +45,7 @@ static efi_status_t EFIAPI efi_key_notify_function
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -93,7 +93,7 @@ static int setup(const efi_handle_t handle,
  *
  * Unregister notify function.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {
@@ -112,7 +112,7 @@ static int teardown(void)
 /*
  * Execute unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_textoutput.c b/lib/efi_selftest/efi_selftest_textoutput.c
index a87f65e197fea1eea71a69524c2f68d54b53c295..450fe97e620207fcdcf73e6c5b278a98e69d733e 100644 (file)
--- a/lib/efi_selftest/efi_selftest_textoutput.c
+++ b/lib/efi_selftest/efi_selftest_textoutput.c
@@ -15,7 +15,7 @@
 /*
  * Execute unit test.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_tpl.c b/lib/efi_selftest/efi_selftest_tpl.c
index 0c0e412ae224615a4c91487ef579172a526d3416..f4e467267e5388a30595d4811c9eca1e2768dbf2 100644 (file)
--- a/lib/efi_selftest/efi_selftest_tpl.c
+++ b/lib/efi_selftest/efi_selftest_tpl.c
@@ -37,7 +37,7 @@ static void EFIAPI notify(struct efi_event *event, void *context)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -68,7 +68,7 @@ static int setup(const efi_handle_t handle,
  *
  * Close the events created in setup.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {
@@ -106,7 +106,7 @@ static int teardown(void)
  * Lower the TPL level and check that the queued notification
  * function is called.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_unaligned.c b/lib/efi_selftest/efi_selftest_unaligned.c
index 1802948e6750e67e14f5fcde44828d8ffecacab9..6fce110b76f7636bd048e8e5e7155123e9f50e0d 100644 (file)
--- a/lib/efi_selftest/efi_selftest_unaligned.c
+++ b/lib/efi_selftest/efi_selftest_unaligned.c
@@ -19,7 +19,7 @@ struct aligned_buffer {
  * occurs.
  *
  * @addr:      address to read
- * @return:    value at the address
+ * Return:     value at the address
  */
 static inline u32 deref(u32 *addr)
 {
@@ -37,7 +37,7 @@ static inline u32 deref(u32 *addr)
  * Execute unit test.
  * An unaligned memory access is executed. The result is checked.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/efi_selftest_watchdog.c b/lib/efi_selftest/efi_selftest_watchdog.c
index cbc6761721ce518eb61c66eeb04973381be6e09e..a352d4a5adfe809e2119067c3aafb3e9fc88d2b3 100644 (file)
--- a/lib/efi_selftest/efi_selftest_watchdog.c
+++ b/lib/efi_selftest/efi_selftest_watchdog.c
@@ -65,7 +65,7 @@ static void EFIAPI notify(struct efi_event *event, void *context)
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup(const efi_handle_t handle,
                 const struct efi_system_table *systable)
@@ -98,7 +98,7 @@ static int setup(const efi_handle_t handle,
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup_timer(const efi_handle_t handle,
                       const struct efi_system_table *systable)
@@ -112,7 +112,7 @@ static int setup_timer(const efi_handle_t handle,
  *
  * @handle:    handle of the loaded image
  * @systable:  system table
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int setup_reboot(const efi_handle_t handle,
                        const struct efi_system_table *systable)
@@ -126,7 +126,7 @@ static int setup_reboot(const efi_handle_t handle,
  *
  * Close the events created in setup.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int teardown(void)
 {
@@ -166,7 +166,7 @@ static int teardown(void)
  * Run a 1350 ms single shot timer and check that the 600ms timer has
  * been called 2 times.
  *
- * @return:    EFI_ST_SUCCESS for success
+ * Return:     EFI_ST_SUCCESS for success
  */
 static int execute(void)
 {

diff --git a/lib/efi_selftest/initrddump.c b/lib/efi_selftest/initrddump.c
index 325951b49860dac473c9a1aeb9e518523a7bff55..efdcf0dd50cfd1a9dfc2bb05623b438229a1c036 100644 (file)
--- a/lib/efi_selftest/initrddump.c
+++ b/lib/efi_selftest/initrddump.c
@@ -405,7 +405,7 @@ out:
  *
  * @handle:    handle of the loaded image
  * @systab:    system table
- * @return:    status code
+ * Return:     status code
  */
 efi_status_t EFIAPI efi_main(efi_handle_t image_handle,
                             struct efi_system_table *systab)