Issue 1186: optparse documentation: -- being collapsed to - in HTML (original) (raw)

This issue has been migrated to GitHub: https://github.com/python/cpython/issues/45527

classification

process

Created on 2007-09-21 09:51 by hoffman, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Messages (6)
msg56074 - (view)	Author: Michael Hoffman (hoffman)	Date: 2007-09-21 09:51
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>.
msg56077 - (view)	Author: Guido van Rossum (gvanrossum) *	Date: 2007-09-21 16:48
This is only a problem with the 2.5 latex docs.
msg56105 - (view)	Author: Georg Brandl (georg.brandl) *	Date: 2007-09-24 07:01
Indeed, and I can remember trying to get around that, but didn't achieve anything... I'll close it as won't fix.
msg56106 - (view)	Author: Michael Hoffman (hoffman)	Date: 2007-09-24 08:23
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.
msg56107 - (view)	Author: Michael Hoffman (hoffman)	Date: 2007-09-24 08:37
Also, see http://bugs.python.org/issue798006 which shows how to fix a similar problem elsewhere in the docs.
msg56118 - (view)	Author: Georg Brandl (georg.brandl) *	Date: 2007-09-24 17:56
Okay, applied that workaround in rev. 58243.