On 11/7/06, Diego Gomez Deck <[EMAIL PROTECTED]> wrote:

> Bueno, antes de decidir si se comentan o no los métodos tendríamos que
> diferenciar muy bien método de mensaje.

Creia tenerlo claro, pero segun lo entiendo el método es la
implementación del comportamiento, y el mensaje es quien activa dicho
comportamiento.

> ¿Qué es lo que se comenta, el método o el mensaje?

En Smalltalk sólo hay lugar para comentar el método, el mensaje sólo
se podría documentar en el emisor (que es quien lo instancia/envia).

> ¿Si hay varios métodos que implementan el mismo mensaje, la
> documentación del mensaje no estaría duplicada?

El mensaje se implementa? o es el método? El mensaje se envia, y en
todo caso se instancia manualmente. Al menos asi lo entiendo yo (sic
sic, diría Nimo ;-) )

> En CLOS uno define por un lado el mensaje, y por otro los métodos que
> implementan ese mensaje.  En Smalltalk, en cambio, uno no define nunca
> (al menos como yo lo entiendo) los mensajes, sino que uno implementa
> métodos.
>
> ¿So? ¿Comentamos métodos o mensajes? Si se comenta el mensaje, ¿Cómo se
> administra la duplicación?.

Métodos.

> Según lo veo yo: Uno NO tendría que documentar métodos (es decir:
> detalles de implementación) sino que debería escribir el código limpio,
> que se entienda SIN necesidad de comentarios (hay muchos trucos para
> eso, y muchos están en el libro de Kent Beck al que hacen referencia).

Para mi, por el contrario, no deberíamos leer código, deberiamos poder
confiar en la intención del selector, luego en el comentario y por
ultimo (si está mal comentado) en la implementación en el lenguaje.


> Pero, si documentamos la intención del mensaje, tenemos que administrar
> la duplicación.

Y donde comentás un mensaje?

Uno comenta el método, para _NO_ tener que leer su implementación, por
sencilla que sea. En muchos casos el selector revela la intención,
pero en otros viene bien que el comentario diga que devuelve tal cosa
y hace tal otra.
Si el metodo está factorizado, siendo que el mensaje siempre impacta
en un método principal, hay que comentar el todo y sus partes, pues
cada parte hará algo diferente, y por ello está factorizado.

Saludos.




-- 
Esteban A. Maringolo
[EMAIL PROTECTED]

--~--~---------~--~----~------------~-------~--~----~
  Ha recibido este mensaje porque está suscrito a Grupo "clubSmalltalk" de 
Grupos de Google.
 Si quieres publicar en este grupo, envía un mensaje de correo 
electrónico a [email protected]
 Para anular la suscripción a este grupo, envíe un mensaje a [EMAIL PROTECTED]
 Para obtener más opciones, visita este grupo en 
http://groups-beta.google.com/group/clubSmalltalk?hl=es.

-~----------~----~----~----~------~----~------~--~---

Responder a