[Zope] - Ugh. Missing __doc__ causes major headaches

[Jim Fulton]

Gabe Wachob wrote:
> 
> I spent a few stupid hours tracking this down...
> 
> ZPublisher will complain that a "document cannot be found" if a method
> being referred to in a URL does not have a doc string (ie __doc__ or the
> ''' ...''' at the beginning of the method definition). Now, I remember
> reading something about this (doc strings required to make Bobo objects
> published) in the Bobo documentation back when bobo was the new hot
> thing, but it took me several hours to realize this was the problem
> tonight. I didn't see this mentioned in the Zope dox, and it had
> completely slipped my mind. Of course, now that I've found the problem,
> I see where its mentioned in the ORB Documentation.
> 
> Someone might want to highlight this somewhere (a FAQ?). I was thinking
> a Product "Checklist" would be very useful. Also, examples of Folderish
> items...

Good idea.  Note that if Bobo debug mode is enabled, then
the error message would have highlighted this.  Unfortunately, 
the ZopeHTTPServer doesn't use debug mode by default.
We should probably try to figure out a way to do this.

Jim

--
Jim Fulton           mailto:jim@digicool.com
Technical Director   (540) 371-6909              Python Powered!
Digital Creations    http://www.digicool.com     http://www.python.org

Under US Code Title 47, Sec.227(b)(1)(C), Sec.227(a)(2)(B) This email
address may not be added to any commercial mail list with out my
permission.  Violation of my privacy with advertising or SPAM will
result in a suit for a MINIMUM of $500 damages/incident, $1500 for
repeats.