¿Hay algunas convenciones para escribir comentarios POD para Perl?
Pregunta
yo era capaz de encontrar una página de Safari Books Online que ofrece una plantilla , pero Nunca tiene comentarios escritos POD, no estoy seguro de lo bueno que es o si no se encuentra nada que pueda ser considerado Convención que incluya.
¿Cuáles son las convenciones a seguir al escribir los comentarios POD para scripts de Perl? ¿Hay algo como convenios Javadoc de Sun , pero por los comentarios POD?
Solución
No es elaborar, pero me gusta introducción perlpodtut de Juerd mucho.
El autor menciona lo que él considera secciones comunes y lo que incluiría.
Otros consejos
Hay una serie de recomendaciones en Perl Best Practices . Todo el capítulo 7 cubre la documentación, con el POD, y los mejores enfoques para la documentación de los módulos, grandes proyectos, etc. También habla de convenciones CPAN. Eso es probablemente su mejor apuesta.
Perl :: crítico ofrece las siguientes políticas:
-
Perl :: :: Crítica Política :: Documentación :: RequirePackageMatchesPodName
-
Perl :: :: Crítica Política :: Documentación :: RequirePodAtEnd
-
Perl :: :: Crítica Política :: Documentación :: RequirePodSections
una lista de secciones requeridas es proporcionada por la última política anterior.
módulo de arranque :: :: PBP generará el código estándar para ti.
Usted puede mirar en el Pod para los módulos de Perl en CPAN Buscar y rápidamente en cuenta las cosas que todo el mundo hace . Los diferentes módulos a partir herramientas hacen repetitivo para usted.
Eso es lo más cercano que obtendrá con las directrices.