[LTP] [PATCH v2 2/2] include: doc: Convert comments into linuxdoc

Cyril Hrubis chrubis@suse.cz
Wed Apr 3 08:07:13 CEST 2024


Hi!
> diff --git a/include/tst_compiler.h b/include/tst_compiler.h
> new file mode 100644
> index 000000000..ec88213df
> --- /dev/null
> +++ b/include/tst_compiler.h
> @@ -0,0 +1,20 @@
> +/* SPDX-License-Identifier: GPL-2.0-or-later */
> +
> +/**
> + * @file tst_compiler.h
> + * @brief Macros to support dumb compilers.
> + *
> + * The doxygen parser (and possibly other C tooling) does not understand
> + * __attributes__ so we have to hide them with macros.
> + */
> +
> +#ifndef TST_COMPILER_H__
> +#define TST_COMPILER_H__
> +
> +#ifdef __GNUC__
> +# define TST_ATTRIBUTE(...) __attribute__((__VA_ARGS__))
> +#else
> +# define TST_ATTRIBUTE(...)
> +#endif
> +
> +#endif	/* TST_COMPILER_H__ */

And I just realized that this is a leftover from the doxygen experiment,
so it should be dropped from the patchset. I will send a v3.

-- 
Cyril Hrubis
chrubis@suse.cz


More information about the ltp mailing list