C # Estilo comentários XML em Delphi 2010
-
18-09-2019 - |
Pergunta
faz Delphi 2010 têm comentários XML C # Estilo que aparecem quando pairando sobre a chamada de método?
/// <summary>
/// My comment here
/// </summary>
Solução
Eu apenas tentei em D2007 e ele funciona. Eu coloquei o seu comentário teste acima uma declaração de método (dentro da declaração de classe) e reconstruído. Quando você agora pairar sobre uma chamada para esse método, você verá "Meu comentário aqui" dentro da dica.
Você deve ter que HTML thingie avaliação habilitado para que isso funcione. Consulte Opções -> opções do Editor -> Code Insight -.> Descrição dos símbolos (traduzido do fron um IDE alemão)
Outras dicas
Ele faz o trabalho - em Delphi 2007 e 2009 existem problemas com ele - você tem que ter um tipo keywork antes de cada classe, ou ele só escolhe o primeiro conjunto de documentação (nenhuma idéia porque), e se você clicar no 'Construir documentação XML' opção, parece se perder quando compilar muitas unidades e desiste - espero que este é fixado no Delphi 2010.
Dito isto em linha documentação é melhor do que nenhuma documentação em tudo!
Este link para Embarcadero é a única coisa que eu possa encontrar, embora eu acho existem utilitários no Architect e versões Enterprise do Delphi para produzir documentação externa.