¿Cómo decorar los métodos de Objective C con documentación?
Cuando estoy escribiendo un objeto Cocoa y llamando a un selector en ese objeto, a veces puedo ver información de "documentación" o "ayuda" sobre ese método. Por ejemplo, como escribo[NSArray alloc]
, Veo dos consejos de ayuda. Uno paraNSArray
, y uno paraalloc
. Ambos aparecen en el cuadro de lista de sugerencias de autocompletado emergente a medida que escribo el código.
¿Cómo produzco sugerencias de ayuda de método / clase decoradas que aparecerán cuando escribo? Quiero ver mis comentarios a medida que escribo mi nombre de clase personalizado y mis métodos personalizados. ¿Cómo puedo hacer esto?
Por ejemplo, C # proporciona esta característica a través de la documentación XML que se puede colocar antes de cualquier método, clase o declaración de interfaz / protocolo.