decidí escribir un correo electrónico a los encargados del mantenimiento de ruby-doc.org y le preguntó ellos sobre la documentación faltante de estos métodos. Recibí la siguiente respuesta:
Son métodos privados, y de forma predeterminada no aparecen en la salida de rdoc.
Ésta es una situación desafortunada, ya que a diferencia de la mayoría de los métodos privados (cuyo uso debe evitarse, ya que por lo general son de aplicación detalles, no parte de una API pública) attr_ * y tales son realmente la intención para uso general.
No estoy seguro de cuál es la solución correcta aquí.
James
En un segundo mail:
He hablado de ello con Greg Brown, Eric Hodel, y algunos otros que han estado trabajando para mejorar las rdocs de 1,9.
El consenso general es que muestra todos los métodos privados sería una mala idea en que sería (tal vez sin darse cuenta) animar a la gente a métodos de uso de que son susceptibles de cambiar de una versión menor a la siguiente. Pero apreciaron que los métodos privados como attr_ * son, mientras que son técnicamente privados, se utilizan en una especie de forma pública y que los documentos deben aparecer de forma predeterminada.
Intenté establecer algunas directivas rdoc en el código para éstas en el código fuente C pero no tuvo ningún efecto.Parece que lo que se necesita es de alguna manera adicional para indicar que, de manera conductual, un método es privado, pero para documentos es público.
Tendré que dar seguimiento a esto para ver si el equipo de mejora de doc. ha encontrado algo.
Gracias,
James Britt
Véase también this thread para obtener más información y otra declaración de James respecto a este tema. En este hilo, también dice que la directiva :doc:
generalmente disponible en RDoc para solucionar este problema exacto en el código de Ruby no parece funcionar para la documentación de C-level.
Esta respuesta parece sensata. Quizás lo cambien en el futuro.
Sí, lo he buscado también. Aquí hay un sitio increíble que prefiero sobre la documentación cuando quiero aprender algo: http://www.rubyist.net/~slagell/ruby/accessors.html. Estoy bastante seguro de que no hay documentación en ruby-doc.org porque: http://ruby-doc.org/search.html?cx=011815814100681837392%3Awnccv6st5qk&q=attr_accessor&sa=Search&cof=FORID%3A9 – itdoesntwork