On Tue, 21 Oct 2008, Frank Niessink wrote:

> 2008/10/21 Jerome Laheurte <[EMAIL PROTECTED]>:
>> The search doesn't work any more for me, but I have to test in the
>> release branch (I'm currently running Trunk locally merged with the
>> 0.71 branch).
>
> Works for me, at least with the simple testing I just did.

Strange, I still get it. I'll look into this.

>> Regarding the copyright notices: I think we should put them in comment
>> instead of putting them in the module docstring. It makes the epydoc
>> documentation ugly :)
>
> Yeah, I've noticted that. Did you test that it makes a difference?
> Would this work as well:
> __copyright__ = ''' <Copyright notice> ''' ?

I was thinking of putting the license in comments and use the standard 
epydoc markers in the module docstring:

# License blah
# blah

"""

This module does stuff

@author: author1 <[EMAIL PROTECTED]>
@author: author2 <[EMAIL PROTECTED]>
@copyright: 2008

"""

There is also a @license field but I newer saw what it looks like 
formatted.

This way, the HTML doc won't read the first license sentence as the 
module description...

Cheers
Jérôme

Reply via email to