mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
531cab5fc4
Newer versions of doxygen will give warnings for comments in INPUT lists Delete all comment lines to fix these warnings, our folder structure stil gives an OK overview of what we are including
220 lines
11 KiB
Plaintext
220 lines
11 KiB
Plaintext
# This is Doxygen configuration file
|
|
#
|
|
# Doxygen provides over 260 configuration statements
|
|
# To make this file easier to follow,
|
|
# it contains only statements that are non-default
|
|
#
|
|
# NOTE:
|
|
# It is recommended not to change defaults unless specifically required
|
|
# Test any changes how they affect generated documentation
|
|
# Make sure that correct warnings are generated to flag issues with documented code
|
|
#
|
|
# For the complete list of configuration statements see:
|
|
# https://www.stack.nl/~dimitri/doxygen/manual/config.html
|
|
|
|
|
|
PROJECT_NAME = "ESP32 Programming Guide"
|
|
|
|
## The 'INPUT' statement below is used as input by script 'gen-df-input.py'
|
|
## to automatically generate API reference list files heder_file.inc
|
|
## These files are placed in '_inc' directory
|
|
## and used to include in API reference documentation
|
|
|
|
INPUT = \
|
|
../../components/esp_wifi/include/esp_wifi.h \
|
|
../../components/esp_wifi/include/esp_wifi_types.h \
|
|
../../components/esp_wifi/include/esp_smartconfig.h \
|
|
../../components/esp_wifi/include/esp_now.h \
|
|
../../components/esp_wifi/include/esp_mesh.h \
|
|
../../components/esp_event/include/esp_event.h \
|
|
../../components/esp_event/include/esp_event_base.h \
|
|
../../components/esp_event/include/esp_event_legacy.h \
|
|
../../components/bt/include/esp_bt.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_bt_defs.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_bt_main.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_bt_device.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_gap_ble_api.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_gatt_defs.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_gatts_api.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_gattc_api.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_blufi_api.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_gap_bt_api.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_a2dp_api.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_avrc_api.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_spp_api.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_hf_defs.h \
|
|
../../components/bt/host/bluedroid/api/include/api/esp_hf_client_api.h \
|
|
../../components/bt/host/nimble/esp-hci/include/esp_nimble_hci.h \
|
|
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_common_api.h \
|
|
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_local_data_operation_api.h \
|
|
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_low_power_api.h \
|
|
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_networking_api.h \
|
|
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_provisioning_api.h \
|
|
../../components/bt/esp_ble_mesh/api/core/include/esp_ble_mesh_proxy_api.h \
|
|
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_config_model_api.h \
|
|
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_generic_model_api.h \
|
|
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_health_model_api.h \
|
|
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_lighting_model_api.h \
|
|
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_sensor_model_api.h \
|
|
../../components/bt/esp_ble_mesh/api/models/include/esp_ble_mesh_time_scene_model_api.h \
|
|
../../components/bt/esp_ble_mesh/api/esp_ble_mesh_defs.h \
|
|
../../components/esp_eth/include/esp_eth.h \
|
|
../../components/esp_eth/include/esp_eth_com.h \
|
|
../../components/esp_eth/include/esp_eth_mac.h \
|
|
../../components/esp_eth/include/esp_eth_phy.h \
|
|
../../components/driver/include/driver/adc.h \
|
|
../../components/driver/include/driver/can.h \
|
|
../../components/driver/include/driver/dac.h \
|
|
../../components/driver/include/driver/gpio.h \
|
|
../../components/driver/include/driver/rtc_io.h \
|
|
../../components/driver/include/driver/i2c.h \
|
|
../../components/driver/include/driver/i2s.h \
|
|
../../components/driver/include/driver/ledc.h \
|
|
../../components/driver/include/driver/mcpwm.h \
|
|
../../components/driver/include/driver/pcnt.h \
|
|
../../components/driver/include/driver/rmt.h \
|
|
../../components/driver/include/driver/sigmadelta.h \
|
|
../../components/driver/include/driver/spi_common.h \
|
|
../../components/driver/include/driver/spi_master.h \
|
|
../../components/driver/include/driver/spi_slave.h \
|
|
../../components/driver/include/driver/timer.h \
|
|
../../components/driver/include/driver/touch_pad.h \
|
|
../../components/driver/include/driver/uart.h \
|
|
../../components/esp_adc_cal/include/esp_adc_cal.h \
|
|
../../components/soc/include/hal/spi_types.h \
|
|
../../components/soc/esp32/include/soc/adc_channel.h \
|
|
../../components/soc/esp32/include/soc/dac_channel.h \
|
|
../../components/soc/esp32/include/soc/touch_channel.h \
|
|
../../components/soc/esp32/include/soc/uart_channel.h \
|
|
../../components/soc/esp32/include/soc/rtc_gpio_channel.h \
|
|
../../components/tcpip_adapter/include/tcpip_adapter.h \
|
|
../../components/esp-tls/esp_tls.h \
|
|
../../components/mqtt/esp-mqtt/include/mqtt_client.h \
|
|
../../components/mdns/include/mdns.h \
|
|
../../components/esp_http_client/include/esp_http_client.h \
|
|
../../components/esp_websocket_client/include/esp_websocket_client.h \
|
|
../../components/esp_http_server/include/esp_http_server.h \
|
|
../../components/esp_https_server/include/esp_https_server.h \
|
|
../../components/esp_local_ctrl/include/esp_local_ctrl.h \
|
|
../../components/protocomm/include/common/protocomm.h \
|
|
../../components/protocomm/include/security/protocomm_security.h \
|
|
../../components/protocomm/include/security/protocomm_security0.h \
|
|
../../components/protocomm/include/security/protocomm_security1.h \
|
|
../../components/protocomm/include/transports/protocomm_ble.h \
|
|
../../components/protocomm/include/transports/protocomm_console.h \
|
|
../../components/protocomm/include/transports/protocomm_httpd.h \
|
|
../../components/wifi_provisioning/include/wifi_provisioning/manager.h \
|
|
../../components/wifi_provisioning/include/wifi_provisioning/scheme_ble.h \
|
|
../../components/wifi_provisioning/include/wifi_provisioning/scheme_softap.h \
|
|
../../components/wifi_provisioning/include/wifi_provisioning/scheme_console.h \
|
|
../../components/wifi_provisioning/include/wifi_provisioning/wifi_config.h \
|
|
../../components/wifi_provisioning/include/wifi_provisioning/wifi_scan.h \
|
|
../../components/spi_flash/include/esp_flash_spi_init.h \
|
|
../../components/spi_flash/include/esp_flash.h \
|
|
../../components/spi_flash/include/esp_partition.h \
|
|
../../components/bootloader_support/include/esp_flash_encrypt.h \
|
|
../../components/soc/include/hal/spi_flash_types.h \
|
|
../../components/spiffs/include/esp_spiffs.h \
|
|
../../components/sdmmc/include/sdmmc_cmd.h \
|
|
../../components/driver/include/driver/sdmmc_host.h \
|
|
../../components/driver/include/driver/sdmmc_types.h \
|
|
../../components/driver/include/driver/sdspi_host.h \
|
|
../../components/driver/include/driver/sdio_slave.h \
|
|
../../components/nvs_flash/include/nvs.h \
|
|
../../components/nvs_flash/include/nvs_flash.h \
|
|
../../components/vfs/include/esp_vfs.h \
|
|
../../components/vfs/include/esp_vfs_dev.h \
|
|
../../components/vfs/include/esp_vfs_semihost.h \
|
|
../../components/fatfs/vfs/esp_vfs_fat.h \
|
|
../../components/fatfs/diskio/diskio_impl.h \
|
|
../../components/fatfs/diskio/diskio_sdmmc.h \
|
|
../../components/fatfs/diskio/diskio_wl.h \
|
|
../../components/fatfs/diskio/diskio_rawflash.h \
|
|
../../components/wear_levelling/include/wear_levelling.h \
|
|
../../components/heap/include/esp_heap_caps.h \
|
|
../../components/heap/include/esp_heap_trace.h \
|
|
../../components/heap/include/esp_heap_caps_init.h \
|
|
../../components/heap/include/multi_heap.h \
|
|
../../components/esp32/include/esp32/himem.h \
|
|
../../components/esp32/include/esp_intr_alloc.h \
|
|
../../components/esp_common/include/esp_int_wdt.h \
|
|
../../components/esp_common/include/esp_task_wdt.h \
|
|
../../components/esp_common/include/esp_freertos_hooks.h \
|
|
../../components/esp_common/include/esp_ipc.h \
|
|
../../components/app_update/include/esp_ota_ops.h \
|
|
../../components/esp_https_ota/include/esp_https_ota.h \
|
|
../../components/esp32/include/esp_sleep.h \
|
|
../../components/log/include/esp_log.h \
|
|
../../components/esp_common/include/esp_system.h \
|
|
../../components/esp_common/include/esp_idf_version.h \
|
|
../../components/ulp/include/esp32/ulp.h \
|
|
../../components/app_trace/include/esp_app_trace.h \
|
|
../../components/app_trace/include/esp_sysview_trace.h \
|
|
../../components/esp_common/include/esp_pm.h \
|
|
../../components/esp32/include/esp32/pm.h \
|
|
../../components/esp_common/include/esp_timer.h \
|
|
../../components/esp_event/include/esp_event.h \
|
|
../../components/esp_event/include/esp_event_base.h \
|
|
../../components/efuse/include/esp_efuse.h \
|
|
../../components/bootloader_support/include/esp_app_format.h \
|
|
../../components/pthread/include/esp_pthread.h \
|
|
../../components/freertos/include/freertos/task.h \
|
|
../../components/freertos/include/freertos/queue.h \
|
|
../../components/freertos/include/freertos/semphr.h \
|
|
../../components/freertos/include/freertos/timers.h \
|
|
../../components/freertos/include/freertos/event_groups.h \
|
|
../../components/esp_ringbuf/include/freertos/ringbuf.h \
|
|
../../components/esp_common/include/esp_err.h \
|
|
../../components/esp_common/include/esp_system.h \
|
|
../../components/freemodbus/common/include/esp_modbus_common.h \
|
|
../../components/freemodbus/common/include/esp_modbus_slave.h \
|
|
../../components/freemodbus/common/include/esp_modbus_master.h
|
|
|
|
|
|
## Get warnings for functions that have no documentation for their parameters or return value
|
|
##
|
|
WARN_NO_PARAMDOC = YES
|
|
|
|
## Enable preprocessing and remove __attribute__(...) expressions from the INPUT files
|
|
##
|
|
ENABLE_PREPROCESSING = YES
|
|
MACRO_EXPANSION = YES
|
|
EXPAND_ONLY_PREDEF = YES
|
|
PREDEFINED = \
|
|
__attribute__(x)= \
|
|
_Static_assert()= \
|
|
IDF_DEPRECATED(X)= \
|
|
IRAM_ATTR= \
|
|
configSUPPORT_DYNAMIC_ALLOCATION=1 \
|
|
configSUPPORT_STATIC_ALLOCATION=1 \
|
|
configQUEUE_REGISTRY_SIZE=1 \
|
|
configUSE_RECURSIVE_MUTEXES=1 \
|
|
configTHREAD_LOCAL_STORAGE_DELETE_CALLBACKS=1 \
|
|
configNUM_THREAD_LOCAL_STORAGE_POINTERS=1 \
|
|
configUSE_APPLICATION_TASK_TAG=1 \
|
|
configTASKLIST_INCLUDE_COREID=1 \
|
|
"ESP_EVENT_DECLARE_BASE(x)=extern esp_event_base_t x"
|
|
|
|
## Do not complain about not having dot
|
|
##
|
|
HAVE_DOT = NO
|
|
|
|
## Generate XML that is required for Breathe
|
|
##
|
|
GENERATE_XML = YES
|
|
XML_OUTPUT = xml
|
|
|
|
GENERATE_HTML = NO
|
|
HAVE_DOT = NO
|
|
GENERATE_LATEX = NO
|
|
GENERATE_MAN = YES
|
|
GENERATE_RTF = NO
|
|
|
|
## Skip distracting progress messages
|
|
##
|
|
QUIET = YES
|
|
## Log warnings in a file for further review
|
|
##
|
|
WARN_LOGFILE = "doxygen-warning-log.txt"
|
|
|