2
2
3
3
plugins {
4
4
id ' java'
5
- id " org.ysb33r.doxygen" version " 0.7.0 "
5
+ id " org.ysb33r.doxygen" version " 1.0.4 "
6
6
}
7
7
8
8
@@ -36,15 +36,16 @@ doxygen {
36
36
String arch = System . getProperty(" os.arch" );
37
37
if (arch. equals(" x86_64" ) || arch. equals(" amd64" )) {
38
38
executables {
39
- doxygen version : ' 1.9.4' ,
40
- baseURI : ' https://frcmaven.wpi.edu/artifactory/generic-release-mirror/doxygen'
39
+ doxygen {
40
+ executableByVersion(' 1.12.0' )
41
+ }
41
42
}
42
43
}
43
44
}
44
45
45
46
doxygen {
46
- generate_html true
47
- html_extra_stylesheet ' theme.css'
47
+ option ' generate_html' , true
48
+ option ' html_extra_stylesheet' , ' theme.css'
48
49
49
50
cppProjectZips. each {
50
51
dependsOn it
@@ -53,126 +54,37 @@ doxygen {
53
54
cppIncludeRoots. add(it. absolutePath)
54
55
}
55
56
}
56
- cppIncludeRoots << ' ../ntcore/build/generated/main/native/include/'
57
-
58
- if (project. hasProperty(' docWarningsAsErrors' )) {
59
- // Eigen
60
- exclude ' Eigen/**'
61
- exclude ' unsupported/**'
62
-
63
- // LLVM
64
- exclude ' wpi/AlignOf.h'
65
- exclude ' wpi/Casting.h'
66
- exclude ' wpi/Chrono.h'
67
- exclude ' wpi/Compiler.h'
68
- exclude ' wpi/ConvertUTF.h'
69
- exclude ' wpi/DenseMap.h'
70
- exclude ' wpi/DenseMapInfo.h'
71
- exclude ' wpi/Endian.h'
72
- exclude ' wpi/EpochTracker.h'
73
- exclude ' wpi/Errc.h'
74
- exclude ' wpi/Errno.h'
75
- exclude ' wpi/ErrorHandling.h'
76
- exclude ' wpi/bit.h'
77
- exclude ' wpi/fs.h'
78
- exclude ' wpi/FunctionExtras.h'
79
- exclude ' wpi/function_ref.h'
80
- exclude ' wpi/Hashing.h'
81
- exclude ' wpi/iterator.h'
82
- exclude ' wpi/iterator_range.h'
83
- exclude ' wpi/ManagedStatic.h'
84
- exclude ' wpi/MapVector.h'
85
- exclude ' wpi/MathExtras.h'
86
- exclude ' wpi/MemAlloc.h'
87
- exclude ' wpi/PointerIntPair.h'
88
- exclude ' wpi/PointerLikeTypeTraits.h'
89
- exclude ' wpi/PointerUnion.h'
90
- exclude ' wpi/raw_os_ostream.h'
91
- exclude ' wpi/raw_ostream.h'
92
- exclude ' wpi/SmallPtrSet.h'
93
- exclude ' wpi/SmallSet.h'
94
- exclude ' wpi/SmallString.h'
95
- exclude ' wpi/SmallVector.h'
96
- exclude ' wpi/StringExtras.h'
97
- exclude ' wpi/StringMap.h'
98
- exclude ' wpi/SwapByteOrder.h'
99
- exclude ' wpi/type_traits.h'
100
- exclude ' wpi/VersionTuple.h'
101
- exclude ' wpi/WindowsError.h'
102
-
103
- // fmtlib
104
- exclude ' fmt/**'
105
-
106
- // libuv
107
- exclude ' uv.h'
108
- exclude ' uv/**'
109
- exclude ' wpinet/uv/**'
110
-
111
- // json
112
- exclude ' wpi/adl_serializer.h'
113
- exclude ' wpi/byte_container_with_subtype.h'
114
- exclude ' wpi/detail/**'
115
- exclude ' wpi/json.h'
116
- exclude ' wpi/json_fwd.h'
117
- exclude ' wpi/ordered_map.h'
118
- exclude ' wpi/thirdparty/**'
119
-
120
- // memory
121
- exclude ' wpi/memory/**'
122
-
123
- // mpack
124
- exclude ' wpi/mpack.h'
125
-
126
- // units
127
- exclude ' units/**'
128
- }
129
-
130
- // TODO: building memory docs causes search to break
131
- exclude ' wpi/memory/**'
132
-
133
- exclude ' *.pb.h'
134
-
135
- // Save space by excluding protobuf and eigen
136
- exclude ' Eigen/**'
137
- exclude ' google/protobuf/**'
138
-
139
- aliases ' effects=\\ par <i>Effects:</i>^^' ,
140
- ' notes=\\ par <i>Notes:</i>^^' ,
141
- ' requires=\\ par <i>Requires:</i>^^' ,
142
- ' requiredbe=\\ par <i>Required Behavior:</i>^^' ,
143
- ' concept{2}=<a href=\" md_doc_concepts.html#\1\" >\2 </a>' ,
144
- ' defaultbe=\\ par <i>Default Behavior:</i>^^'
145
- case_sense_names false
146
- extension_mapping ' inc=C++' , ' no_extension=C++'
147
- extract_all true
148
- extract_static true
149
- file_patterns ' *'
150
- full_path_names true
151
- generate_html true
152
- generate_latex false
153
- generate_treeview true
154
- html_extra_stylesheet ' theme.css'
155
- html_timestamp true
156
- javadoc_autobrief true
157
- project_name ' PhotonVision C++'
158
- project_logo ' ../photon-client/src/assets/images/logoSmall.svg'
159
- project_number pubVersion
160
- quiet true
161
- recursive true
162
- strip_code_comments false
163
- strip_from_inc_path cppIncludeRoots as String[]
164
- strip_from_path cppIncludeRoots as String[]
165
- use_mathjax true
166
- warnings false
167
- warn_if_incomplete_doc true
168
- warn_if_undocumented false
169
- warn_no_paramdoc true
57
+ option ' case_sense_names' , false
58
+ option ' extension_mapping' , ' inc=C++ no_extension=C++'
59
+ option ' extract_all' , true
60
+ option ' extract_static' , true
61
+ option ' file_patterns' , ' *'
62
+ option ' full_path_names' , true
63
+ option ' generate_html' , true
64
+ option ' generate_latex' , false
65
+ option ' generate_treeview' , true
66
+ option ' html_extra_stylesheet' , ' theme.css'
67
+ option ' html_timestamp' , true
68
+ option ' javadoc_autobrief' , true
69
+ option ' project_name' , ' PhotonVision C++'
70
+ option ' project_logo' , ' ../docs/source/assets/RoundLogo.png'
71
+ option ' project_number' , pubVersion
72
+ option ' quiet' , true
73
+ option ' recursive' , true
74
+ option ' strip_code_comments' , false
75
+ option ' strip_from_inc_path' , cppIncludeRoots
76
+ option ' strip_from_path' , cppIncludeRoots
77
+ option ' use_mathjax' , true
78
+ option ' warnings' , false
79
+ option ' warn_if_incomplete_doc' , true
80
+ option ' warn_if_undocumented' , false
81
+ option ' warn_no_paramdoc' , true
170
82
171
83
// enable doxygen preprocessor expansion of WPI_DEPRECATED to fix MotorController docs
172
- enable_preprocessing true
173
- macro_expansion true
174
- expand_only_predef true
175
- predefined " WPI_DEPRECATED(x)=[[deprecated(x)]]\"\\\n " +
84
+ option ' enable_preprocessing' , true
85
+ option ' macro_expansion' , true
86
+ option ' expand_only_predef' , true
87
+ option ' predefined' , " WPI_DEPRECATED(x)=[[deprecated(x)]]\"\\\n " +
176
88
" \" __cplusplus\"\\\n " +
177
89
" \" HAL_ENUM(name)=enum name : int32_t"
178
90
0 commit comments