DocC for something else than Swift.

Question

Created May ’22

Replies 2

Boosts 0

Views 1.2k

Participants 3

Hello

My projects are all in C and Objective-C and have a 0% chance to ever use Swift (portability is super important for me).

However I love to write code in Xcode and the new DocC feature looks like something you definitively want to support.

Now I set up a test project and it seems to be that DocC does only work in Swift. If you annotate plain-C functions it produces zero output. Not even a workspace documentation entry pops up.

Given Apple has plenty of documentation pointing to Unix C functions and Apple libraries you can call in C, I find it rather strange that this doesn't work.

Is this intentionally or am I missing a few additional things to make it work for C?

Boost

Answer 1

DTS Engineer OP

Apple

May ’22

There’s an ongoing effort to support Objective-C, and hence C, in DocC. See Swift Forums > Development > Swift-DocC > Extending Swift-DocC to support Objective-C documentation.

Given Apple has plenty of documentation pointing to Unix C functions and Apple libraries you can call in C, I find it rather strange that this doesn't work.

Much of Apple’s documentation is based on an older, proprietary documentation system, not DocC.

Share and Enjoy
—
Quinn “The Eskimo!” @ Developer Technical Support @ Apple
let myEmail = "eskimo" + "1" + "@" + "apple.com"

1

Answer 2

Vision Pro Engineer OP

Apple

Jun ’22

Recommended

Hi @kiwi66, I wanted to update this thread to let you know that Swift-DocC in Xcode 14 now supports C/Objective-C.

From the release notes for Xcode 14:

Swift-DocC in Xcode now supports building documentation for Objective-C and C APIs. (58760015)

0