Franny's Adobe

Il blog di Francesco Carucci
posts - 99, comments - 948, trackbacks - 6705

No Comment

I commenti nel codice e' senza dubbio uno dei miei argomenti preferiti: io sono per la zero policy. Nessun commento, a parte cio' che non puo' in alcun modo essere espresso in codice.

Oggi guardavo un po' di codice e mi imbatto in:

#ifndef

_XXXX_MANAGER_HPP_
#define _XXXX_MANAGER_HPP_ /// Include guard.

A parte l'underscore di fronte ad un identificatore che in C++ e' riservato al compilatore e al comitato di standardizzazione, quindi non deve mai essere usato: il commento e' quanto meno illuminante.

Il prossimo entra dritto nella top 10:

# define

IGNORE_MISSING_DX_FILE // ignore missing file

Il commento dice meno di cio' che cerca di commentare.

Come nota a margine, nel progetto c'e' un Null Object Pattern implementato da manuale, mai usato. Sembra li' per dire "Guardate, ho letto Design Patterns". Ma non hai letto "Refactoring to Patterns".

Cui prodest?

Sto seriamente valutando l'ipotesi di creare una AntiComment Police con licenza di uccidere.

Print | posted on martedì 16 ottobre 2007 18:22 | Filed Under [ Programming ]

Powered by:
Powered By Subtext Powered By ASP.NET