mirror of
				https://gitlab.freedesktop.org/wayland/wayland.git
				synced 2025-11-03 09:01:42 -05:00 
			
		
		
		
	Doxygen truncates a WL_PRINTF function attribute, and there does not seem to be any workaround[1]. When using the attribute like this: typedef void (*wl_log_func_t)(const char *, va_list) WL_PRINTF(1, 0); Doxygen generates something that looks like this: typedef void (*wl_log_func_t)(const char *, va_list) WL_PRINTF(1, Configure doxygen to consider WL_PRINTF(x,y) as predefined, so it does not display the attribute at all in the generated documentation. [1] https://bugzilla.gnome.org/show_bug.cgi?id=774741 Signed-off-by: Yong Bakos <ybakos@humanoriented.com> Reviewed-by: Peter Hutterer <peter.hutterer@who-t.net>
		
			
				
	
	
		
			23 lines
		
	
	
	
		
			764 B
		
	
	
	
		
			Text
		
	
	
	
	
	
			
		
		
	
	
			23 lines
		
	
	
	
		
			764 B
		
	
	
	
		
			Text
		
	
	
	
	
	
# Wayland-specific overrides
 | 
						|
PROJECT_NAME           = "Wayland"
 | 
						|
PROJECT_NUMBER         = @VERSION@
 | 
						|
OUTPUT_DIRECTORY       = @top_builddir@/doc/doxygen
 | 
						|
JAVADOC_AUTOBRIEF      = YES
 | 
						|
TAB_SIZE               = 8
 | 
						|
QUIET                  = YES
 | 
						|
HTML_TIMESTAMP         = YES
 | 
						|
GENERATE_LATEX         = NO
 | 
						|
MAN_LINKS              = YES
 | 
						|
PREDEFINED             = WL_EXPORT=              \
 | 
						|
                         WL_PRINTF(x,y)=
 | 
						|
MACRO_EXPANSION        = YES
 | 
						|
EXPAND_ONLY_PREDEF     = YES
 | 
						|
DOT_MULTI_TARGETS      = YES
 | 
						|
ALIASES                += comment{1}="/* \1 *<!-- -->/"
 | 
						|
OPTIMIZE_OUTPUT_FOR_C  = YES
 | 
						|
EXTRACT_ALL            = YES
 | 
						|
EXTRACT_STATIC         = YES
 | 
						|
# These must be set in the Makefile
 | 
						|
GENERATE_HTML          = NO
 | 
						|
GENERATE_XML           = NO
 | 
						|
GENERATE_MAN           = NO
 |