I would be in favor of this. +1 -Charles
Joe Wreschnig wrote:
Right now, most pyglet docstrings use ''' (triple single quotes) rather than """ (triple double quotes). Although ''' is valid to delimit Python multiline strings, it confuses a number of syntax highlighters such as Google Code and Emacs. I was going to fix Emacs's highlighter, but in checking the standard [http://www.python.org/dev/peps/pep-0257/], I found: For consistency, always use """triple double quotes""" around docstrings. Use r"""raw triple double quotes""" if you use any backslashes in your docstrings. For Unicode docstrings, use u"""Unicode triple-quoted strings""". This makes reading parts of the pyglet code extremely difficult, for example http://code.google.com/p/pyglet/source/browse/pyglet/sprite.py#211. So while I may fix Emacs, I think it's also a good idea to fix pyglet. This would be a trivial but very noisy patch, and I'd like at least one other person to agree with me it's a good idea before I go make it. Another option would be to prepare per-file or per-module patches, but my view is that it's usually best to do one giant future-conflict-creating merge instead of several smaller ones.
-- You received this message because you are subscribed to the Google Groups "pyglet-users" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/pyglet-users?hl=en.
