[Python-Dev] PEP 411: Provisional packages in the Python standard library (original) (raw)
Isaac Morland ijmorlan at uwaterloo.ca
Sat Feb 11 17:45:05 CET 2012
- Previous message: [Python-Dev] PEP 411: Provisional packages in the Python standard library
- Next message: [Python-Dev] PEP 411: Provisional packages in the Python standard library
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
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
- Previous message: [Python-Dev] PEP 411: Provisional packages in the Python standard library
- Next message: [Python-Dev] PEP 411: Provisional packages in the Python standard library
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]