# \#apinotes

**URL:** https://forums.swift.org/tag/apinotes/36.md

[Latest](https://forums.swift.org/latest.md) · [Categories](https://forums.swift.org/categories.md) · [Tags](https://forums.swift.org/tags.md)

---

## [Apinotes and C++ overloads](https://forums.swift.org/t/apinotes-and-c-overloads/86316)

<div class="topic-metadata">

**Author:** [@Geordie\_J](https://forums.swift.org/u/Geordie_J)\
**Replies:** 2\
**Last updated:** [April 30, 2026, 5:33pm UTC](https://forums.swift.org/t/apinotes-and-c-overloads/86316 "2026-04-30T17:33:55Z")

</div>

Hi there, I'm trying to annotate a 3rd party API with apinotes. I'm having trouble differentiating (in the apinotes file) between e.g. void fill(uint8\_t r, uint8\_t g, uint8\_t b, uint8\_t a = 255); (setter) and fill(uint8…

---

## [Apinotes are ignored for a C module with Zephyr RTOS](https://forums.swift.org/t/apinotes-are-ignored-for-a-c-module-with-zephyr-rtos/84399)

<div class="topic-metadata">

**Author:** [@hbaker](https://forums.swift.org/u/hbaker)\
**Replies:** 3\
**Last updated:** [January 29, 2026, 5:25pm UTC](https://forums.swift.org/t/apinotes-are-ignored-for-a-c-module-with-zephyr-rtos/84399 "2026-01-29T17:25:44Z")

</div>

I’ve been working on a project using Embedded Swift in Zephyr and I built a thin wrapper around some of its C APIs. I wanted to use apinotes to import some of the enums nicely into Swift, but I can’t get the apinotes fil…

---

## [Various questions about apinotes](https://forums.swift.org/t/various-questions-about-apinotes/83942)

<div class="topic-metadata">

**Author:** [@Lancelotbronner](https://forums.swift.org/u/Lancelotbronner)\
**Replies:** 3\
**Last updated:** [January 4, 2026, 6:22pm UTC](https://forums.swift.org/t/various-questions-about-apinotes/83942 "2026-01-04T18:22:14Z")

</div>

A common pattern in C libraries are typedef-ed pointers, such as typedef void\* CXIndex. Is there any way to import this as a wrapper struct in Swift? Here's what I tried so far: Typedefs: - Name: CXIndex SwiftName: In…

---

## [Adding API Notes](https://forums.swift.org/t/adding-api-notes/82914)

<div class="topic-metadata">

**Author:** [@timsneath](https://forums.swift.org/u/timsneath)\
**Replies:** 3\
**Last updated:** [October 29, 2025, 8:56pm UTC](https://forums.swift.org/t/adding-api-notes/82914 "2025-10-29T20:56:04Z")

</div>

I’m experimenting with improving the default WinSDK projection, but I’m having a hard time getting API notes recognized by the compiler. I’ve created a proof-of-concept file that disables a couple of things, just to tes…

---

## [Apinotes with SPM?](https://forums.swift.org/t/apinotes-with-spm/76098)

<div class="topic-metadata">

**Author:** [@idrougge](https://forums.swift.org/u/idrougge)\
**Replies:** 2\
**Last updated:** [November 18, 2024, 5:53pm UTC](https://forums.swift.org/t/apinotes-with-spm/76098 "2024-11-18T17:53:59Z")

</div>

I'm trying to use a C library (libexif) in an SPM package, but as with any C library, it needs some refinement for Swift use. However, I can't seem to get Xcode to pick up my apinotes file. Package structure: +- Packag…

---

## [Using API Notes to Annotate Win32 Header Files](https://forums.swift.org/t/using-api-notes-to-annotate-win32-header-files/70964)

<div class="topic-metadata">

**Author:** [@timsneath](https://forums.swift.org/u/timsneath)\
**Replies:** 5\
**Last updated:** [March 29, 2024, 1:15am UTC](https://forums.swift.org/t/using-api-notes-to-annotate-win32-header-files/70964 "2024-03-29T01:15:04Z")

</div>

As a matter of personal interest, I was writing some Win32 code with Swift. The core header support is excellent, thanks I believe to @compnerd and his patient work. But I'd like to work at tweaking some of the annotati…

---

## [Help with Apinotes](https://forums.swift.org/t/help-with-apinotes/12954)

<div class="topic-metadata">

**Author:** [@Anders\_Hasselqvist](https://forums.swift.org/u/Anders_Hasselqvist)\
**Replies:** 2\
**Last updated:** [May 26, 2018, 4:29am UTC](https://forums.swift.org/t/help-with-apinotes/12954 "2018-05-26T04:29:03Z")

</div>

Hi, I'm using a 3rd party C/Objective-C library that does not have any header annotations. I was hoping to improve the API by adding an apinotes file. For example, I was hoping that the importer could import this enum…

---

## [Apinotes name spacing](https://forums.swift.org/t/apinotes-name-spacing/10502)

<div class="topic-metadata">

**Author:** [@tonyarnold](https://forums.swift.org/u/tonyarnold)\
**Replies:** 3\
**Last updated:** [March 3, 2018, 1:27am UTC](https://forums.swift.org/t/apinotes-name-spacing/10502 "2018-03-03T01:27:13Z")

</div>

I hope it's not out of line to ask about the .apinotes file - I've been using one to annotate an Objective-C framework that I don't control the headers for. I've noticed that if I rename a class, like so: --- Name: MyF…
