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