[SciPy-dev] ndimage - docfiller and output_type
Wed Oct 28 14:34:58 CDT 2009
On Wed, Oct 28, 2009 at 2:07 PM, Pauli Virtanen <email@example.com> wrote:
> Wed, 28 Oct 2009 11:13:10 -0400, josef.pktd wrote:
>> No, I like the current system where we don't have any boiler plate in
>> the individual distributions. Following your maxwell example, we would
>> get a lot of repetition of template code in the individual
> Then, I'd suggest just adding
> or so, that will be expanded to the full boilerplate information block.
> Then, only this would be repeated in each distribution docstring -- not
> too bad.
If you can do it with minimal code/text duplication, then any way is fine
> It is clearer and cleaner if the distribution docstring is a template,
> resides in the class docstring, and the final product is assembled by
> substitution rather than by concatenating magically generated parts.
> (Think, for example -- why are HTML templating languages so popular, as
> opposed to just concatenating blocks of HTML code?)
The last time I looked at mako, it allowed full inheritance and backward (?)
substitution in the templates.
I don't see how template inheritance would work with simple string
substitution, but you are the experts for the numpy/scipy documentation
> Pauli Virtanen
> Scipy-dev mailing list
More information about the Scipy-dev