#742 closed defect (fixed)
Description of class members
| Reported by: | Owned by: | Víctor de Buen Remiro | |
|---|---|---|---|
| Priority: | normal | Milestone: | OOP Implementation |
| Component: | OOP | Version: | |
| Severity: | normal | Keywords: | |
| Cc: |
Description
¿Qué hacer con la descripción de los miembros (atributos y métodos) de una clase?
En la discusión del ticket 722 surge esta duda, pero no queda resuelta:
¿Qué hacer con los atributos que no deben copiarse en todas las instancias? El ejemplo más claro son las variables _.autodoc.member.XXX. ¿Existe o existiría la posibilidad de poner "descripción" con el PutDescription? ...
No sé si lo más conveniente sería que los atributos _.autodoc.member se traten de manera especial o recurrir a llamadas PutDescription.
Es este último caso, para los métodos de la clase sería bastante adecuado porque no se replican en cada instancia, pero para los atributos quizá no tanto, no sé si la descripción aumentaría el peso en memoria de la instancia.
Attachments (1)
Change History (6)
comment:1 Changed 15 years ago by
| Status: | new → accepted |
|---|
comment:2 Changed 15 years ago by
| Resolution: | → fixed |
|---|---|
| Status: | accepted → closed |
comment:3 Changed 15 years ago by
| Priority: | high → normal |
|---|---|
| Resolution: | fixed |
| Severity: | critical → normal |
| Status: | closed → reopened |
| Type: | doubt → defect |
La asignación de descripciones con los "atributos" _.autodoc.member
no funciona sobre miembros estáticos (como los constructores) ni sobre los atributos.
Tampoco funciona si la descripción es posterior a la creación de un método.
Si se crea la descripción de un miembro que no existe no se emite ningún mensaje de error o de advertencia.
Véase el archivo adjunto.
Changed 15 years ago by
| Attachment: | ticket_12.MemberDescriptions.tol added |
|---|
comment:4 Changed 15 years ago by
| Resolution: | → fixed |
|---|---|
| Status: | reopened → closed |
Efectivamente este problema ya está siendo tratado precisamente a partir de lo comentado en el ticket #722.
La idea es que los _.autodoc.member de instancias sean tratados automáticamente como estáticos sin necesidad de explicitar el Static por delante.
Aunque el valor de los atributos sea modificable en cada instancia no creo que tenga sentido que en cada instancia tengan un objetivo distinto, la finalidad del atributo será siemrpe la misma y por tanto su descripción debería ser común, igual que para los métodos.
En breve estará resuelto en el trunk