DocC for something else than Swift.

Developer Tools & Services Xcode
kiwi66 OP
Created
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?

Answered by Vision Pro Engineer in 715800022

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)

Replies  2
Boosts 0
Views  1.2k
Participants  3
DTS Engineer OP
Apple

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"

Vision Pro Engineer OP
Apple
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)