Few more tweaks.

Author: Diptorup Deb

docs/Doxyfile.in

@@ -917,7 +917,11 @@ RECURSIVE              = YES
 # Note that relative paths are relative to the directory from which doxygen is
 # run.
 
-EXCLUDE                =
+EXCLUDE                = ../dpctl-capi/include/Support
+EXCLUDE               += ../dpctl-capi/include/Config
+EXCLUDE               += ../dpctl-capi/include/dpctl_vector.h
+EXCLUDE               += ../dpctl-capi/include/dpctl_data_types.h
+EXCLUDE               += ../dpctl-capi/include/dpctl_utils.h
 
 # The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
 # directories that are symbolic links (a Unix file system feature) are excluded
@@ -933,7 +937,7 @@ EXCLUDE_SYMLINKS       = NO
 # Note that the wildcards are matched against the file with absolute path, so to
 # exclude all test directories for example use the pattern */test/*
 
-EXCLUDE_PATTERNS       =
+EXCLUDE_PATTERNS       = 
 
 # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
 # (namespaces, classes, functions, etc.) that should be excluded from the

docs/doxyrest-config.lua.in

@@ -257,14 +257,14 @@ PROTECTION_FILTER = "public"
 --! setting to ``false``.
 --!
 
-EXCLUDE_EMPTY_DEFINES = false
+EXCLUDE_EMPTY_DEFINES = true
 
 --!
 --! If non-``nil``, each define will be checked using this regular expression
 --! and if its name matches, this define will be excluded from the documentation.
 --!
 
-EXCLUDE_DEFINE_PATTERN = nil
+EXCLUDE_DEFINE_PATTERN = "DPCTL_API"
 
 --!
 --! Usually providing documentation blocks for default constructors is

dpctl-capi/include/Support/MemOwnershipAttrs.h

@@ -28,14 +28,6 @@
 
 #pragma once
 
-/**
- * @defgroup PtrOwnershipAttr Memory management attributes.
- * This file defines a group of macros that serve as attributes indicating the
- * type of ownership of a pointer. The macros are modeled after similar
- * attributes defined in Integer Set Library (isl) and serve the purpose of
- * helping a programmer understand the semantics of a dpctl function.
- */
-
 /**
  * @def __dpctl_give
  * @brief The __dpctl_give attribute indicates that a new object is returned and
@@ -46,7 +38,6 @@
  * free the object, he/she should make sure to use it exactly once as a value
  * for a __dpctl_take argument. However, the user is free to use the object as
  * he/she likes as a value to __dpctl_keep arguments.
- * @ingroup PtrOwnershipAttr
  */
 #ifndef __dpctl_give
 #define __dpctl_give
@@ -62,7 +53,6 @@
  * function. If the pointer annotated with __dpctl_take is NULL then it is
  * treated as an error, since it may prevent the normal behavior of the
  * function.
- * @ingroup PtrOwnershipAttr
  */
 #ifndef __dpctl_take
 #define __dpctl_take
@@ -72,14 +62,12 @@
  * @def __dpctl_keep
  * @brief The __dpctl_keep attribute indicates that the function only uses the
  * object and does not destroy it before returning.
- * @ingroup PtrOwnershipAttr
  */
 #define __dpctl_keep
 #endif
 /*!
  * @def __dpctl_null
  * @brief The __dpctl_null attribute indicates that a NULL value is returned.
- * @ingroup PtrOwnershipAttr
  */
 #ifndef __dpctl_null
 #define __dpctl_null

dpctl-capi/include/dpctl_sycl_device_selector_interface.h

@@ -50,6 +50,7 @@ __dpctl_give DPCTLSyclDeviceSelectorRef DPCTLAcceleratorSelector_Create();
  * @brief Returns an opaque wrapper for sycl::default_selector object.
  *
  * @return An opaque pointer to a sycl::default_selector object.
+ * @ingroup DeviceSelectors
  */
 DPCTL_API
 __dpctl_give DPCTLSyclDeviceSelectorRef DPCTLDefaultSelector_Create();

dpctl-capi/include/dpctl_sycl_types.h

@@ -74,14 +74,12 @@ typedef struct DPCTLOpaqueSyclProgram *DPCTLSyclProgramRef;
 /*!
  * @brief Opaque pointer to a sycl::queue
  *
- * @see sycl::queue
  */
 typedef struct DPCTLOpaqueSyclQueue *DPCTLSyclQueueRef;
 
 /*!
  * @brief Used to pass a sycl::usm memory opaquely through DPCTL interfaces.
  *
- * @see sycl::usm
  */
 typedef struct DPCTLOpaqueSyclUSM *DPCTLSyclUSMRef;