# Doxyfile for libcudacxx

PROJECT_NAME           = libcudacxx
OUTPUT_DIRECTORY       = ../_build/doxygen/libcudacxx
CREATE_SUBDIRS         = NO
GENERATE_HTML          = NO
GENERATE_LATEX         = NO
GENERATE_XML           = YES
XML_OUTPUT             = xml
XML_PROGRAMLISTING     = YES

INPUT                  = ../../libcudacxx/include/cuda/__algorithm \
                         ../../libcudacxx/include/cuda/__container \
                         ../../libcudacxx/include/cuda/__device \
                         ../../libcudacxx/include/cuda/__event \
                         ../../libcudacxx/include/cuda/__hierarchy \
                         ../../libcudacxx/include/cuda/__iterator \
                         ../../libcudacxx/include/cuda/__launch \
                         ../../libcudacxx/include/cuda/__memory_pool \
                         ../../libcudacxx/include/cuda/__memory_resource \
                         ../../libcudacxx/include/cuda/__stream \
                         ../../libcudacxx/include/nv \
                         ../../libcudacxx/include/cuda/std/__cccl/architecture.h \
                         ../../libcudacxx/include/cuda/std/__cccl/os.h

RECURSIVE              = YES
EXCLUDE_PATTERNS       = */detail/* */test/* */tests/* */examples/* */__detail/* */std/__cccl/compiler.h
EXCLUDE_SYMBOLS        = *detail* *__* _LIBCUDACXX_*

FILE_PATTERNS          = *.h *.hpp *.cuh
EXTENSION_MAPPING      = cuh=C++ cu=C++

# Documentation extraction settings
EXTRACT_ALL            = YES
EXTRACT_PRIVATE        = NO
EXTRACT_STATIC         = YES
EXTRACT_LOCAL_CLASSES  = YES
HIDE_UNDOC_MEMBERS     = NO
HIDE_UNDOC_CLASSES     = NO
SHOW_INCLUDE_FILES     = YES
INLINE_INHERITED_MEMB  = YES
FULL_PATH_NAMES        = YES
STRIP_FROM_PATH        = ../../libcudacxx
SHORT_NAMES            = NO

# Parsing settings
JAVADOC_AUTOBRIEF      = YES
QT_AUTOBRIEF           = NO
MULTILINE_CPP_IS_BRIEF = NO
INHERIT_DOCS           = YES
SEPARATE_MEMBER_PAGES  = NO
TAB_SIZE               = 4
BUILTIN_STL_SUPPORT    = YES

# Preprocessing
ENABLE_PREPROCESSING   = YES
MACRO_EXPANSION        = YES
EXPAND_ONLY_PREDEF     = NO
SEARCH_INCLUDES        = YES
SKIP_FUNCTION_MACROS   = YES

# Predefined macros for libcudacxx
PREDEFINED = \
    "__device__=" \
    "__host__=" \
    "__global__=" \
    "__forceinline__=" \
    "__declspec(x)=" \
    "__align__(x)=" \
    "_CCCL_DOXYGEN_INVOKED" \
    "_CCCL_HOST_DEVICE=" \
    "_CCCL_DEVICE=" \
    "_CCCL_HOST=" \
    "_CCCL_FORCEINLINE=" \
    "_CCCL_CONSTEXPR_CXX14=constexpr" \
    "_CCCL_CONSTEXPR_CXX17=constexpr" \
    "_CCCL_CONSTEXPR_CXX20=constexpr" \
    "_CCCL_CONSTEXPR_CXX23=constexpr" \
    "_LIBCUDACXX_HIDE_FROM_ABI=" \
    "_LIBCUDACXX_INLINE_VISIBILITY=" \
    "_LIBCUDACXX_TEMPLATE_VIS=" \
    "__cccl_lib_mdspan" \
    "_CCCL_AND=&&" \
    "_CCCL_API=inline" \
    "_CCCL_HOST_DEVICE_API=inline" \
    "_CCCL_BEGIN_NAMESPACE_ARCH_DEPENDENT="\
    "_CCCL_BEGIN_NAMESPACE_CUDA=namespace cuda {" \
    "_CCCL_BEGIN_NAMESPACE_CUDA_DEVICE=namespace cuda::device {" \
    "_CCCL_BEGIN_NAMESPACE_CUDA_DEVICE_EXPERIMENTAL=namespace cuda::device::experimental {" \
    "_CCCL_BEGIN_NAMESPACE_CUDA_DRIVER=namespace cuda::__driver {" \
    "_CCCL_BEGIN_NAMESPACE_CUDA_EXECUTION=namespace cuda::execution {" \
    "_CCCL_BEGIN_NAMESPACE_CUDA_MR=namespace cuda::mr {" \
    "_CCCL_BEGIN_NAMESPACE_CUDA_PTX =namespace cuda::ptx {" \
    "_CCCL_BEGIN_NAMESPACE_CUDA_STD=namespace cuda::std {" \
    "_CCCL_BEGIN_NAMESPACE_CUDA_STD_EXECUTION=namespace cuda::std::execution {" \
    "_CCCL_BEGIN_NAMESPACE_CUDA_STD_RANGES=namespace cuda::std::ranges {" \
    "_CCCL_BEGIN_NAMESPACE_CUDA_STD_VIEWS=namespace cuda::std::ranges::views {" \
    "_CCCL_BEGIN_NAMESPACE_STD=namespace std {" \
    "_CCCL_CATCH=catch" \
    "_CCCL_CATCH_ALL=catch (...)" \
    "_CCCL_CATCH_FALLTHROUGH=" \
    "_CCCL_CONCEPT=constexpr bool " \
    "_CCCL_CONSTEXPR_FRIEND=friend " \
    "_CCCL_CTK_AT_LEAST(x, y)=1" \
    "_CCCL_CTK_BELOW(x, y)=0" \
    "_CCCL_CUDACC_AT_LEAST(x, y)=1" \
    "_CCCL_CUDACC_BELOW(x, y)=0" \
    "_CCCL_DEVICE_API=inline" \
    "_CCCL_DIAG_POP=" \
    "_CCCL_DIAG_PUSH=" \
    "_CCCL_DIAG_SUPPRESS_CLANG(x)=" \
    "_CCCL_DIAG_SUPPRESS_GCC(x)=" \
    "_CCCL_DIAG_SUPPRESS_MSVC(x)=" \
    "_CCCL_DIAG_SUPPRESS_NVHPC(x)=" \
    "_CCCL_END_NAMESPACE_ARCH_DEPENDENT="\
    "_CCCL_END_NAMESPACE_CUDA=}" \
    "_CCCL_END_NAMESPACE_CUDA_DEVICE=}" \
    "_CCCL_END_NAMESPACE_CUDA_DEVICE_EXPERIMENTAL=}" \
    "_CCCL_END_NAMESPACE_CUDA_DRIVER=}" \
    "_CCCL_END_NAMESPACE_CUDA_EXECUTION=}" \
    "_CCCL_END_NAMESPACE_CUDA_MR=}" \
    "_CCCL_END_NAMESPACE_CUDA_PTX=}" \
    "_CCCL_END_NAMESPACE_CUDA_STD=}" \
    "_CCCL_END_NAMESPACE_CUDA_STD_EXECUTION=}" \
    "_CCCL_END_NAMESPACE_CUDA_STD_RANGES=}" \
    "_CCCL_END_NAMESPACE_CUDA_STD_VIEWS=}" \
    "_CCCL_END_NAMESPACE_STD=}" \
    "_CCCL_EXEC_CHECK_DISABLE=" \
    "_CCCL_GLOBAL_CONSTANT=inline constexpr" \
    "_CCCL_HAS_CTK()=1" \
    "_CCCL_HIDE_FROM_ABI=" \
    "_CCCL_HOST_API=inline" \
    "_CCCL_PUBLIC_API=inline" \
    "_CCCL_PUBLIC_DEVICE_API=inline" \
    "_CCCL_PUBLIC_HOST_API=inline" \
    "_CCCL_REQUIRES(x)= ::cuda::std::enable_if_t<x, int> = 0>" \
    "_CCCL_STD_VER=2020" \
    "_CCCL_SUPPRESS_DEPRECATED_POP=" \
    "_CCCL_SUPPRESS_DEPRECATED_PUSH=" \
    "_CCCL_TEMPLATE(x)=template<x, " \
    "_CCCL_TRAILING_REQUIRES(x)=-> x requires " \
    "_CCCL_NODEBUG_API=inline" \
    "_CCCL_NODEBUG_DEVICE_API=inline" \
    "_CCCL_NODEBUG_HOST_API=inline" \
    "_CCCL_TRY=try" \
    "_CCCL_TYPE_VISIBILITY_DEFAULT=" \
    "_CCCL_TYPE_VISIBILITY_HIDDEN=" \
    "_CCCL_VISIBILITY_DEFAULT=" \
    "_CCCL_VISIBILITY_HIDDEN=" \
    "_CCCL_LIFETIMEBOUND=" \
    "_CUDAX_CONSTEXPR_FRIEND=friend" \
    "_LIBCUDACXX_HAS_SPACESHIP_OPERATOR()=0" \
    "CCCL_DEPRECATED=" \
    "CCCL_DEPRECATED_BECAUSE(x)=" \
    "CCCL_IGNORE_DEPRECATED_CPP_DIALECT" \
    "CUB_DISABLE_NAMESPACE_MAGIC" \
    "CUB_IGNORE_NAMESPACE_MAGIC_ERROR" \
    "CUB_NAMESPACE_BEGIN=namespace cub {" \
    "CUB_NAMESPACE_END=}" \
    "CUB_RUNTIME_FUNCTION=" \
    "THRUST_FWD(x)=x" \
    "THRUST_NAMESPACE_BEGIN=namespace thrust {" \
    "THRUST_NAMESPACE_END=}" \
    "THRUST_PREVENT_MACRO_SUBSTITUTION" \
    "_CCCL_HOSTED()=1"

# IMPORTANT: Aliases for custom commands
# The rst alias enables embedding reStructuredText in doxygen comments
# Using the same format as repo_docs for compatibility
ALIASES = "rst=\verbatim embed:rst:leading-asterisk"
ALIASES += "endrst=\endverbatim"
ALIASES += "rststar=\verbatim embed:rst:leading-asterisk"
ALIASES += "inlinerst=\verbatim embed:rst:inline"

# Quiet mode
QUIET                  = YES
WARNINGS               = YES
WARN_AS_ERROR          = FAIL_ON_WARNINGS
WARN_IF_UNDOCUMENTED   = NO
WARN_IF_DOC_ERROR      = YES
WARN_IF_INCOMPLETE_DOC = NO
WARN_NO_PARAMDOC       = NO