Komentowanie kodu

Dyskusje
1

Witajcie,

Czy ruby ma jakiś standard komentowania kodu, taki jak jest np. w javie lub php?

[code]/**

  • Przypisz nowe haslo

  • @param string $password nowe haslo

  • @return User
    */
    public function setPassword($password) {
    $this->password = md5($password);

    return $this;
    }[/code]

2

Oczywiście, że tak: nazywa się rdoc. Co ciekawe nie mogę znaleźć sensownego tutoriala do tego. W Pickaxe jest dosyć dobrze opisany. Polecam także zaglądnąć do źródeł stdlib Rubiego i spojrzeć na przykładowe komentarze.

3

W ksiazce " Programowanie w języku Ruby" (http://helion.pl/ksiazki/prruby.htm) jest caly rozdzial o rdoc.
Jest tez o dodawaniu rdoc do rozszerzeń w C.