1 # =========================================================================== 2 # https://www.gnu.org/software/autoconf-archive/ax_prog_doxygen.html 3 # =========================================================================== 4 # 5 # SYNOPSIS 6 # 7 # DX_INIT_DOXYGEN(PROJECT-NAME, [DOXYFILE-PATH], [OUTPUT-DIR], ...) 8 # DX_DOXYGEN_FEATURE(ON|OFF) 9 # DX_DOT_FEATURE(ON|OFF) 10 # DX_HTML_FEATURE(ON|OFF) 11 # DX_CHM_FEATURE(ON|OFF) 12 # DX_CHI_FEATURE(ON|OFF) 13 # DX_MAN_FEATURE(ON|OFF) 14 # DX_RTF_FEATURE(ON|OFF) 15 # DX_XML_FEATURE(ON|OFF) 16 # DX_PDF_FEATURE(ON|OFF) 17 # DX_PS_FEATURE(ON|OFF) 18 # 19 # DESCRIPTION 20 # 21 # The DX_*_FEATURE macros control the default setting for the given 22 # Doxygen feature. Supported features are 'DOXYGEN' itself, 'DOT' for 23 # generating graphics, 'HTML' for plain HTML, 'CHM' for compressed HTML 24 # help (for MS users), 'CHI' for generating a separate .chi file by the 25 # .chm file, and 'MAN', 'RTF', 'XML', 'PDF' and 'PS' for the appropriate 26 # output formats. The environment variable DOXYGEN_PAPER_SIZE may be 27 # specified to override the default 'a4wide' paper size. 28 # 29 # By default, HTML, PDF and PS documentation is generated as this seems to 30 # be the most popular and portable combination. MAN pages created by 31 # Doxygen are usually problematic, though by picking an appropriate subset 32 # and doing some massaging they might be better than nothing. CHM and RTF 33 # are specific for MS (note that you can't generate both HTML and CHM at 34 # the same time). The XML is rather useless unless you apply specialized 35 # post-processing to it. 36 # 37 # The macros mainly control the default state of the feature. The use can 38 # override the default by specifying --enable or --disable. The macros 39 # ensure that contradictory flags are not given (e.g., 40 # --enable-doxygen-html and --enable-doxygen-chm, 41 # --enable-doxygen-anything with --disable-doxygen, etc.) Finally, each 42 # feature will be automatically disabled (with a warning) if the required 43 # programs are missing. 44 # 45 # Once all the feature defaults have been specified, call DX_INIT_DOXYGEN 46 # with the following parameters: a one-word name for the project for use 47 # as a filename base etc., an optional configuration file name (the 48 # default is '$(srcdir)/Doxyfile', the same as Doxygen's default), and an 49 # optional output directory name (the default is 'doxygen-doc'). To run 50 # doxygen multiple times for different configuration files and output 51 # directories provide more parameters: the second, forth, sixth, etc 52 # parameter are configuration file names and the third, fifth, seventh, 53 # etc parameter are output directories. No checking is done to catch 54 # duplicates. 55 # 56 # Automake Support 57 # 58 # The DX_RULES substitution can be used to add all needed rules to the 59 # Makefile. Note that this is a substitution without being a variable: 60 # only the @DX_RULES@ syntax will work. 61 # 62 # The provided targets are: 63 # 64 # doxygen-doc: Generate all doxygen documentation. 65 # 66 # doxygen-run: Run doxygen, which will generate some of the 67 # documentation (HTML, CHM, CHI, MAN, RTF, XML) 68 # but will not do the post processing required 69 # for the rest of it (PS, PDF). 70 # 71 # doxygen-ps: Generate doxygen PostScript documentation. 72 # 73 # doxygen-pdf: Generate doxygen PDF documentation. 74 # 75 # Note that by default these are not integrated into the automake targets. 76 # If doxygen is used to generate man pages, you can achieve this 77 # integration by setting man3_MANS to the list of man pages generated and 78 # then adding the dependency: 79 # 80 # $(man3_MANS): doxygen-doc 81 # 82 # This will cause make to run doxygen and generate all the documentation. 83 # 84 # The following variable is intended for use in Makefile.am: 85 # 86 # DX_CLEANFILES = everything to clean. 87 # 88 # Then add this variable to MOSTLYCLEANFILES. 89 # 90 # LICENSE 91 # 92 # Copyright (c) 2009 Oren Ben-Kiki <oren (a] ben-kiki.org> 93 # Copyright (c) 2015 Olaf Mandel <olaf (a] mandel.name> 94 # 95 # Copying and distribution of this file, with or without modification, are 96 # permitted in any medium without royalty provided the copyright notice 97 # and this notice are preserved. This file is offered as-is, without any 98 # warranty. 99 100 #serial 24 101 102 ## ----------## 103 ## Defaults. ## 104 ## ----------## 105 106 DX_ENV="" 107 AC_DEFUN([DX_FEATURE_doc], OFF) 108 AC_DEFUN([DX_FEATURE_dot], OFF) 109 AC_DEFUN([DX_FEATURE_man], OFF) 110 AC_DEFUN([DX_FEATURE_html], ON) 111 AC_DEFUN([DX_FEATURE_chm], OFF) 112 AC_DEFUN([DX_FEATURE_chi], OFF) 113 AC_DEFUN([DX_FEATURE_rtf], OFF) 114 AC_DEFUN([DX_FEATURE_xml], OFF) 115 AC_DEFUN([DX_FEATURE_pdf], ON) 116 AC_DEFUN([DX_FEATURE_ps], ON) 117 118 ## --------------- ## 119 ## Private macros. ## 120 ## --------------- ## 121 122 # DX_ENV_APPEND(VARIABLE, VALUE) 123 # ------------------------------ 124 # Append VARIABLE="VALUE" to DX_ENV for invoking doxygen and add it 125 # as a substitution (but not a Makefile variable). The substitution 126 # is skipped if the variable name is VERSION. 127 AC_DEFUN([DX_ENV_APPEND], 128 [AC_SUBST([DX_ENV], ["$DX_ENV $1='$2'"])dnl 129 m4_if([$1], [VERSION], [], [AC_SUBST([$1], [$2])dnl 130 AM_SUBST_NOTMAKE([$1])])dnl 131 ]) 132 133 # DX_DIRNAME_EXPR 134 # --------------- 135 # Expand into a shell expression prints the directory part of a path. 136 AC_DEFUN([DX_DIRNAME_EXPR], 137 [[expr ".$1" : '\(\.\)[^/]*$' \| "x$1" : 'x\(.*\)/[^/]*$']]) 138 139 # DX_IF_FEATURE(FEATURE, IF-ON, IF-OFF) 140 # ------------------------------------- 141 # Expands according to the M4 (static) status of the feature. 142 AC_DEFUN([DX_IF_FEATURE], [ifelse(DX_FEATURE_$1, ON, [$2], [$3])]) 143 144 # DX_REQUIRE_PROG(VARIABLE, PROGRAM) 145 # ---------------------------------- 146 # Require the specified program to be found for the DX_CURRENT_FEATURE to work. 147 AC_DEFUN([DX_REQUIRE_PROG], [ 148 AC_PATH_TOOL([$1], [$2]) 149 if test "$DX_FLAG_[]DX_CURRENT_FEATURE$$1" = 1; then 150 if test "x$2" = "xdoxygen"; then 151 AC_MSG_ERROR([$2 not found - will not DX_CURRENT_DESCRIPTION]) 152 else 153 AC_MSG_WARN([$2 not found - will not DX_CURRENT_DESCRIPTION]) 154 fi 155 AC_SUBST(DX_FLAG_[]DX_CURRENT_FEATURE, 0) 156 fi 157 ]) 158 159 # DX_TEST_FEATURE(FEATURE) 160 # ------------------------ 161 # Expand to a shell expression testing whether the feature is active. 162 AC_DEFUN([DX_TEST_FEATURE], [test "$DX_FLAG_$1" = 1]) 163 164 # DX_CHECK_DEPEND(REQUIRED_FEATURE, REQUIRED_STATE) 165 # ------------------------------------------------- 166 # Verify that a required features has the right state before trying to turn on 167 # the DX_CURRENT_FEATURE. 168 AC_DEFUN([DX_CHECK_DEPEND], [ 169 test "$DX_FLAG_$1" = "$2" \ 170 || AC_MSG_ERROR([doxygen-DX_CURRENT_FEATURE ifelse([$2], 1, 171 requires, contradicts) doxygen-$1]) 172 ]) 173 174 # DX_CLEAR_DEPEND(FEATURE, REQUIRED_FEATURE, REQUIRED_STATE) 175 # ---------------------------------------------------------- 176 # Turn off the DX_CURRENT_FEATURE if the required feature is off. 177 AC_DEFUN([DX_CLEAR_DEPEND], [ 178 test "$DX_FLAG_$1" = "$2" || AC_SUBST(DX_FLAG_[]DX_CURRENT_FEATURE, 0) 179 ]) 180 181 # DX_FEATURE_ARG(FEATURE, DESCRIPTION, 182 # CHECK_DEPEND, CLEAR_DEPEND, 183 # REQUIRE, DO-IF-ON, DO-IF-OFF) 184 # -------------------------------------------- 185 # Parse the command-line option controlling a feature. CHECK_DEPEND is called 186 # if the user explicitly turns the feature on (and invokes DX_CHECK_DEPEND), 187 # otherwise CLEAR_DEPEND is called to turn off the default state if a required 188 # feature is disabled (using DX_CLEAR_DEPEND). REQUIRE performs additional 189 # requirement tests (DX_REQUIRE_PROG). Finally, an automake flag is set and 190 # DO-IF-ON or DO-IF-OFF are called according to the final state of the feature. 191 AC_DEFUN([DX_ARG_ABLE], [ 192 AC_DEFUN([DX_CURRENT_FEATURE], [$1]) 193 AC_DEFUN([DX_CURRENT_DESCRIPTION], [$2]) 194 AC_ARG_ENABLE(doxygen-$1, 195 [AS_HELP_STRING(DX_IF_FEATURE([$1], [--disable-doxygen-$1], 196 [--enable-doxygen-$1]), 197 DX_IF_FEATURE([$1], [don't $2], [$2]))], 198 [ 199 case "$enableval" in 200 #( 201 y|Y|yes|Yes|YES) 202 AC_SUBST([DX_FLAG_$1], 1) 203 $3 204 ;; #( 205 n|N|no|No|NO) 206 AC_SUBST([DX_FLAG_$1], 0) 207 ;; #( 208 *) 209 AC_MSG_ERROR([invalid value '$enableval' given to doxygen-$1]) 210 ;; 211 esac 212 ], [ 213 AC_SUBST([DX_FLAG_$1], [DX_IF_FEATURE([$1], 1, 0)]) 214 $4 215 ]) 216 if DX_TEST_FEATURE([$1]); then 217 $5 218 : 219 fi 220 if DX_TEST_FEATURE([$1]); then 221 $6 222 : 223 else 224 $7 225 : 226 fi 227 ]) 228 229 ## -------------- ## 230 ## Public macros. ## 231 ## -------------- ## 232 233 # DX_XXX_FEATURE(DEFAULT_STATE) 234 # ----------------------------- 235 AC_DEFUN([DX_DOXYGEN_FEATURE], [AC_DEFUN([DX_FEATURE_doc], [$1])]) 236 AC_DEFUN([DX_DOT_FEATURE], [AC_DEFUN([DX_FEATURE_dot], [$1])]) 237 AC_DEFUN([DX_MAN_FEATURE], [AC_DEFUN([DX_FEATURE_man], [$1])]) 238 AC_DEFUN([DX_HTML_FEATURE], [AC_DEFUN([DX_FEATURE_html], [$1])]) 239 AC_DEFUN([DX_CHM_FEATURE], [AC_DEFUN([DX_FEATURE_chm], [$1])]) 240 AC_DEFUN([DX_CHI_FEATURE], [AC_DEFUN([DX_FEATURE_chi], [$1])]) 241 AC_DEFUN([DX_RTF_FEATURE], [AC_DEFUN([DX_FEATURE_rtf], [$1])]) 242 AC_DEFUN([DX_XML_FEATURE], [AC_DEFUN([DX_FEATURE_xml], [$1])]) 243 AC_DEFUN([DX_XML_FEATURE], [AC_DEFUN([DX_FEATURE_xml], [$1])]) 244 AC_DEFUN([DX_PDF_FEATURE], [AC_DEFUN([DX_FEATURE_pdf], [$1])]) 245 AC_DEFUN([DX_PS_FEATURE], [AC_DEFUN([DX_FEATURE_ps], [$1])]) 246 247 # DX_INIT_DOXYGEN(PROJECT, [CONFIG-FILE], [OUTPUT-DOC-DIR], ...) 248 # -------------------------------------------------------------- 249 # PROJECT also serves as the base name for the documentation files. 250 # The default CONFIG-FILE is "$(srcdir)/Doxyfile" and OUTPUT-DOC-DIR is 251 # "doxygen-doc". 252 # More arguments are interpreted as interleaved CONFIG-FILE and 253 # OUTPUT-DOC-DIR values. 254 AC_DEFUN([DX_INIT_DOXYGEN], [ 255 256 # Files: 257 AC_SUBST([DX_PROJECT], [$1]) 258 AC_SUBST([DX_CONFIG], ['ifelse([$2], [], [$(srcdir)/Doxyfile], [$2])']) 259 AC_SUBST([DX_DOCDIR], ['ifelse([$3], [], [doxygen-doc], [$3])']) 260 m4_if(m4_eval(3 < m4_count($@)), 1, [m4_for([DX_i], 4, m4_count($@), 2, 261 [AC_SUBST([DX_CONFIG]m4_eval(DX_i[/2]), 262 'm4_default_nblank_quoted(m4_argn(DX_i, $@), 263 [$(srcdir)/Doxyfile])')])])dnl 264 m4_if(m4_eval(3 < m4_count($@)), 1, [m4_for([DX_i], 5, m4_count($@,), 2, 265 [AC_SUBST([DX_DOCDIR]m4_eval([(]DX_i[-1)/2]), 266 'm4_default_nblank_quoted(m4_argn(DX_i, $@), 267 [doxygen-doc])')])])dnl 268 m4_define([DX_loop], m4_dquote(m4_if(m4_eval(3 < m4_count($@)), 1, 269 [m4_for([DX_i], 4, m4_count($@), 2, [, m4_eval(DX_i[/2])])], 270 [])))dnl 271 272 # Environment variables used inside doxygen.cfg: 273 DX_ENV_APPEND(SRCDIR, $srcdir) 274 DX_ENV_APPEND(PROJECT, $DX_PROJECT) 275 DX_ENV_APPEND(VERSION, $PACKAGE_VERSION) 276 277 # Doxygen itself: 278 DX_ARG_ABLE(doc, [generate any doxygen documentation], 279 [], 280 [], 281 [DX_REQUIRE_PROG([DX_DOXYGEN], doxygen) 282 DX_REQUIRE_PROG([DX_PERL], perl)], 283 [DX_ENV_APPEND(PERL_PATH, $DX_PERL)]) 284 285 # Dot for graphics: 286 DX_ARG_ABLE(dot, [generate graphics for doxygen documentation], 287 [DX_CHECK_DEPEND(doc, 1)], 288 [DX_CLEAR_DEPEND(doc, 1)], 289 [DX_REQUIRE_PROG([DX_DOT], dot)], 290 [DX_ENV_APPEND(HAVE_DOT, YES) 291 DX_ENV_APPEND(DOT_PATH, [`DX_DIRNAME_EXPR($DX_DOT)`])], 292 [DX_ENV_APPEND(HAVE_DOT, NO)]) 293 294 # Man pages generation: 295 DX_ARG_ABLE(man, [generate doxygen manual pages], 296 [DX_CHECK_DEPEND(doc, 1)], 297 [DX_CLEAR_DEPEND(doc, 1)], 298 [], 299 [DX_ENV_APPEND(GENERATE_MAN, YES)], 300 [DX_ENV_APPEND(GENERATE_MAN, NO)]) 301 302 # RTF file generation: 303 DX_ARG_ABLE(rtf, [generate doxygen RTF documentation], 304 [DX_CHECK_DEPEND(doc, 1)], 305 [DX_CLEAR_DEPEND(doc, 1)], 306 [], 307 [DX_ENV_APPEND(GENERATE_RTF, YES)], 308 [DX_ENV_APPEND(GENERATE_RTF, NO)]) 309 310 # XML file generation: 311 DX_ARG_ABLE(xml, [generate doxygen XML documentation], 312 [DX_CHECK_DEPEND(doc, 1)], 313 [DX_CLEAR_DEPEND(doc, 1)], 314 [], 315 [DX_ENV_APPEND(GENERATE_XML, YES)], 316 [DX_ENV_APPEND(GENERATE_XML, NO)]) 317 318 # (Compressed) HTML help generation: 319 DX_ARG_ABLE(chm, [generate doxygen compressed HTML help documentation], 320 [DX_CHECK_DEPEND(doc, 1)], 321 [DX_CLEAR_DEPEND(doc, 1)], 322 [DX_REQUIRE_PROG([DX_HHC], hhc)], 323 [DX_ENV_APPEND(HHC_PATH, $DX_HHC) 324 DX_ENV_APPEND(GENERATE_HTML, YES) 325 DX_ENV_APPEND(GENERATE_HTMLHELP, YES)], 326 [DX_ENV_APPEND(GENERATE_HTMLHELP, NO)]) 327 328 # Separate CHI file generation. 329 DX_ARG_ABLE(chi, [generate doxygen separate compressed HTML help index file], 330 [DX_CHECK_DEPEND(chm, 1)], 331 [DX_CLEAR_DEPEND(chm, 1)], 332 [], 333 [DX_ENV_APPEND(GENERATE_CHI, YES)], 334 [DX_ENV_APPEND(GENERATE_CHI, NO)]) 335 336 # Plain HTML pages generation: 337 DX_ARG_ABLE(html, [generate doxygen plain HTML documentation], 338 [DX_CHECK_DEPEND(doc, 1) DX_CHECK_DEPEND(chm, 0)], 339 [DX_CLEAR_DEPEND(doc, 1) DX_CLEAR_DEPEND(chm, 0)], 340 [], 341 [DX_ENV_APPEND(GENERATE_HTML, YES)], 342 [DX_TEST_FEATURE(chm) || DX_ENV_APPEND(GENERATE_HTML, NO)]) 343 344 # PostScript file generation: 345 DX_ARG_ABLE(ps, [generate doxygen PostScript documentation], 346 [DX_CHECK_DEPEND(doc, 1)], 347 [DX_CLEAR_DEPEND(doc, 1)], 348 [DX_REQUIRE_PROG([DX_LATEX], latex) 349 DX_REQUIRE_PROG([DX_MAKEINDEX], makeindex) 350 DX_REQUIRE_PROG([DX_DVIPS], dvips) 351 DX_REQUIRE_PROG([DX_EGREP], egrep)]) 352 353 # PDF file generation: 354 DX_ARG_ABLE(pdf, [generate doxygen PDF documentation], 355 [DX_CHECK_DEPEND(doc, 1)], 356 [DX_CLEAR_DEPEND(doc, 1)], 357 [DX_REQUIRE_PROG([DX_PDFLATEX], pdflatex) 358 DX_REQUIRE_PROG([DX_MAKEINDEX], makeindex) 359 DX_REQUIRE_PROG([DX_EGREP], egrep)]) 360 361 # LaTeX generation for PS and/or PDF: 362 if DX_TEST_FEATURE(ps) || DX_TEST_FEATURE(pdf); then 363 DX_ENV_APPEND(GENERATE_LATEX, YES) 364 else 365 DX_ENV_APPEND(GENERATE_LATEX, NO) 366 fi 367 368 # Paper size for PS and/or PDF: 369 AC_ARG_VAR(DOXYGEN_PAPER_SIZE, 370 [a4wide (default), a4, letter, legal or executive]) 371 case "$DOXYGEN_PAPER_SIZE" in 372 #( 373 "") 374 AC_SUBST(DOXYGEN_PAPER_SIZE, "") 375 ;; #( 376 a4wide|a4|letter|legal|executive) 377 DX_ENV_APPEND(PAPER_SIZE, $DOXYGEN_PAPER_SIZE) 378 ;; #( 379 *) 380 AC_MSG_ERROR([unknown DOXYGEN_PAPER_SIZE='$DOXYGEN_PAPER_SIZE']) 381 ;; 382 esac 383 384 # Rules: 385 AS_IF([[test $DX_FLAG_html -eq 1]], 386 [[DX_SNIPPET_html="## ------------------------------- ## 387 ## Rules specific for HTML output. ## 388 ## ------------------------------- ## 389 390 DX_CLEAN_HTML = \$(DX_DOCDIR)/html]dnl 391 m4_foreach([DX_i], [m4_shift(DX_loop)], [[\\ 392 \$(DX_DOCDIR]DX_i[)/html]])[ 393 394 "]], 395 [[DX_SNIPPET_html=""]]) 396 AS_IF([[test $DX_FLAG_chi -eq 1]], 397 [[DX_SNIPPET_chi=" 398 DX_CLEAN_CHI = \$(DX_DOCDIR)/\$(PACKAGE).chi]dnl 399 m4_foreach([DX_i], [m4_shift(DX_loop)], [[\\ 400 \$(DX_DOCDIR]DX_i[)/\$(PACKAGE).chi]])["]], 401 [[DX_SNIPPET_chi=""]]) 402 AS_IF([[test $DX_FLAG_chm -eq 1]], 403 [[DX_SNIPPET_chm="## ------------------------------ ## 404 ## Rules specific for CHM output. ## 405 ## ------------------------------ ## 406 407 DX_CLEAN_CHM = \$(DX_DOCDIR)/chm]dnl 408 m4_foreach([DX_i], [m4_shift(DX_loop)], [[\\ 409 \$(DX_DOCDIR]DX_i[)/chm]])[\ 410 ${DX_SNIPPET_chi} 411 412 "]], 413 [[DX_SNIPPET_chm=""]]) 414 AS_IF([[test $DX_FLAG_man -eq 1]], 415 [[DX_SNIPPET_man="## ------------------------------ ## 416 ## Rules specific for MAN output. ## 417 ## ------------------------------ ## 418 419 DX_CLEAN_MAN = \$(DX_DOCDIR)/man]dnl 420 m4_foreach([DX_i], [m4_shift(DX_loop)], [[\\ 421 \$(DX_DOCDIR]DX_i[)/man]])[ 422 423 "]], 424 [[DX_SNIPPET_man=""]]) 425 AS_IF([[test $DX_FLAG_rtf -eq 1]], 426 [[DX_SNIPPET_rtf="## ------------------------------ ## 427 ## Rules specific for RTF output. ## 428 ## ------------------------------ ## 429 430 DX_CLEAN_RTF = \$(DX_DOCDIR)/rtf]dnl 431 m4_foreach([DX_i], [m4_shift(DX_loop)], [[\\ 432 \$(DX_DOCDIR]DX_i[)/rtf]])[ 433 434 "]], 435 [[DX_SNIPPET_rtf=""]]) 436 AS_IF([[test $DX_FLAG_xml -eq 1]], 437 [[DX_SNIPPET_xml="## ------------------------------ ## 438 ## Rules specific for XML output. ## 439 ## ------------------------------ ## 440 441 DX_CLEAN_XML = \$(DX_DOCDIR)/xml]dnl 442 m4_foreach([DX_i], [m4_shift(DX_loop)], [[\\ 443 \$(DX_DOCDIR]DX_i[)/xml]])[ 444 445 "]], 446 [[DX_SNIPPET_xml=""]]) 447 AS_IF([[test $DX_FLAG_ps -eq 1]], 448 [[DX_SNIPPET_ps="## ----------------------------- ## 449 ## Rules specific for PS output. ## 450 ## ----------------------------- ## 451 452 DX_CLEAN_PS = \$(DX_DOCDIR)/\$(PACKAGE).ps]dnl 453 m4_foreach([DX_i], [m4_shift(DX_loop)], [[\\ 454 \$(DX_DOCDIR]DX_i[)/\$(PACKAGE).ps]])[ 455 456 DX_PS_GOAL = doxygen-ps 457 458 doxygen-ps: \$(DX_CLEAN_PS) 459 460 ]m4_foreach([DX_i], [DX_loop], 461 [[\$(DX_DOCDIR]DX_i[)/\$(PACKAGE).ps: \$(DX_DOCDIR]DX_i[)/\$(PACKAGE).tag 462 \$(DX_V_LATEX)cd \$(DX_DOCDIR]DX_i[)/latex; \\ 463 rm -f *.aux *.toc *.idx *.ind *.ilg *.log *.out; \\ 464 \$(DX_LATEX) refman.tex; \\ 465 \$(DX_MAKEINDEX) refman.idx; \\ 466 \$(DX_LATEX) refman.tex; \\ 467 countdown=5; \\ 468 while \$(DX_EGREP) 'Rerun (LaTeX|to get cross-references right)' \\ 469 refman.log > /dev/null 2>&1 \\ 470 && test \$\$countdown -gt 0; do \\ 471 \$(DX_LATEX) refman.tex; \\ 472 countdown=\`expr \$\$countdown - 1\`; \\ 473 done; \\ 474 \$(DX_DVIPS) -o ../\$(PACKAGE).ps refman.dvi 475 476 ]])["]], 477 [[DX_SNIPPET_ps=""]]) 478 AS_IF([[test $DX_FLAG_pdf -eq 1]], 479 [[DX_SNIPPET_pdf="## ------------------------------ ## 480 ## Rules specific for PDF output. ## 481 ## ------------------------------ ## 482 483 DX_CLEAN_PDF = \$(DX_DOCDIR)/\$(PACKAGE).pdf]dnl 484 m4_foreach([DX_i], [m4_shift(DX_loop)], [[\\ 485 \$(DX_DOCDIR]DX_i[)/\$(PACKAGE).pdf]])[ 486 487 DX_PDF_GOAL = doxygen-pdf 488 489 doxygen-pdf: \$(DX_CLEAN_PDF) 490 491 ]m4_foreach([DX_i], [DX_loop], 492 [[\$(DX_DOCDIR]DX_i[)/\$(PACKAGE).pdf: \$(DX_DOCDIR]DX_i[)/\$(PACKAGE).tag 493 \$(DX_V_LATEX)cd \$(DX_DOCDIR]DX_i[)/latex; \\ 494 rm -f *.aux *.toc *.idx *.ind *.ilg *.log *.out; \\ 495 \$(DX_PDFLATEX) refman.tex; \\ 496 \$(DX_MAKEINDEX) refman.idx; \\ 497 \$(DX_PDFLATEX) refman.tex; \\ 498 countdown=5; \\ 499 while \$(DX_EGREP) 'Rerun (LaTeX|to get cross-references right)' \\ 500 refman.log > /dev/null 2>&1 \\ 501 && test \$\$countdown -gt 0; do \\ 502 \$(DX_PDFLATEX) refman.tex; \\ 503 countdown=\`expr \$\$countdown - 1\`; \\ 504 done; \\ 505 mv refman.pdf ../\$(PACKAGE).pdf 506 507 ]])["]], 508 [[DX_SNIPPET_pdf=""]]) 509 AS_IF([[test $DX_FLAG_ps -eq 1 -o $DX_FLAG_pdf -eq 1]], 510 [[DX_SNIPPET_latex="## ------------------------------------------------- ## 511 ## Rules specific for LaTeX (shared for PS and PDF). ## 512 ## ------------------------------------------------- ## 513 514 DX_V_LATEX = \$(_DX_v_LATEX_\$(V)) 515 _DX_v_LATEX_ = \$(_DX_v_LATEX_\$(AM_DEFAULT_VERBOSITY)) 516 _DX_v_LATEX_0 = @echo \" LATEX \" \$][@; 517 518 DX_CLEAN_LATEX = \$(DX_DOCDIR)/latex]dnl 519 m4_foreach([DX_i], [m4_shift(DX_loop)], [[\\ 520 \$(DX_DOCDIR]DX_i[)/latex]])[ 521 522 "]], 523 [[DX_SNIPPET_latex=""]]) 524 525 AS_IF([[test $DX_FLAG_doc -eq 1]], 526 [[DX_SNIPPET_doc="## --------------------------------- ## 527 ## Format-independent Doxygen rules. ## 528 ## --------------------------------- ## 529 530 ${DX_SNIPPET_html}\ 531 ${DX_SNIPPET_chm}\ 532 ${DX_SNIPPET_man}\ 533 ${DX_SNIPPET_rtf}\ 534 ${DX_SNIPPET_xml}\ 535 ${DX_SNIPPET_ps}\ 536 ${DX_SNIPPET_pdf}\ 537 ${DX_SNIPPET_latex}\ 538 DX_V_DXGEN = \$(_DX_v_DXGEN_\$(V)) 539 _DX_v_DXGEN_ = \$(_DX_v_DXGEN_\$(AM_DEFAULT_VERBOSITY)) 540 _DX_v_DXGEN_0 = @echo \" DXGEN \" \$<; 541 542 .PHONY: doxygen-run doxygen-doc \$(DX_PS_GOAL) \$(DX_PDF_GOAL) 543 544 .INTERMEDIATE: doxygen-run \$(DX_PS_GOAL) \$(DX_PDF_GOAL) 545 546 doxygen-run:]m4_foreach([DX_i], [DX_loop], 547 [[ \$(DX_DOCDIR]DX_i[)/\$(PACKAGE).tag]])[ 548 549 doxygen-doc: doxygen-run \$(DX_PS_GOAL) \$(DX_PDF_GOAL) 550 551 ]m4_foreach([DX_i], [DX_loop], 552 [[\$(DX_DOCDIR]DX_i[)/\$(PACKAGE).tag: \$(DX_CONFIG]DX_i[) \$(pkginclude_HEADERS) 553 \$(A""M_V_at)rm -rf \$(DX_DOCDIR]DX_i[) 554 \$(DX_V_DXGEN)\$(DX_ENV) DOCDIR=\$(DX_DOCDIR]DX_i[) \$(DX_DOXYGEN) \$(DX_CONFIG]DX_i[) 555 \$(A""M_V_at)echo Timestamp >\$][@ 556 557 ]])dnl 558 [DX_CLEANFILES = \\] 559 m4_foreach([DX_i], [DX_loop], 560 [[ \$(DX_DOCDIR]DX_i[)/doxygen_sqlite3.db \\ 561 \$(DX_DOCDIR]DX_i[)/\$(PACKAGE).tag \\ 562 ]])dnl 563 [ -r \\ 564 \$(DX_CLEAN_HTML) \\ 565 \$(DX_CLEAN_CHM) \\ 566 \$(DX_CLEAN_CHI) \\ 567 \$(DX_CLEAN_MAN) \\ 568 \$(DX_CLEAN_RTF) \\ 569 \$(DX_CLEAN_XML) \\ 570 \$(DX_CLEAN_PS) \\ 571 \$(DX_CLEAN_PDF) \\ 572 \$(DX_CLEAN_LATEX) 573 DX_INSTALL_DOCS = \\ 574 \$(DX_CLEAN_HTML) \\ 575 \$(DX_CLEAN_CHM) \\ 576 \$(DX_CLEAN_CHI) \\ 577 \$(DX_CLEAN_RTF) \\ 578 \$(DX_CLEAN_XML) \\ 579 \$(DX_CLEAN_PS) \\ 580 \$(DX_CLEAN_PDF) \\ 581 \$(DX_CLEAN_LATEX) 582 "]], 583 [[DX_SNIPPET_doc=""]]) 584 AC_SUBST([DX_RULES], 585 ["${DX_SNIPPET_doc}"])dnl 586 AM_SUBST_NOTMAKE([DX_RULES]) 587 588 #For debugging: 589 #echo DX_FLAG_doc=$DX_FLAG_doc 590 #echo DX_FLAG_dot=$DX_FLAG_dot 591 #echo DX_FLAG_man=$DX_FLAG_man 592 #echo DX_FLAG_html=$DX_FLAG_html 593 #echo DX_FLAG_chm=$DX_FLAG_chm 594 #echo DX_FLAG_chi=$DX_FLAG_chi 595 #echo DX_FLAG_rtf=$DX_FLAG_rtf 596 #echo DX_FLAG_xml=$DX_FLAG_xml 597 #echo DX_FLAG_pdf=$DX_FLAG_pdf 598 #echo DX_FLAG_ps=$DX_FLAG_ps 599 #echo DX_ENV=$DX_ENV 600 ]) 601
Indexes created Sat Apr 11 00:22:22 UTC 2026