Removed doctest as a justification for funcattrs. :)
This commit is contained in:
parent
6d00c374f2
commit
b7f81f2915
|
@ -33,8 +33,7 @@ Background
|
||||||
For example, John Aycock has written a system where docstrings are
|
For example, John Aycock has written a system where docstrings are
|
||||||
used to define parsing rules[1]. Zope's ZPublisher ORB[2] uses
|
used to define parsing rules[1]. Zope's ZPublisher ORB[2] uses
|
||||||
docstrings to signal "publishable" methods, i.e. methods that can
|
docstrings to signal "publishable" methods, i.e. methods that can
|
||||||
be called through the web. And Tim Peters has developed a system
|
be called through the web.
|
||||||
called doctest[3], where docstrings actually contain unit tests.
|
|
||||||
|
|
||||||
The problem with this approach is that the overloaded semantics
|
The problem with this approach is that the overloaded semantics
|
||||||
may conflict with each other. For example, if we wanted to add a
|
may conflict with each other. For example, if we wanted to add a
|
||||||
|
@ -229,8 +228,6 @@ References
|
||||||
|
|
||||||
[2] http://classic.zope.org:8080/Documentation/Reference/ORB
|
[2] http://classic.zope.org:8080/Documentation/Reference/ORB
|
||||||
|
|
||||||
[3] ftp://ftp.python.org/pub/python/contrib-09-Dec-1999/System/doctest.py
|
|
||||||
|
|
||||||
|
|
||||||
Copyright
|
Copyright
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue