diff options
author | Antonio Borneo <borneo.antonio@gmail.com> | 2021-01-02 16:49:11 +0100 |
---|---|---|
committer | Antonio Borneo <borneo.antonio@gmail.com> | 2021-01-13 11:32:58 +0000 |
commit | f83c2b0c7c53770df9771d46a32c045175d02284 (patch) | |
tree | 32cf762f0138849ca3b6486511b25574ebc165e8 /doc/manual/style.txt | |
parent | 3fbcb26f988c10286d00d08e488f87cddd4ebe38 (diff) | |
download | riscv-openocd-f83c2b0c7c53770df9771d46a32c045175d02284.zip riscv-openocd-f83c2b0c7c53770df9771d46a32c045175d02284.tar.gz riscv-openocd-f83c2b0c7c53770df9771d46a32c045175d02284.tar.bz2 |
doc/style: fix doxygen error
Doxygen complains about non-closed nested comments:
doc/manual/style.txt:423: warning: Reached end of file
while still inside a (nested) comment. Nesting level 1
(probable line reference: 149)
This is caused by the string '/**' that is interpreted as the
beginning of a comment.
Escape the string to not let doxygen consider it as a comment
While there, replace @code/@endcode with @verbatim/@endverbatim to
properly render the line.
Change-Id: If2a27c4cf659326e317cc4ac8c0b313e97e40432
Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com>
Reviewed-on: http://openocd.zylin.com/5996
Tested-by: jenkins
Diffstat (limited to 'doc/manual/style.txt')
-rw-r--r-- | doc/manual/style.txt | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/doc/manual/style.txt b/doc/manual/style.txt index 7191a4b..dad3bb4 100644 --- a/doc/manual/style.txt +++ b/doc/manual/style.txt @@ -186,9 +186,9 @@ comments. "empty" lines should be removed from the block. -# Only single spaces should be used; do @b not add mid-line indentation. -# If the total line length will be less than 72-80 columns, then - - The @c /**< form can be used on the same line. + - The @c /\**< form can be used on the same line. - This style should be used sparingly; the best use is for fields: - @code int field; /**< field description */ @endcode + @verbatim int field; /**< field description */ @endverbatim @section styledoxyall Doxygen Style Guide |