Re: [Epydoc-devel] epydoc 3.0 docstring truncation
Brought to you by:
edloper
From: Tim V. S. <tva...@gm...> - 2006-03-23 17:03:46
|
Awesome, thanks for the quick response! On 3/23/06, Edward Loper <ed...@gr...> wrote: > > 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 firs= t > > 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 =3D codecs.open(module_doc.filename, 'r', encoding) > + module_file =3D codecs.open(module_doc.filename, 'rU', encoding) > |