Mailman 3 January 2002 - Doc-SIG

Error in pyexpat docs
by uche.ogbuji＠fourthought.com July 9, 2002

July 9, 2002

An excerpt from the Python 2.0 docs for pyexpat: """ ParseFile (file) Parse XML data reading from the object file. file only needs to provide the read(nbytes) method, returning the empty string when there's no more data. [snip] The following attributes contain values relating to the most recent error encountered by an xmlparser object, and will only have correct values once a call to Parse() or ParseFile() has raised a xml.parsers.expat.error exception. ErrorByteIndex Byte index at which an error occurred. [etc.] """ The wrong, "xml.parsers.expat" is the first indicator that there might be a problem, yet I took the docs at their word and wrapped the call to ParseFile in a blanket try/except, only to find that no exception of any sort is ever raised by ParseFile. It turns out that ParseFile actually returns 0 on error, returning 1 otherwise. The first matter is that the code and the docs need to be reconciled. However, I would _much_ rather prefer that things were as in the docs. I think ParseFile should raise an exception rather than return an error flag. Interestingly enough, this is the same argument I had with a colleague just last week. -- Uche Ogbuji Principal Consultant uche.ogbuji(a)fourthought.com +1 303 583 9900 x 101 Fourthought, Inc. http://Fourthought.com 4735 East Walnut St, Ste. C, Boulder, CO 80301-2537, USA Software-engineering, knowledge-management, XML, CORBA, Linux, Python

3 2

mkinfo
by Jochen Küpper Jan. 26, 2002

Jan. 26, 2002

The following message is a courtesy copy of an article that has been posted to comp.lang.python as well. -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 I am trying to build the info docs (cvs Python-2.2 branch) from source on a Linux machine with per-5.6.1[1]. I get the same error as reported in message <mailman.988836005.26823.python-list(a)python.org> (2. May 2001) ,---- | I'm trying to build the docs in info format with 'make info' in the 'Doc' | directory of the Python 2.1. I get the error: | | $ make info | (cd info; make) | make[1]: Entering directory `/usr/local/src/Python-2-1/Doc/info' | ../tools/mkinfo ../html/api/api.html | perl -I/usr/local/src/Python-2-1/Doc/tools /usr/local/src/Python-2-1/Doc/tools/html2texi.pl /usr/local/src/Python-2-1/Doc/html/api/api.html | /usr/local/lib/site_perl/HTML/Element.pm:2091: function main::collect_if_text expected 3 arguments, got 5: Front Matter 1 1 HTML::Element=HASH(0x8268db0) 0 | make[1]: *** [python-api.info] Error 255 | make[1]: Leaving directory `/usr/local/src/Python-2-1/Doc/info' | make: *** [info] Error 2 `---- I realized the following in the README ,---- | Note that info support is currently being revised using new conversion | tools by Michael Ernst <mernst(a)cs.washington.edu>. `---- but since I cannot find a followup or a posted solution to the bug-report I am wondering whether this is an open issue or what the solution to this is? Is this still a process in transition? How are the info-docs for download prepared? Thank you for your help in advance. Greetings, Jochen Footnotes: [1] I now I can download them, but I want to use the toolchain for our own Python module and as such want to be able to generate the files myself. - -- Einigkeit und Recht und Freiheit http://www.Jochen-Kuepper.de Liberté, Égalité, Fraternité GnuPG key: 44BCCD8E Sex, drugs and rock-n-roll -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (GNU/Linux) Comment: Processed by Mailcrypt and GnuPG <http://www.gnupg.org/> iD8DBQE8UureiJ/aUUS8zY4RAqhhAJ0Ufhe4yKnkUCSXlXSHScZHXNrlLQCgqxOA PQAk54Q5S7Pufjqtt0D4pD4= =juRV -----END PGP SIGNATURE-----

1 0

Windows Trojan in doc-sig message from "Linda"
by Mike Clarkson Jan. 23, 2002

Jan. 23, 2002

Careful - there's a Windows Trojan in doc-sig message from "Linda" subject "Re: " OutLook may execute it even if you don't click the attachment. Mike.

1 0

Re:
by Linda Jan. 22, 2002

Jan. 22, 2002

1 0

Python 2.1.2c1 docs
by Fred L. Drake, Jr. Jan. 10, 2002

Jan. 10, 2002

The documentation for Python 2.1.2c1 is online at: http://python.sourceforge.net/maint21-docs/ Please report any real problems with these docs to me or Anthony with a level 7 priority and set the "Group" to "Python 2.1.2". To file a bug, log into SourceForge and then visit: http://sourceforge.net/tracker/index.php?group_id=5470&atid=105470 Thanks! -Fred -- Fred L. Drake, Jr. <fdrake at acm.org> PythonLabs at Zope Corporation

1 0

Python 10 Developers' Day
by David Goodger Jan. 8, 2002

Jan. 8, 2002

Will anyone involved in docstring development be attending Python 10? Although I'd like to, I won't be attending; can't afford it. Jeff Bauer (the Developers' Day chair) has asked if anyone could lead a session. I'd like to know who will be attending and is interested in participating in a docstring session. Anyone interested in leading the session? -- David Goodger goodger(a)users.sourceforge.net Open-source projects: - Python Docstring Processing System: http://docstring.sourceforge.net - reStructuredText: http://structuredtext.sourceforge.net - The Go Tools Project: http://gotools.sourceforge.net

3 2

new version of "Quick reStructuredText"
by David Goodger Jan. 8, 2002

Jan. 8, 2002

I've given the reStructuredText quick reference an overhaul, adding all the missing bits plus a table of contents. Take a look at: http://structuredtext.sourceforge.net/docs/quickref.html -- David Goodger goodger(a)users.sourceforge.net Open-source projects: - Python Docstring Processing System: http://docstring.sourceforge.net - reStructuredText: http://structuredtext.sourceforge.net - The Go Tools Project: http://gotools.sourceforge.net

2 1