Re: [Epydoc-devel] epydoc 3.0 docstring truncation
Brought to you by:
edloper
From: Edward L. <ed...@gr...> - 2006-03-23 16:57:15
|
Tim Van Steenburgh wrote: > Had my first experience with epydoc today, using 3.0. Ran the GUI tool > wth default options to create html docs for a single py file. The first > character of every line in my docstrings has been truncated in the html > output. Google didn't help me this time. Any ideas? Yeah, this is caused by a bug in epydoc 3.0 alpha's handling of systems that use CRLF for newline. It's fixed in subversion. If you're comfortable with it, I'd recommend getting epydoc from subversion for now -- there have been a lot of other bug fixes too (as well as some new features). Epydoc 3.0 involved a lot of changes from epydoc 2, and is still very much an alpha release. Otherwise, you could wait for the next alpha (or beta) release, or just use epydoc 2 for now. -Edward p.s., If you'd prefer a quick fix, replace 'r' with 'rU' in line 517 or epydoc/docparser.py: - module_file = codecs.open(module_doc.filename, 'r', encoding) + module_file = codecs.open(module_doc.filename, 'rU', encoding) |