RE: [PHP-DEV] Design by Contract

From: Date: Wed, 11 Feb 2015 14:14:32 +0000
Subject: RE: [PHP-DEV] Design by Contract
References: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16  Groups: php.internals 
Request: Send a blank email to [email protected] to get a copy of this message
Hi Lester,

> All of the current demands ... and I think they are demands! ... stamp
> on past history and load even more work on everybody to have to support
> all these new features. Even if dbc is wrapped in comment blocks to hide
> it it's potential presence in third party parts of a project means that
> all tools have to be modified and my use of phpdoc is further eroded.

The proposal to embed DbC conditions in phpdoc is just defining new '@' keywords.
That's the implicit way such a basic annotation system works : tools ignore the lines they
don't understand. I ran phpDocumentor on DbC-commented script files,  and it still produces the
same documentation. It's supposed to be the same with everyone extending phpdoc syntax.

So, I don't understand why you should modify any of your tools.

Cheers

François



Thread (220 messages)

« previous php.internals (#82478) next »