[PATCH wayland 1/2] doc: move project-specific doxygen settings to the end of the doxygen file

[Pekka Paalanen]

On Fri,  5 Jun 2015 15:30:22 +1000
Peter Hutterer <peter.hutterer at who-t.net> wrote:

> Rather than having the settings hidden in the file somewhere move them to the
> end so it's clear which settings we intentionally override.
> 
> Signed-off-by: Peter Hutterer <peter.hutterer at who-t.net>
> ---
>  doc/doxygen/wayland.doxygen.in | 41 +++++++++++++++++++++++++++++++----------
>  1 file changed, 31 insertions(+), 10 deletions(-)
> 
> diff --git a/doc/doxygen/wayland.doxygen.in b/doc/doxygen/wayland.doxygen.in
> index e64512f..38c38f8 100644
> --- a/doc/doxygen/wayland.doxygen.in
> +++ b/doc/doxygen/wayland.doxygen.in

> @@ -1734,3 +1739,19 @@ GENERATE_LEGEND        = YES
>  # the various graphs.
>  
>  DOT_CLEANUP            = YES
> +
> +
> +# 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=
> +MACRO_EXPANSION        = YES
> +EXPAND_ONLY_PREDEF     = YES
> +DOT_MULTI_TARGETS      = YES

Hi,

I did a check against the defaults of Doxygen 1.8.9.1.

Missing:

ALIASES                += comment{1}="/* \1 *<!-- -->/"
GENERATE_HTML defaults to YES, while we had NO.

doc/doxygen/Makefile.am has some ad hoc overrides as well.

I like the idea.


Thanks,
pq