File: doxygen-refs.patch

package info (click to toggle)
hipfft 6.4.3-2
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 2,256 kB
  • sloc: cpp: 27,648; python: 170; makefile: 48; xml: 15; sh: 12
file content (80 lines) | stat: -rw-r--r-- 4,356 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
From: Kari Pahula <kaol@debian.org>
Date: Fri, 28 Jun 2024 16:07:05 +0300
Subject: doxygen-refs

Summary: Use typedef names instead of struct names in references

Since Doxygen is using TYPEDEF_HIDES_STRUCTS = YES references should
be using the typedef names instead of struct names for references.
Doxygen fails with an error on these otherwise.

Marked as Forwarded: non-needed since upstream solved the issue by
introducing the struct names to Doxygen with a @struct instead of
using typedef names.  It's not correct IMHO but I don't think it's
worth making a PR over it.  Most likely the next release will have a
fix in some form anyway and this patch will be dropped.
Forwarded: not-needed
---
 library/include/hipfft/hipfftXt.h | 18 +++++++++---------
 library/include/hipfft/hiplibxt.h |  2 +-
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/library/include/hipfft/hipfftXt.h b/library/include/hipfft/hipfftXt.h
index 41dc671..ebcf0e0 100644
--- a/library/include/hipfft/hipfftXt.h
+++ b/library/include/hipfft/hipfftXt.h
@@ -279,7 +279,7 @@ typedef enum hipfftXtSubFormat_t
 /*! @brief Allocate memory on multiple devices.
  *
  *  Allocate memory on multiple devices for the specified plan.
- *  Returns a \ref hipLibXtDesc_t descriptor which includes pointers
+ *  Returns a \ref hipLibXtDesc descriptor which includes pointers
  *  to the allocated memory, devices that memory resides on, and
  *  sizes allocated.
  *
@@ -298,13 +298,13 @@ HIPFFT_EXPORT hipfftResult hipfftXtMalloc(hipfftHandle      plan,
                                           hipLibXtDesc**    desc,
                                           hipfftXtSubFormat format);
 
-/*! @brief Copy data to/from \ref hipLibXtDesc_t descriptors.
+/*! @brief Copy data to/from \ref hipLibXtDesc descriptors.
  *
- *  Copy data according to the hipfftXtCopyType_t
+ *  Copy data according to the hipfftXtCopyType
  *
- *  - ::HIPFFT_COPY_HOST_TO_DEVICE: dest points to a \ref hipLibXtDesc_t structure that describes multi-device memory layout.  src points to a host memory buffer.
- *  - ::HIPFFT_COPY_DEVICE_TO_HOST: src points to a \ref hipLibXtDesc_t structure that describes multi-device memory layout.  dest points to a host memory buffer.
- *  - ::HIPFFT_COPY_DEVICE_TO_DEVICE: Both dest and src point to a \ref hipLibXtDesc_t structure that describes multi-device memory layout.  The two structures must describe memory with the same number of devices and memory sizes.
+ *  - ::HIPFFT_COPY_HOST_TO_DEVICE: dest points to a \ref hipLibXtDesc structure that describes multi-device memory layout.  src points to a host memory buffer.
+ *  - ::HIPFFT_COPY_DEVICE_TO_HOST: src points to a \ref hipLibXtDesc structure that describes multi-device memory layout.  dest points to a host memory buffer.
+ *  - ::HIPFFT_COPY_DEVICE_TO_DEVICE: Both dest and src point to a \ref hipLibXtDesc structure that describes multi-device memory layout.  The two structures must describe memory with the same number of devices and memory sizes.
  * 
  * @param[in] plan Plan which has the descriptor.
  * @param[out] dest Buffer that will be populated.
@@ -326,10 +326,10 @@ HIPFFT_EXPORT hipfftResult hipfftXtMemcpy(hipfftHandle     plan,
  */
 HIPFFT_EXPORT hipfftResult hipfftXtFree(hipLibXtDesc* desc);
 
-/** @defgroup hipfftXtExecDescriptor Execute FFTs using \ref hipLibXtDesc_t descriptors.
+/** @defgroup hipfftXtExecDescriptor Execute FFTs using \ref hipLibXtDesc descriptors.
  *
- *  Execute FFTs using \ref hipLibXtDesc_t descriptors.  Inputs and
- *  outputs are pointers to \ref hipLibXtDesc_t descriptors.
+ *  Execute FFTs using \ref hipLibXtDesc descriptors.  Inputs and
+ *  outputs are pointers to \ref hipLibXtDesc descriptors.
  *  In-place transforms are performed by passing the same pointer for
  *  input and output.
  * 
diff --git a/library/include/hipfft/hiplibxt.h b/library/include/hipfft/hiplibxt.h
index 8014b99..38f3192 100644
--- a/library/include/hipfft/hiplibxt.h
+++ b/library/include/hipfft/hiplibxt.h
@@ -58,7 +58,7 @@ typedef enum hiplibFormat_t
 /*! @struct hipLibXtDesc_t
  * @brief Struct for single-process multi-GPU transform
  *
- * This struct holds \ref hipXtDesc_t structures that define blocks
+ * This struct holds \ref hipXtDesc structures that define blocks
  * of memory for use in a transform.
  *
  * @warning Experimental