Re: [Zope-dev] Declaring interfaces for Products

2001-09-10 Thread Dieter Maurer

=?iso-8859-1?Q?Dario=5FLopez-K=E4sten?= writes:
  I am making a product using the Interface approach described in the ZDG.
  
  As I understand it, Interfaces should expose all methods that provide
  funtionality for my product, with the possible exception of internal methods
  used as utility methods in the class itself. Is this correct?
You could have different interfaces, targeting different
audiences: TTW interfaces, scripting interfaces, programming interfaces.

  Apart from using security declarations, I want to make some of the methods
  available thru the web (TTW), and some of the methods not publishable TTW.
  In order to be able to publish a method TTW, they need to have a docstring,
  right?
There is a project proposal to eliminate this DocString abuse

  Now, in my interface defintion I want to provide doc-strings for all methods
  that are exposed (the interface), but not all them are to be publishable
  TTW. Can I achieve this by using docstrings for my methods in the Interface,
  but not in the Implementation, or do I need to omit the doc-string in both
  the Interface and the Implementation?
It should be enough to omit the doc string from the implementation.


Dieter

___
Zope-Dev maillist  -  [EMAIL PROTECTED]
http://lists.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://lists.zope.org/mailman/listinfo/zope-announce
 http://lists.zope.org/mailman/listinfo/zope )



Re: [Zope-dev] Declaring interfaces for Products

2001-09-10 Thread Dario Lopez-Kästen

   In order to be able to publish a method TTW, they need to have a
docstring,
   right?
 There is a project proposal to eliminate this DocString abuse

:-) sounds nice :-)


   Now, in my interface defintion I want to provide doc-strings for all
methods
   that are exposed (the interface), but not all them are to be
publishable
   TTW. Can I achieve this by using docstrings for my methods in the
Interface,
   but not in the Implementation, or do I need to omit the doc-string in
both
   the Interface and the Implementation?
 It should be enough to omit the doc string from the implementation.

excellent, thank you Dieter.

/Dario



___
Zope-Dev maillist  -  [EMAIL PROTECTED]
http://lists.zope.org/mailman/listinfo/zope-dev
**  No cross posts or HTML encoding!  **
(Related lists - 
 http://lists.zope.org/mailman/listinfo/zope-announce
 http://lists.zope.org/mailman/listinfo/zope )