Zdrojové kódy mohou být studnicí znalostí předávaných z jedné generace programátorů na další. Častěji však jde o pouze o nevyčerpatelné studnice WTF momentů. O jednom typu komentářů jsem už psal, ale protože můj předchůdce byl po všech stránkách kreativní tak se můžu dělit o další perly dál.

Tak například komentář uprostřed definice funkce:

1

  procedure foo(parametr: string {20. 1. 1998});

Správně: datum přidání, či snad změny, parametru, navíc uprostřed definice je vždy fajn a budoucím generacím pak přinese spoustu užitku. Podobnou kreaci lze pak vykouzlit v pokročilých obměnách, kdy je těch parametrů třeba 10 a každý druhý obsahuje jiné datum.

Druhý oblíbený typ komentáře využijete pokud chcete šetřit klávesnici:

1
2
3
4
5

  procedure foo;
  var
    p{arametr}, pa{rametr2}, d{an}, s{uma}: double;
  begin
    ...

Hned po definici pak následovalo asi 800 řádků kódu, který zhusta prováděl různé, nepříliš průhledné, výpočty s těmito proměnými.