See <http://docs.python.org/lib/optparse-callback-example-6.html> where
it says 'either "-" or "-" can be option arguments'. One of these should
be --. The same error occurs several times on the same page.

Not a problem in the Optik docs at
<http://optik.sourceforge.net/doc/1.5/callbacks.html>.

This is only a problem with the 2.5 latex docs.

Indeed, and I can remember trying to get around that, but didn't achieve
anything... I'll close it as won't fix.

At the very least could you change the "--" to be the verbatim class
that shows up properly beneath? There has to be another solution that
would result in the docs at least being correct even if we can't get
LaTeX to do exactly what we want.

Also, see http://bugs.python.org/issue798006 which shows how to fix a
similar problem elsewhere in the docs.

Okay, applied that workaround in rev. 58243.