doxygen: use correct comment syntax
authorSpencer Oliver <spen@spen-soft.co.uk>
Mon, 6 Feb 2012 11:27:04 +0000 (11:27 +0000)
committerSpencer Oliver <spen@spen-soft.co.uk>
Mon, 6 Feb 2012 12:55:03 +0000 (12:55 +0000)
This issue was caused by uncrustify not correctly converting the doxygen
comments.

Signed-off-by: Spencer Oliver <spen@spen-soft.co.uk>
Change-Id: Ie6dc3b057a08603b670cb27312e5f0d989426e6c
Reviewed-on: http://openocd.zylin.com/431
Tested-by: jenkins
src/flash/mflash.c
src/flash/nand/core.h
src/flash/nand/driver.h
src/flash/nor/lpc2900.c
src/helper/binarybuffer.c
src/helper/command.c
src/helper/command.h
src/helper/time_support.h
src/jtag/core.c

index 3d927c4549375349ccb3423a43c7093d4d8de724..bf61a11495fdf3d319bea530eb4f1a58072230d5 100644 (file)
@@ -1395,7 +1395,7 @@ COMMAND_HANDLER(mg_bank_cmd)
 
        mflash_bank = calloc(sizeof(struct mflash_bank), 1);
        COMMAND_PARSE_NUMBER(u32, CMD_ARGV[1], mflash_bank->base);
-       /* / @todo Verify how this parsing should work, then document it. */
+       /** @todo Verify how this parsing should work, then document it. */
        char *str;
        mflash_bank->rst_pin.num = strtoul(CMD_ARGV[2], &str, 0);
        if (*str)
index 04510845c4b546fd736bd716c7aa490e4c60aeee..2f5a2f8bf1baef03a33725fa3791e736684b3daf 100644 (file)
@@ -218,7 +218,7 @@ int nand_calculate_ecc_kw(struct nand_device *nand,
 
 int nand_register_commands(struct command_context *cmd_ctx);
 
-/* / helper for parsing a nand device command argument string */
+/** helper for parsing a nand device command argument string */
 COMMAND_HELPER(nand_command_get_device, unsigned name_index,
        struct nand_device **nand);
 
index caf32197e2c4a6453a581c6e9ba58975ee31a164..d49b943407acc0af578a88594e7a49ee480ae265 100644 (file)
@@ -90,7 +90,7 @@ struct nand_flash_controller {
  */
 struct nand_flash_controller *nand_driver_find_by_name(const char *name);
 
-/* / Signature for callback functions passed to nand_driver_walk */
+/** Signature for callback functions passed to nand_driver_walk */
 typedef int (*nand_driver_walker_t)(struct nand_flash_controller *c, void *);
 /**
  * Walk the list of drivers, encapsulating the data structure type.
index f6a981dd46a2b1f35f6bc9a92f615451de3f6d37..5701670b29cb6b14a740a0bef4b90cf247974dfb 100644 (file)
@@ -896,7 +896,7 @@ static const struct command_registration lpc2900_command_handlers[] = {
        COMMAND_REGISTRATION_DONE
 };
 
-/* / Evaluate flash bank command. */
+/** Evaluate flash bank command. */
 FLASH_BANK_COMMAND_HANDLER(lpc2900_flash_bank_command)
 {
        struct lpc2900_flash_bank *lpc2900_info;
index 3f7a876bae384bdeebe257ffc7fad62c96b0ee9c..74af53a95a9694ab36fba50462cd00d8cd7821fc 100644 (file)
@@ -238,7 +238,7 @@ char *buf_to_str(const void *_buf, unsigned buf_len, unsigned radix)
        return str;
 }
 
-/* / identify radix, and skip radix-prefix (0, 0x or 0X) */
+/** identify radix, and skip radix-prefix (0, 0x or 0X) */
 static void str_radix_guess(const char **_str, unsigned *_str_len,
        unsigned *_radix)
 {
index 6f7dcadc95f2f8dbb69f4fd8ae9f16e35c185dbb..c218f3fc0b9afabbfbf4df6fe915ebac2955ce03 100644 (file)
@@ -291,7 +291,7 @@ static struct command **command_list_for_parent(
 
 static void command_free(struct command *c)
 {
-       /* / @todo if command has a handler, unregister its jim command! */
+       /** @todo if command has a handler, unregister its jim command! */
 
        while (NULL != c->children) {
                struct command *tmp = c->children;
index 7c8c0121bf4e03b19b0208bc3fbe97af392a987a..01316a1a56d1c23292ac2bb3ec8411f515e3916d 100644 (file)
@@ -52,7 +52,7 @@ enum command_mode {
 
 struct command_context;
 
-/* / The type signature for command context's output handler. */
+/** The type signature for command context's output handler. */
 typedef int (*command_output_handler_t)(struct command_context *context,
                const char *line);
 
@@ -217,7 +217,7 @@ struct command_registration {
        void *jim_handler_data;
        enum command_mode mode;
        const char *help;
-       /* / a string listing the options and arguments, required or optional */
+       /** a string listing the options and arguments, required or optional */
        const char *usage;
 
        /**
@@ -229,7 +229,7 @@ struct command_registration {
        const struct command_registration *chain;
 };
 
-/* / Use this as the last entry in an array of command_registration records. */
+/** Use this as the last entry in an array of command_registration records. */
 #define COMMAND_REGISTRATION_DONE { .name = NULL, .chain = NULL }
 
 /**
@@ -415,10 +415,10 @@ DECLARE_PARSE_WRAPPER(_s8, int8_t);
 int command_parse_bool_arg(const char *in, bool *out);
 COMMAND_HELPER(handle_command_parse_bool, bool *out, const char *label);
 
-/* / parses an on/off command argument */
+/** parses an on/off command argument */
 #define COMMAND_PARSE_ON_OFF(in, out) \
        COMMAND_PARSE_BOOL(in, out, "on", "off")
-/* / parses an enable/disable command argument */
+/** parses an enable/disable command argument */
 #define COMMAND_PARSE_ENABLE(in, out) \
        COMMAND_PARSE_BOOL(in, out, "enable", "disable")
 
index 8689d706a6558ad9416e2f464f20a4eaba1b4d75..4c46127dfd23f98a20e456089344af652071babd 100644 (file)
@@ -41,7 +41,7 @@
 int timeval_subtract(struct timeval *result, struct timeval *x, struct timeval *y);
 int timeval_add_time(struct timeval *result, long sec, long usec);
 
-/* / @returns gettimeofday() timeval as 64-bit in ms */
+/** @returns gettimeofday() timeval as 64-bit in ms */
 int64_t timeval_ms(void);
 
 struct duration {
@@ -49,14 +49,14 @@ struct duration {
        struct timeval elapsed;
 };
 
-/* / Update the duration->start field to start the @a duration measurement. */
+/** Update the duration->start field to start the @a duration measurement. */
 int duration_start(struct duration *duration);
-/* / Update the duration->elapsed field to finish the @a duration measurment. */
+/** Update the duration->elapsed field to finish the @a duration measurment. */
 int duration_measure(struct duration *duration);
 
-/* / @returns Elapsed time in seconds. */
+/** @returns Elapsed time in seconds. */
 float duration_elapsed(struct duration *duration);
-/* / @returns KB/sec for the elapsed @a duration and @a count bytes. */
+/** @returns KB/sec for the elapsed @a duration and @a count bytes. */
 float duration_kbps(struct duration *duration, size_t count);
 
 #endif /* TIME_SUPPORT_H */
index f87a66a559af4177a12219af6b4cbd21fc9481da..6de168e61630ec2b94e100a550d16e2c07ddd4df 100644 (file)
@@ -113,11 +113,11 @@ static int jtag_ntrst_assert_width;       /* width of assertion */
  * when an event occurs.
  */
 struct jtag_event_callback {
-       /* / a event callback */
+       /** a event callback */
        jtag_event_handler_t callback;
-       /* / the private data to pass to the callback */
+       /** the private data to pass to the callback */
        void *priv;
-       /* / the next callback */
+       /** the next callback */
        struct jtag_event_callback *next;
 };
 
@@ -206,7 +206,7 @@ unsigned jtag_tap_count_enabled(void)
        return n;
 }
 
-/* / Append a new TAP to the chain of all taps. */
+/** Append a new TAP to the chain of all taps. */
 void jtag_tap_add(struct jtag_tap *t)
 {
        t->abs_chain_position = jtag_num_taps++;
@@ -716,7 +716,7 @@ void jtag_add_reset(int req_tlr_or_trst, int req_srst)
 
 void jtag_add_sleep(uint32_t us)
 {
-       /* / @todo Here, keep_alive() appears to be a layering violation!!! */
+       /** @todo Here, keep_alive() appears to be a layering violation!!! */
        keep_alive();
        jtag_set_error(interface_jtag_add_sleep(us));
 }
@@ -1260,7 +1260,7 @@ void jtag_tap_init(struct jtag_tap *tap)
        tap->expected_mask = calloc(1, ir_len_bytes);
        tap->cur_instr = malloc(ir_len_bytes);
 
-       /* / @todo cope better with ir_length bigger than 32 bits */
+       /** @todo cope better with ir_length bigger than 32 bits */
        if (ir_len_bits > 32)
                ir_len_bits = 32;
 
@@ -1286,7 +1286,7 @@ void jtag_tap_free(struct jtag_tap *tap)
 {
        jtag_unregister_event_callback(&jtag_reset_callback, tap);
 
-       /* / @todo is anything missing? no memory leaks please */
+       /** @todo is anything missing? no memory leaks please */
        free((void *)tap->expected);
        free((void *)tap->expected_ids);
        free((void *)tap->chip);