On Sat, 11 Feb 2012, Steven D'Aprano wrote:

Arguably, the canonical test for whether a package is provisional or not should be the existence of __provisional__:


for package in packages:
   if hasattr(package, '__provisional__')
       assert package documentation includes boilerplate
   else:
       assert package documentation does not includes boilerplate

Could the documentation generator simply insert the boilerplate if and only if the package has the __provisional__ attribute? I'm not an expert in Python documentation but isn't it generated from properly-formatted comments within the Python source?

Isaac Morland                   CSCF Web Guru
DC 2554C, x36650                WWW Software Specialist
_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com

Reply via email to