RE: [PHP-DEV] Design by Contract
| From: | François Laupretre | 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 internals+get-82478@lists.php.net 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