STINNER Victor added the comment:

I pushed another large patch to "fix" the indentation of abstract.h. I would 
prefer to also have this "reindent" change on review, but our reviewing tool 
doesn't support patch series :-(


Attached cleanup.patch reformats deeply the header file to use the same style 
for all comments, use the same style used in other Python headers. IMO it makes 
the header file more consistent with other header files and it makes the file 
more readable.


R. David Murray (r.david.murray):
> Uniformize" isn't really an English word :)

Oh, it's a frenglish word in this case :-) Good to know.


Serhiy Storchaka: "You have moved some comments and now some descriptions are 
placed below the corresponding declaration, and some descriptions are placed 
above. Now it is not clear to what function every comment is related."

It don't think that my change makes abstract.h worse, some comments were far 
from their declaration, and there is was no unique style for comments. It's a 
mess.


Serhiy: "You should either revert your changes or change *all* headers by 
moving *all* descriptions above corresponding declarations."

My plan is to rewrite completely abstact.h, this file annoys me since many 
months :-)


"That would be very large patch, and I doubt it will be approved."

Why not?


"Please don't make such large changes without a review."

You reviewed rename.patch, I only made tiny changes after this patch. As I 
explained, it's hard to work on such large patch.

----------
Added file: http://bugs.python.org/file45777/cleanup.patch

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue28838>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to