Comentarios XML de estilo C# en Delphi 2010

Question

¿Delphi 2010 tiene comentarios XML estilo C# que aparecen al pasar el ratón sobre la llamada al método?

/// <summary> 
/// My comment here 
/// </summary> 

Answer 1

Acabo de probarlo en D2007 y funciona. Puse tu comentario de prueba arriba de una declaración de método (dentro de la declaración de clase) y reconstruí. Cuando pase el mouse sobre una llamada a ese método, verá "Mi comentario aquí" dentro de la información sobre herramientas.

Debe tener esa cosa de evaluación HTML habilitada para que esto funcione. Consulte Opciones -> Opciones del editor -> Información del código -> Descripción del símbolo (traducido de un IDE alemán).

Answer 2

Funciona: en Delphi 2007 y 2009 hay problemas: debe tener un tipo de letra antes de cada clase, o solo selecciona el primer conjunto de documentación (no sé por qué), y si hace clic en la opción 'Generar documentación XML', parece perderse al compilar muchas unidades y se rinde - Espero que esto esté solucionado en Delphi 2010.

Habiendo dicho que la documentación en línea es mejor que ninguna documentación en absoluto!

This link para Embarcadero es lo único que puedo encontrar, aunque creo que hay utilidades en las versiones de Delphi para producir documentación externa.

Answer 3

No hay mucha documentación disponible para esto, aunque hay un pequeño article en Delphi Wiki. Marco Cantu también tiene un par de publicaciones breves en el blog here y here.