Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
twsg:dicas:code_conventions [2009/01/20 17:44] emerson |
twsg:dicas:code_conventions [2009/03/28 22:00] (current) emerson |
||
|---|---|---|---|
| Line 73: | Line 73: | ||
| */ | */ | ||
| </code> | </code> | ||
| + | |||
| Line 78: | Line 79: | ||
| ==== Header file guard ==== | ==== Header file guard ==== | ||
| - | As convenções do File header guard estão descritas no documento de referência. A pŕincipal alteração é a troca do prefixo ''OGWS'' por ''TERRAOGC'', segundo exemplo abaixo: | + | As convenções do File header guard estão descritas no documento de referência. A principal alteração é a troca do prefixo ''OGWS'' por ''TERRAOGC'', segundo exemplo abaixo: |
| <code cpp> | <code cpp> | ||
| #ifndef __TERRAOGC_COMMON_INTERNAL_TECGIUTILS_H | #ifndef __TERRAOGC_COMMON_INTERNAL_TECGIUTILS_H | ||
| Line 156: | Line 157: | ||
| - | ===== Dicas Doxygen ===== | ||
| - | |||
| - | Documentar bem o código é essencial para o sucesso do projeto. Uma boa referência para os comandos Doxygen pode ser encontrada no [[http://www.stack.nl/~dimitri/doxygen/commands.html|link]]. | ||
| - | Veja algumas dicas: | ||
| - | - Para obter o efeito de **negrito**, você pode usar o comando ''\b'' antes da palavra que deseja destacar. Para mais de uma palavra use como em HTML. Exemplos: | ||
| - | * \b must => **must** | ||
| - | * <b>must use</b> => **must use** | ||
| - | - Para destacar uma palavra em //itálico// use o comando ''\a''. Para múltiplas palavras coloque entre as tags <i> e </i>. Exemplos: | ||
| - | * \a loadInstances => //loadInstances// | ||
| - | * <i>loadInstances method</i> => //loadInstances method// | ||
| - | - Para um efeito de fonte ''monospace'', use o comando ''\c''. Para múltiplas palavras use as tags <tt></tt>. Exemplos: | ||
| - | * \c sessionId => ''sessionID'' | ||
| - | * <tt>sessionId parameter</tt> => ''sessionID parameter'' | ||
| - | - Para usar uma lista sem numeração (como os exemplos acima), preceda cada termo com o comando ''\li''. Exemplo: <code> | ||
| - | \li OracleSpatial | ||
| - | \li PostgreSQL | ||
| - | \li PostGIS </code> fica: | ||
| - | * OracleSpatial | ||
| - | * PostgreSQL | ||
| - | * PostGIS | ||
