How do I add auto-complete comment in Xcode (Swift)?

Question

How can I add text to autocomplete like below, the "Tells the element to activate itself..." part,

This is what I have,

But the "This is a test" part doesn't show up in autocomplete,

Please do not link to other posts that cover how to write comments so that they would show up in the window that pops up with Option+Click, I'm well-aware of how to do that. My question is specifically around comments showing up in the auto-complete window.

Answer 1

What you are trying to accomplish is unfortunately not possible anymore.

The reason is that the autocomplete popover does not show comments from class files but instead searches in a separate doc-set generated by Apple.

I added a more complete description here: https://stackoverflow.com/a/43982094/1415898

Answer 2

try this, tested on xcode 9.3 - 9.4 beta and swift 4.1

/// this is printName func and will print your name
func printName(name: String){
   print("my name is \(name)")
}

and result :

Answer 3

I have searched a lot and it seems that this feature does not support for self-created functions. all you have is just the popup info window for your functions :(

Answer 4

    /**
     Put comments just above the funcion using the Markdown format like this
    */
    func exampleFunction() {
        print("The comments above will show up in the auto complete popover.")
    }

Popover Example

Full explanation @ Hacking With Swift