xref: /OK3568_Linux_fs/kernel/drivers/gpu/arm/midgard/docs/Doxyfile (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun#
2*4882a593Smuzhiyun# (C) COPYRIGHT 2011-2013, 2015 ARM Limited. All rights reserved.
3*4882a593Smuzhiyun#
4*4882a593Smuzhiyun# This program is free software and is provided to you under the terms of the
5*4882a593Smuzhiyun# GNU General Public License version 2 as published by the Free Software
6*4882a593Smuzhiyun# Foundation, and any use by you of this program is subject to the terms
7*4882a593Smuzhiyun# of such GNU licence.
8*4882a593Smuzhiyun#
9*4882a593Smuzhiyun# A copy of the licence is included with the program, and can also be obtained
10*4882a593Smuzhiyun# from Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
11*4882a593Smuzhiyun# Boston, MA  02110-1301, USA.
12*4882a593Smuzhiyun#
13*4882a593Smuzhiyun#
14*4882a593Smuzhiyun
15*4882a593Smuzhiyun
16*4882a593Smuzhiyun
17*4882a593Smuzhiyun##############################################################################
18*4882a593Smuzhiyun
19*4882a593Smuzhiyun# This file contains per-module Doxygen configuration. Please do not add
20*4882a593Smuzhiyun# extra settings to this file without consulting all stakeholders, as they
21*4882a593Smuzhiyun# may cause override project-wide settings.
22*4882a593Smuzhiyun#
23*4882a593Smuzhiyun# Additionally, when defining aliases, macros, sections etc, use the module
24*4882a593Smuzhiyun# name as a prefix e.g. gles_my_alias.
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun##############################################################################
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun@INCLUDE = ../../bldsys/Doxyfile_common
29*4882a593Smuzhiyun
30*4882a593Smuzhiyun# The INPUT tag can be used to specify the files and/or directories that contain
31*4882a593Smuzhiyun# documented source files. You may enter file names like "myfile.cpp" or
32*4882a593Smuzhiyun# directories like "/usr/src/myproject". Separate the files or directories
33*4882a593Smuzhiyun# with spaces.
34*4882a593Smuzhiyun
35*4882a593SmuzhiyunINPUT                  += ../../kernel/drivers/gpu/arm/midgard/
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun##############################################################################
38*4882a593Smuzhiyun# Everything below here is optional, and in most cases not required
39*4882a593Smuzhiyun##############################################################################
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun# This tag can be used to specify a number of aliases that acts
42*4882a593Smuzhiyun# as commands in the documentation. An alias has the form "name=value".
43*4882a593Smuzhiyun# For example adding "sideeffect=\par Side Effects:\n" will allow you to
44*4882a593Smuzhiyun# put the command \sideeffect (or @sideeffect) in the documentation, which
45*4882a593Smuzhiyun# will result in a user-defined paragraph with heading "Side Effects:".
46*4882a593Smuzhiyun# You can put \n's in the value part of an alias to insert newlines.
47*4882a593Smuzhiyun
48*4882a593SmuzhiyunALIASES                +=
49*4882a593Smuzhiyun
50*4882a593Smuzhiyun# The ENABLED_SECTIONS tag can be used to enable conditional
51*4882a593Smuzhiyun# documentation sections, marked by \if sectionname ... \endif.
52*4882a593Smuzhiyun
53*4882a593SmuzhiyunENABLED_SECTIONS       +=
54*4882a593Smuzhiyun
55*4882a593Smuzhiyun# If the value of the INPUT tag contains directories, you can use the
56*4882a593Smuzhiyun# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp
57*4882a593Smuzhiyun# and *.h) to filter out the source-files in the directories. If left
58*4882a593Smuzhiyun# blank the following patterns are tested:
59*4882a593Smuzhiyun# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx
60*4882a593Smuzhiyun# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.f90
61*4882a593Smuzhiyun
62*4882a593SmuzhiyunFILE_PATTERNS          +=
63*4882a593Smuzhiyun
64*4882a593Smuzhiyun# The EXCLUDE tag can be used to specify files and/or directories that should
65*4882a593Smuzhiyun# excluded from the INPUT source files. This way you can easily exclude a
66*4882a593Smuzhiyun# subdirectory from a directory tree whose root is specified with the INPUT tag.
67*4882a593SmuzhiyunEXCLUDE                += ../../kernel/drivers/gpu/arm/midgard/platform ../../kernel/drivers/gpu/arm/midgard/platform_dummy ../../kernel/drivers/gpu/arm/midgard/scripts ../../kernel/drivers/gpu/arm/midgard/tests ../../kernel/drivers/gpu/arm/midgard/Makefile ../../kernel/drivers/gpu/arm/midgard/Makefile.kbase ../../kernel/drivers/gpu/arm/midgard/Kbuild ../../kernel/drivers/gpu/arm/midgard/Kconfig ../../kernel/drivers/gpu/arm/midgard/sconscript ../../kernel/drivers/gpu/arm/midgard/docs ../../kernel/drivers/gpu/arm/midgard/pm_test_script.sh ../../kernel/drivers/gpu/arm/midgard/mali_uk.h ../../kernel/drivers/gpu/arm/midgard/Makefile
68*4882a593Smuzhiyun
69*4882a593Smuzhiyun
70*4882a593Smuzhiyun# If the value of the INPUT tag contains directories, you can use the
71*4882a593Smuzhiyun# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
72*4882a593Smuzhiyun# certain files from those directories. Note that the wildcards are matched
73*4882a593Smuzhiyun# against the file with absolute path, so to exclude all test directories
74*4882a593Smuzhiyun# for example use the pattern */test/*
75*4882a593Smuzhiyun
76*4882a593SmuzhiyunEXCLUDE_PATTERNS       +=
77*4882a593Smuzhiyun
78*4882a593Smuzhiyun# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
79*4882a593Smuzhiyun# (namespaces, classes, functions, etc.) that should be excluded from the
80*4882a593Smuzhiyun# output. The symbol name can be a fully qualified name, a word, or if the
81*4882a593Smuzhiyun# wildcard * is used, a substring. Examples: ANamespace, AClass,
82*4882a593Smuzhiyun# AClass::ANamespace, ANamespace::*Test
83*4882a593Smuzhiyun
84*4882a593SmuzhiyunEXCLUDE_SYMBOLS        +=
85*4882a593Smuzhiyun
86*4882a593Smuzhiyun# The EXAMPLE_PATH tag can be used to specify one or more files or
87*4882a593Smuzhiyun# directories that contain example code fragments that are included (see
88*4882a593Smuzhiyun# the \include command).
89*4882a593Smuzhiyun
90*4882a593SmuzhiyunEXAMPLE_PATH           +=
91*4882a593Smuzhiyun
92*4882a593Smuzhiyun# The IMAGE_PATH tag can be used to specify one or more files or
93*4882a593Smuzhiyun# directories that contain image that are included in the documentation (see
94*4882a593Smuzhiyun# the \image command).
95*4882a593Smuzhiyun
96*4882a593SmuzhiyunIMAGE_PATH             +=
97*4882a593Smuzhiyun
98*4882a593Smuzhiyun# The INCLUDE_PATH tag can be used to specify one or more directories that
99*4882a593Smuzhiyun# contain include files that are not input files but should be processed by
100*4882a593Smuzhiyun# the preprocessor.
101*4882a593Smuzhiyun
102*4882a593SmuzhiyunINCLUDE_PATH           +=
103*4882a593Smuzhiyun
104*4882a593Smuzhiyun# The PREDEFINED tag can be used to specify one or more macro names that
105*4882a593Smuzhiyun# are defined before the preprocessor is started (similar to the -D option of
106*4882a593Smuzhiyun# gcc). The argument of the tag is a list of macros of the form: name
107*4882a593Smuzhiyun# or name=definition (no spaces). If the definition and the = are
108*4882a593Smuzhiyun# omitted =1 is assumed. To prevent a macro definition from being
109*4882a593Smuzhiyun# undefined via #undef or recursively expanded use the := operator
110*4882a593Smuzhiyun# instead of the = operator.
111*4882a593Smuzhiyun
112*4882a593SmuzhiyunPREDEFINED             +=
113*4882a593Smuzhiyun
114*4882a593Smuzhiyun# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then
115*4882a593Smuzhiyun# this tag can be used to specify a list of macro names that should be expanded.
116*4882a593Smuzhiyun# The macro definition that is found in the sources will be used.
117*4882a593Smuzhiyun# Use the PREDEFINED tag if you want to use a different macro definition.
118*4882a593Smuzhiyun
119*4882a593SmuzhiyunEXPAND_AS_DEFINED      +=
120*4882a593Smuzhiyun
121*4882a593Smuzhiyun# The DOTFILE_DIRS tag can be used to specify one or more directories that
122*4882a593Smuzhiyun# contain dot files that are included in the documentation (see the
123*4882a593Smuzhiyun# \dotfile command).
124*4882a593Smuzhiyun
125*4882a593SmuzhiyunDOTFILE_DIRS           += ../../kernel/drivers/gpu/arm/midgard/docs
126*4882a593Smuzhiyun
127