[Python-Dev] PEP 411: Provisional packages in the Python standard library

[Isaac Morland]

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