On Sunday 09 December 2001 01:11 pm, Tavis Rudd wrote:
> Chuck,
> I'd be happy to go with 90, or even 100, as a standard maximum line
> width for Webware so we can end this debate and get back to more
> productive things. Either would be better than the no-wrapping
> situation in the current codebase.
> Tavis
Well at least we kept it on -devel. In the pre-devel days we would have
lost half our -discuss members. :-)
In any case, I agree, but what I had in mind as the most productive
next step was the doc string issues.
But this has to be discussed as well because I have some questions:
Off the top of my head I remember you mentioning:
def foo(self):
'''Returns a bar.'''
return self
My problem is that multi-paragraph strings look strange because the
first is indented but the others aren't.
def foo(self):
'''Returns a bar.
Override to customize the baz.'''
return self
So my pref is:
def foo(sefl):
'''
Returns a bar.
Override to customize the baz.
'''
return self
I like this because the delimiters, paragraphs and code all line up and
look neat (as in 'clean'). Obviously, both use the same # of lines.
Questions:
- You mentioned it is easier to word wrap the first style. Did you mean
for the editor or when you wrap it by hand or what? What does that
mean? (Sorry if I missed a clarification; I'm still catching up on
messages.)
- How well does pydoc work with these styles?
- when spewing HTML
- when browsing via a terminal
- How would the emacs developers react to a request to fully support
syntax highlight of Python strings?
- If the reaction is negative, we'll switch to """
That's all I can think of. I'll research the last two.
-Chuck
_______________________________________________
Webware-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/webware-devel
