Credo Apple sta ancora cambiando la sintassi. Sembra che tutte le parole chiave @ non siano implementate da Xcode 6b2, ma per il resto è uguale a ObjC.
Quindi, qualcosa di simile a quello che hai potrebbe funzionare:
/**
* I am a function.
*/
func randomFn() {}
Anche se sembra che Swift si ferma per allineare i *
s. Naturalmente, non si ha realmente bisogno le stelle, tranne il primo e l'ultimo, in modo da poter fare questo:
/*
I am a function.
*/
func randomFn() {}
Entrambi saranno prelevati dal commento parser in modo che quando si 3 dita clic sul nome della funzione vedrai il suo documento.
@param, @return ha funzionato per la beta1 ma non per la beta2 e tali parole chiave bloccano molto il parser in beta1, suggerendo che Apple non ha ancora completato l'implementazione.
Vedi http://nshipster.com/swift-documentation/ – Rob
Eventuali duplicati di [ Swift ha commenti o strumenti di documentazione?] (Http://stackoverflow.com/questions/24047991/does-swift-have-documentation-comments-or-tools) – Kevin