tools/kerneldoc/subsys/Makefile

   1 #
   2 # $FreeBSD$
   3 #
   4
   5 _ALL!=  cd ${.CURDIR} && ls Doxyfile-*
   6 ALL=    ${_ALL:C/Doxyfile-//g}
   7 PDF_ALL=${_ALL:C/Doxyfile/pdf/g}
   8
   9 TARGET_ARCH?=   ${MACHINE_ARCH}
  10 S?=/usr/src/sys
  11 LOCALBASE?=/usr/local
  12
  13 MFILES+=dev/acpica/acpi_if.m
  14 MFILES+=dev/ata/ata_if.m
  15 MFILES+=dev/eisa/eisa_if.m
  16 MFILES+=dev/iicbus/iicbb_if.m
  17 MFILES+=dev/iicbus/iicbus_if.m
  18 MFILES+=dev/mii/miibus_if.m
  19 MFILES+=dev/ofw/ofw_bus_if.m
  20 MFILES+=dev/pccard/card_if.m
  21 MFILES+=dev/pccard/power_if.m
  22 MFILES+=dev/pci/pci_if.m
  23 MFILES+=dev/pci/pcib_if.m
  24 MFILES+=dev/ppbus/ppbus_if.m
  25 MFILES+=dev/scc/scc_if.m
  26 MFILES+=dev/smbus/smbus_if.m
  27 MFILES+=dev/sound/midi/mpu_if.m
  28 MFILES+=dev/sound/midi/mpufoi_if.m
  29 MFILES+=dev/sound/midi/synth_if.m
  30 MFILES+=dev/sound/pcm/ac97_if.m
  31 MFILES+=dev/sound/pcm/channel_if.m
  32 MFILES+=dev/sound/pcm/feeder_if.m
  33 MFILES+=dev/sound/pcm/mixer_if.m
  34 MFILES+=dev/uart/uart_if.m
  35 MFILES+=dev/usb/usb_if.m
  36 MFILES+=isa/isa_if.m
  37 MFILES+=kern/bus_if.m
  38 MFILES+=kern/clock_if.m
  39 MFILES+=kern/cpufreq_if.m
  40 MFILES+=kern/device_if.m
  41 MFILES+=kern/linker_if.m
  42 MFILES+=kern/serdev_if.m
  43 MFILES+=libkern/iconv_converter_if.m
  44 MFILES+=opencrypto/crypto_if.m
  45 MFILES+=pc98/pc98/canbus_if.m
  46 MFILES+=pci/agp_if.m
  47 MFILES+=powerpc/powerpc/mmu_if.m
  48 MFILES+=powerpc/powerpc/pic_if.m
  49 MFILES+=sparc64/pci/ofw_pci_if.m
  50
  51 HFILES= ${MFILES:T:S/.m$/.h/}
  52 AWK?=   awk
  53
  54 .MAIN:  usage
  55
  56 usage:
  57         @echo "Possible targets are:"
  58 .for entry in ${ALL}
  59         @echo " ${entry}"
  60         @echo " pdf-${entry}"
  61         @echo " clean-${entry}"
  62 .endfor
  63         @echo
  64         @echo " all"
  65         @echo " pdf-all"
  66         @echo " clean"
  67
  68 all:    ${ALL}
  69 pdf-all:${PDF_ALL}
  70
  71 mfiles: ${HFILES:S/^/${.OBJDIR}\//}
  72
  73 DOXYGEN_DEST_PATH=      ${.OBJDIR}
  74 DOXYGEN_LATEX_DEST_PATH=${.OBJDIR}
  75 DOXYGEN_PDF_DEST_PATH=  ${.OBJDIR}
  76
  77 .if exists{${S}/${TARGET_ARCH}/linux}
  78 DOXYGEN_LINUX_PATH=     ${S}/${TARGET_ARCH}/linux
  79 .endif
  80 .if exists{${S}/${TARGET_ARCH}/linux32}
  81 DOXYGEN_LINUX_PATH+=    ${S}/${TARGET_ARCH}/linux32
  82 .endif
  83
  84 #
  85 # generate the necessary targets
  86 #
  87 .for target in ${ALL}
  88 ${target}:      mfiles ${.OBJDIR}/${target}/${target}.tag
  89
  90 ${.OBJDIR}/${target}/${target}.tag:
  91         @mkdir -p ${.OBJDIR}/${target}
  92         @cd ${.OBJDIR} && \
  93                 env DOXYGEN_INCLUDE_PATH=${.CURDIR} \
  94                     DOXYGEN_SRC_PATH=${S}  \
  95                     DOXYGEN_DEST_PATH=${DOXYGEN_DEST_PATH} \
  96                     DOXYGEN_SRC_INCLUDE_PATH="${S}/sys ${S}/../include ${S}/${TARGET_ARCH}/include" \
  97                     DOXYGEN_TARGET_ARCH=${TARGET_ARCH} \
  98                     DOXYGEN_LINUX_PATH=${DOXYGEN_LINUX_PATH} \
  99                     NOTREVIEWED=${.CURDIR}/notreviewed.dox \
 100                     PATH=${LOCALBASE}/bin:${PATH} \
 101                         doxygen ${.CURDIR}/Doxyfile-${target}
 102         @echo "API docs for ${target} are now available in ${.OBJDIR}/${target}/." | /usr/bin/fmt
 103
 104 pdf-${target}:  ${.OBJDIR}/${target}/${target}.tag
 105         @cd ${DOXYGEN_LATEX_DEST_PATH}/${target}/latex && ${MAKE} refman.pdf && cp refman.pdf ${DOXYGEN_PDF_DEST_PATH}/${target}.pdf
 106         @echo "API docs for ${target} are now available in ${DOXYGEN_PDF_DEST_PATH}/." | /usr/bin/fmt
 107
 108 CLEANDIRS+=     ${DOXYGEN_DEST_PATH}/${target}
 109 CLEANDIRS+=     ${.OBJDIR}/${target}/
 110 CLEANFILES+=    ${DOXYGEN_PDF_DEST_PATH}/${target}.pdf
 111 clean-${target}:
 112         rm -rf ${DOXYGEN_DEST_PATH}/${target} ${.OBJDIR}/${target}
 113 .endfor
 114
 115 .for file in ${MFILES}
 116 CLEANDIRS+=     ${.OBJDIR}/${file:T:S/.m$/.h/}
 117 ${.OBJDIR}/${file:T:S/.m$/.h/}: ${S}/${file}
 118         cd ${.OBJDIR}; ${AWK} -f $S/tools/makeobjops.awk ${S}/${file} -h
 119 .endfor
 120
 121 #
 122 # update target for the config files {config syntax change}
 123 #
 124 update-doxys:
 125 .for config_file in ${_ALL}
 126         @doxygen -u ${config_file}
 127 .endfor
 128
 129 .include "Dependencies"
 130 .include <bsd.obj.mk>