Aquí hay un ejemplo de todas las opciones que he encontrado a partir de Xcode 5.0.2

Que se generó con este código:

/** First line text.

 Putting \\n doesn't create a new line.\n One way to create a newline is by making sure nothing is on that line. Not even a single space character!

 @a Italic text @em with @@a or @@em.

 @b Bold text with @@b.

 @p Typewritter font @c with @@p or @@c.

 Backslashes and must be escaped: C:\\foo.

 And so do @@ signs: user@@example.com

 Some more text.
 @brief brief text
 @attention attention text
 @author author text
 @bug bug text
 @copyright copyright text
 @date date text
 @invariant invariant text
 @note note text
 @post post text
 @pre pre text
 @remarks remarks text
 @sa sa text
 @see see text
 @since since text
 @todo todo text
 @version version text
 @warning warning text

 @result result text
 @return return text
 @returns returns text


 @code
// code text
while (someCondition) {
    NSLog(@"Hello");
    doSomething();
}@endcode
 Last line text.

 @param param param text
 @tparam tparam tparam text
 */
- (void)myMethod {}

Notas:

• Los comandos deben estar en un /** block */, /*! block */, o con el prefijo /// o //!.
• Los comandos funcionan con el @ (headerdoc style) o el \ (prefijo doxygen style). (Es decir, @b y \b ambos hacen lo mismo.)
• Los comandos generalmente vienen antes de la artículo que están describiendo. (Es decir, si está tratando de documentar una propiedad, el comentario debe venir antes del texto @property.) Que puede venir después, en la misma línea, con /*!<, /**<, //!<, ///<.
• puede agregar documentación a clases, funciones, propiedades, y variables.
• Todas estas órdenes aparecen en un texto verde oscuro para indicar que son órdenes válidas, excepto @returns.
• Es posible que necesite construir su proyecto (o reiniciar Xcode) antes de que aparezcan los últimos cambios en su documentación.

Dónde ver la documentación:

1. Durante el código completo, verá el breve texto:

Esto mostrará el texto breve (sin formato); si no existe ningún texto breve, mostrará una concatenación de todo el texto hasta el primer bloque@; si no existe ninguno (por ejemplo, comienza con @return), entonces concatará todo el texto separando todos los comandos@.

2. Opción-hacer clic en un nombre identificador:

3. En el panel Inspector de Ayuda rápida

(Ver primera captura de pantalla.)

4. In Doxygen

Dado que los comandos en Xcode 5 son compatibles con Doxygen, puede descargar y usar Doxygen para generar archivos de documentación.

Otras notas

Para una introducción general a Doxygen y cómo documentar el código Objective-C, esta página parece un buen recurso.

Descripciones de algunos de los comandos soportados:

• @brief: insertará texto al principio del campo de descripción, y es el único texto que aparecerá durante la finalización del código.

Lo siguiente no funciona:

• \n: no genera una nueva línea. Una forma de crear una nueva línea es asegurarse de que no hay nada en esa línea. ¡Ni un solo personaje espacial!
• \example

Los siguientes no son compatibles (ni siquiera aparecen en la oscuridad verde):

• \cite
• \docbookonly
• \enddocbookonly
• \endinternal
• \endrtfonly
• \endsecreflist
• \idlexcept
• \ mscfile
• \ refitem
• \relatedalso
• \ rtsólo
• \secreflist
• \short
• \ snippet
• \ tabla de contenidos
• \ vhdlflow
• \~
• \"
• .
• ::
• \|

Manzana reservada palabras clave:

Apple utiliza lo que parecen ser palabras clave reservadas que solo funcionan en su documentación. Aunque aparecen en verde oscuro, parece que no podemos usarlos como lo hace Apple. Puedes ver ejemplos del uso de Apple en archivos como AVCaptureOutput.h.

Aquí hay una lista de algunas de esas palabras clave:

• @abstract, @availibility, @class, @discussion, @deprecated, @method, @property, @protocol, @related, @ref.

En el mejor de los casos, la palabra clave causa una nueva línea en el campo Descripción (por ejemplo, @ discusión). En el peor de los casos, la palabra clave y cualquier texto que la siga no aparecerán en la ayuda rápida (por ejemplo, @class).