michaelh/zephyr
1
0
Fork 0
Code Releases Activity

doc: fix doxygen warnings 'documented symbol XYZ was not declared or defined.'

Browse source 
The problem is doxygen's parser is getting confused by constructs as:

  static inline __attribute__((always_inline))
 	void sys_out8(uint8_t data, io_port_t port)
  {
 	_arc_v2_aux_reg_write(port, data);
  }

Too many words at the beginning of the function definition. So change
to use the macro ALWAYS_INLINE (which is already defined to mean
'inline __attribute__((always_inline))`.

Kills:

sys_io.h:37: warning: documented symbol `static inline void sys_out8' was not declared or defined.
sys_io.h:47: warning: documented symbol `static inline uint8_t sys_in8' was not declared or defined.
sys_io.h:58: warning: documented symbol `static inline void sys_out16' was not declared or defined.
sys_io.h:68: warning: documented symbol `static inline uint16_t sys_in16' was not declared or defined.
sys_io.h:79: warning: documented symbol `static inline void sys_out32' was not declared or defined.
sys_io.h:89: warning: documented symbol `static inline uint32_t sys_in32' was not declared or defined.
sys_io.h:120: warning: documented symbol `static inline int sys_io_test_bit' was not declared or defined.
sys_io.h:133: warning: documented symbol `static inline int sys_io_test_and_set_bit' was not declared or defined.
sys_io.h:146: warning: documented symbol `static inline int sys_io_test_and_clear_bit' was not declared or defined.
sys_io.h:161: warning: documented symbol `static inline void sys_write8' was not declared or defined.
sys_io.h:171: warning: documented symbol `static inline uint8_t sys_read8' was not declared or defined.
sys_io.h:182: warning: documented symbol `static inline void sys_write16' was not declared or defined.
sys_io.h:192: warning: documented symbol `static inline uint16_t sys_read16' was not declared or defined.
sys_io.h:248: warning: documented symbol `static inline int sys_test_bit' was not declared or defined.
sys_io.h:261: warning: documented symbol `static inline int sys_test_and_set_bit' was not declared or defined.
sys_io.h:274: warning: documented symbol `static inline int sys_test_and_clear_bit' was not declared or defined.

Change-Id: Id10e9b6cd44a370ccc732c17b23fb66bd1845205
Signed-off-by: Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
This commit is contained in:
Inaky Perez-Gonzalez 2016-06-14 18:35:13 -07:00
commit 2e7f3bb858
4 changed files with 71 additions and 71 deletions
Download patch file Download diff file Expand all files Collapse all files

54
include/arch/arc/v2/asm_inline_gcc.h
View file

@ -33,43 +33,43 @@ extern "C" {
/* Implementation of sys_io.h's documented functions */
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_out8(uint8_t data, io_port_t port)
{
_arc_v2_aux_reg_write(port, data);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint8_t sys_in8(io_port_t port)
{
return (uint8_t)(_arc_v2_aux_reg_read(port) & 0x000000ff);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_out16(uint16_t data, io_port_t port)
{
_arc_v2_aux_reg_write(port, data);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint16_t sys_in16(io_port_t port)
{
return (uint16_t)(_arc_v2_aux_reg_read(port) & 0x0000ffff);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_out32(uint32_t data, io_port_t port)
{
_arc_v2_aux_reg_write(port, data);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint32_t sys_in32(io_port_t port)
{
return _arc_v2_aux_reg_read(port);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_io_set_bit(io_port_t port, unsigned int bit)
{
uint32_t reg = 0;
@ -83,7 +83,7 @@ static inline __attribute__((always_inline))
: "memory", "cc");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_io_clear_bit(io_port_t port, unsigned int bit)
{
uint32_t reg = 0;
@ -97,7 +97,7 @@ static inline __attribute__((always_inline))
: "memory", "cc");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_io_test_bit(io_port_t port, unsigned int bit)
{
uint32_t status = _ARC_V2_STATUS32;
@ -115,7 +115,7 @@ static inline __attribute__((always_inline))
return !(ret & _ARC_V2_STATUS32_Z);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_io_test_and_set_bit(io_port_t port, unsigned int bit)
{
int ret;
@ -126,7 +126,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_io_test_and_clear_bit(io_port_t port, unsigned int bit)
{
int ret;
@ -137,7 +137,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_write8(uint8_t data, mm_reg_t addr)
{
__asm__ volatile("stb%U1 %0, %1;\n\t"
@ -146,7 +146,7 @@ static inline __attribute__((always_inline))
: "memory");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint8_t sys_read8(mm_reg_t addr)
{
uint8_t ret;
@ -159,7 +159,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_write16(uint16_t data, mm_reg_t addr)
{
__asm__ volatile("sth%U1 %0, %1;\n\t"
@ -168,7 +168,7 @@ static inline __attribute__((always_inline))
: "memory");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint16_t sys_read16(mm_reg_t addr)
{
uint16_t ret;
@ -181,7 +181,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_write32(uint32_t data, mm_reg_t addr)
{
__asm__ volatile("st%U1 %0, %1;\n\t"
@ -190,7 +190,7 @@ static inline __attribute__((always_inline))
: "memory");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint32_t sys_read32(mm_reg_t addr)
{
uint32_t ret;
@ -203,7 +203,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_set_bit(mem_addr_t addr, unsigned int bit)
{
uint32_t reg = 0;
@ -216,7 +216,7 @@ static inline __attribute__((always_inline))
: "memory", "cc");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_clear_bit(mem_addr_t addr, unsigned int bit)
{
uint32_t reg = 0;
@ -229,7 +229,7 @@ static inline __attribute__((always_inline))
: "memory", "cc");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_test_bit(mem_addr_t addr, unsigned int bit)
{
uint32_t status = _ARC_V2_STATUS32;
@ -247,7 +247,7 @@ static inline __attribute__((always_inline))
return !(ret & _ARC_V2_STATUS32_Z);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_test_and_set_bit(mem_addr_t addr, unsigned int bit)
{
int ret;
@ -258,7 +258,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_test_and_clear_bit(mem_addr_t addr, unsigned int bit)
{
int ret;
@ -269,7 +269,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_bitfield_set_bit(mem_addr_t addr, unsigned int bit)
{
/* Doing memory offsets in terms of 32-bit values to prevent
@ -278,20 +278,20 @@ static inline __attribute__((always_inline))
sys_set_bit(addr + ((bit >> 5) << 2), bit & 0x1F);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_bitfield_clear_bit(mem_addr_t addr, unsigned int bit)
{
sys_clear_bit(addr + ((bit >> 5) << 2), bit & 0x1F);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_bitfield_test_bit(mem_addr_t addr, unsigned int bit)
{
return sys_test_bit(addr + ((bit >> 5) << 2), bit & 0x1F);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_bitfield_test_and_set_bit(mem_addr_t addr, unsigned int bit)
{
int ret;
@ -302,7 +302,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_bitfield_test_and_clear_bit(mem_addr_t addr, unsigned int bit)
{
int ret;

32
include/arch/nios2/asm_inline_gcc.h
View file

@ -70,37 +70,37 @@ static ALWAYS_INLINE unsigned int find_lsb_set(uint32_t op)
* devices that have an instruction/data cache
*/
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_write8(uint8_t data, mm_reg_t addr)
{
__builtin_stbio((void *)addr, data);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint8_t sys_read8(mm_reg_t addr)
{
return __builtin_ldbuio((void *)addr);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_write16(uint16_t data, mm_reg_t addr)
{
__builtin_sthio((void *)addr, data);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint16_t sys_read16(mm_reg_t addr)
{
return __builtin_ldhuio((void *)addr);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_write32(uint32_t data, mm_reg_t addr)
{
__builtin_stwio((void *)addr, data);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint32_t sys_read32(mm_reg_t addr)
{
return __builtin_ldwio((void *)addr);
@ -110,19 +110,19 @@ static inline __attribute__((always_inline))
* so just read, modify, write in C
*/
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_set_bit(mem_addr_t addr, unsigned int bit)
{
sys_write32(sys_read32(addr) | (1 << bit), addr);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_clear_bit(mem_addr_t addr, unsigned int bit)
{
sys_write32(sys_read32(addr) & ~(1 << bit), addr);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_test_bit(mem_addr_t addr, unsigned int bit)
{
return sys_read32(addr) & (1 << bit);
@ -130,7 +130,7 @@ static inline __attribute__((always_inline))
/* These are not required to be atomic, just do it in C */
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_test_and_set_bit(mem_addr_t addr, unsigned int bit)
{
int ret;
@ -141,7 +141,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_test_and_clear_bit(mem_addr_t addr, unsigned int bit)
{
int ret;
@ -152,7 +152,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_bitfield_set_bit(mem_addr_t addr, unsigned int bit)
{
/* Doing memory offsets in terms of 32-bit values to prevent
@ -161,20 +161,20 @@ static inline __attribute__((always_inline))
sys_set_bit(addr + ((bit >> 5) << 2), bit & 0x1F);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_bitfield_clear_bit(mem_addr_t addr, unsigned int bit)
{
sys_clear_bit(addr + ((bit >> 5) << 2), bit & 0x1F);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_bitfield_test_bit(mem_addr_t addr, unsigned int bit)
{
return sys_test_bit(addr + ((bit >> 5) << 2), bit & 0x1F);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_bitfield_test_and_set_bit(mem_addr_t addr, unsigned int bit)
{
int ret;
@ -185,7 +185,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_bitfield_test_and_clear_bit(mem_addr_t addr, unsigned int bit)
{
int ret;

4
include/arch/x86/arch.h
View file

@ -427,7 +427,7 @@ void _int_latency_stop(void);
*
*/
static inline __attribute__((always_inline)) unsigned int _arch_irq_lock(void)
static ALWAYS_INLINE unsigned int _arch_irq_lock(void)
{
unsigned int key = _do_irq_lock();
@ -451,7 +451,7 @@ static inline __attribute__((always_inline)) unsigned int _arch_irq_lock(void)
*
*/
static inline __attribute__((always_inline)) void _arch_irq_unlock(unsigned int key)
static ALWAYS_INLINE void _arch_irq_unlock(unsigned int key)
{
if (!(key & 0x200)) {
return;

52
include/arch/x86/asm_inline_gcc.h
View file

@ -49,7 +49,7 @@ extern "C" {
* "interrupt disable state" prior to the call.
*/
static inline __attribute__((always_inline)) unsigned int _do_irq_lock(void)
static ALWAYS_INLINE unsigned int _do_irq_lock(void)
{
unsigned int key;
@ -78,7 +78,7 @@ static inline __attribute__((always_inline)) unsigned int _do_irq_lock(void)
* @return N/A
*/
static inline __attribute__((always_inline)) void _do_irq_unlock(void)
static ALWAYS_INLINE void _do_irq_unlock(void)
{
__asm__ volatile (
"sti;\n\t"
@ -227,7 +227,7 @@ static inline uint64_t _NanoTscRead(void)
* @return a 32-bit number
*/
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint32_t _do_read_cpu_timestamp32(void)
{
uint32_t rv;
@ -240,8 +240,8 @@ static inline __attribute__((always_inline))
/* Implementation of sys_io.h's documented functions */
static inline __attribute__((always_inline))
void sys_out8(uint8_t data, io_port_t port)
static ALWAYS_INLINE
void sys_out8(uint8_t data, io_port_t port)
{
__asm__ volatile("outb %b0, %w1;\n\t"
:
@ -249,7 +249,7 @@ static inline __attribute__((always_inline))
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint8_t sys_in8(io_port_t port)
{
uint8_t ret;
@ -261,7 +261,7 @@ static inline __attribute__((always_inline))
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_out16(uint16_t data, io_port_t port)
{
__asm__ volatile("outw %w0, %w1;\n\t"
@ -270,7 +270,7 @@ static inline __attribute__((always_inline))
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint16_t sys_in16(io_port_t port)
{
uint16_t ret;
@ -282,7 +282,7 @@ static inline __attribute__((always_inline))
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_out32(uint32_t data, io_port_t port)
{
__asm__ volatile("outl %0, %w1;\n\t"
@ -291,7 +291,7 @@ static inline __attribute__((always_inline))
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint32_t sys_in32(io_port_t port)
{
uint32_t ret;
@ -303,7 +303,7 @@ static inline __attribute__((always_inline))
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_io_set_bit(io_port_t port, unsigned int bit)
{
uint32_t reg = 0;
@ -315,7 +315,7 @@ static inline __attribute__((always_inline))
: "a" (reg), "Nd" (port), "Ir" (bit));
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_io_clear_bit(io_port_t port, unsigned int bit)
{
uint32_t reg = 0;
@ -327,7 +327,7 @@ static inline __attribute__((always_inline))
: "a" (reg), "Nd" (port), "Ir" (bit));
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_io_test_bit(io_port_t port, unsigned int bit)
{
uint32_t ret;
@ -340,7 +340,7 @@ static inline __attribute__((always_inline))
return (ret & 1);
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_io_test_and_set_bit(io_port_t port, unsigned int bit)
{
int ret;
@ -351,7 +351,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_io_test_and_clear_bit(io_port_t port, unsigned int bit)
{
int ret;
@ -362,7 +362,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_write8(uint8_t data, mm_reg_t addr)
{
__asm__ volatile("movb %0, %1;\n\t"
@ -371,7 +371,7 @@ static inline __attribute__((always_inline))
: "memory");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint8_t sys_read8(mm_reg_t addr)
{
uint8_t ret;
@ -384,7 +384,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_write16(uint16_t data, mm_reg_t addr)
{
__asm__ volatile("movw %0, %1;\n\t"
@ -393,7 +393,7 @@ static inline __attribute__((always_inline))
: "memory");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint16_t sys_read16(mm_reg_t addr)
{
uint16_t ret;
@ -406,7 +406,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_write32(uint32_t data, mm_reg_t addr)
{
__asm__ volatile("movl %0, %1;\n\t"
@ -415,7 +415,7 @@ static inline __attribute__((always_inline))
: "memory");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
uint32_t sys_read32(mm_reg_t addr)
{
uint32_t ret;
@ -429,7 +429,7 @@ static inline __attribute__((always_inline))
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_set_bit(mem_addr_t addr, unsigned int bit)
{
__asm__ volatile("btsl %1, %0;\n\t"
@ -438,7 +438,7 @@ static inline __attribute__((always_inline))
: "memory");
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
void sys_clear_bit(mem_addr_t addr, unsigned int bit)
{
__asm__ volatile("btrl %1, %0;\n\t"
@ -446,7 +446,7 @@ static inline __attribute__((always_inline))
: "Ir" (bit));
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_test_bit(mem_addr_t addr, unsigned int bit)
{
int ret;
@ -459,7 +459,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_test_and_set_bit(mem_addr_t addr, unsigned int bit)
{
int ret;
@ -472,7 +472,7 @@ static inline __attribute__((always_inline))
return ret;
}
static inline __attribute__((always_inline))
static ALWAYS_INLINE
int sys_test_and_clear_bit(mem_addr_t addr, unsigned int bit)
{
int ret;