Docs do not compile

[clham]

Using pandas v 0.13.0-354-g63ce94d, and sphinx v 1.1.3, Docs fail to compile. Output is as follows.

(pandas)[dev_box@localhost doc]$ python make.py html

Running Sphinx v1.1.3
loading pickled environment... failed: [Errno 2] No such file or directory: '/home/dev_box/python_virt/pandas/pandas/src/pandas/doc/build/doctrees/environment.pickle'
[autosummary] generating autosummary for: 10min.rst, api.rst, basics.rst, comparison_with_r.rst, comparison_with_sql.rst, computation.rst, contributing.rst, cookbook.rst, dsintro.rst, ecosystem.rst, ..., r_interface.rst, release.rst, remote_data.rst, reshaping.rst, rplot.rst, sparse.rst, timeseries.rst, tutorials.rst, visualization.rst, whatsnew.rst
loading intersphinx inventory from http://docs.python.org/objects.inv...
loading intersphinx inventory from http://statsmodels.sourceforge.net/devel/objects.inv...
building [html]: targets for 1177 source files that are out of date
updating environment: 1177 added, 0 changed, 0 removed
Exception occurred while building, starting debugger:                          
Traceback (most recent call last):
  File "/home/dev_box/python_virt/pandas/pandas/src/pandas/doc/sphinxext/ipython_directive.py", line 322, in process_input_line
    source_raw = splitter.source_raw_reset()[1]
AttributeError: 'IPythonInputSplitter' object has no attribute 'source_raw_reset'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/sphinx/cmdline.py", line 189, in main
    app.build(force_all, filenames)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/sphinx/application.py", line 204, in build
    self.builder.build_update()
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/sphinx/builders/__init__.py", line 196, in build_update
    'out of date' % len(to_build))
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/sphinx/builders/__init__.py", line 216, in build
    purple, length):
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/sphinx/builders/__init__.py", line 120, in status_iterator
    for item in iterable:
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/sphinx/environment.py", line 613, in update_generator
    self.read_doc(docname, app=app)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/sphinx/environment.py", line 761, in read_doc
    pub.publish()
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/core.py", line 217, in publish
    self.settings)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/readers/__init__.py", line 72, in read
    self.parse()
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/readers/__init__.py", line 78, in parse
    self.parser.parse(self.input, document)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/parsers/rst/__init__.py", line 172, in parse
    self.statemachine.run(inputlines, document, inliner=self.inliner)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/parsers/rst/states.py", line 170, in run
    input_source=document['source'])
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/parsers/rst/states.py", line 2301, in explicit_markup
    self.explicit_list(blank_finish)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/parsers/rst/states.py", line 2331, in explicit_list
    match_titles=self.state_machine.match_titles)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/parsers/rst/states.py", line 319, in nested_list_parse
    node=node, match_titles=match_titles)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/parsers/rst/states.py", line 2604, in explicit_markup
    nodelist, blank_finish = self.explicit_construct(match)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/parsers/rst/states.py", line 2311, in explicit_construct
    return method(self, expmatch)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/parsers/rst/states.py", line 2054, in directive
    directive_class, match, type_name, option_presets)
  File "/home/dev_box/python_virt/pandas/pandas/lib/python3.3/site-packages/docutils/parsers/rst/states.py", line 2103, in run_directive
    result = directive_instance.run()
  File "/home/dev_box/python_virt/pandas/pandas/src/pandas/doc/sphinxext/ipython_directive.py", line 811, in run
    rgxin, rgxout, promptin, promptout = self.setup()
  File "/home/dev_box/python_virt/pandas/pandas/src/pandas/doc/sphinxext/ipython_directive.py", line 770, in setup
    self.shell = EmbeddedSphinxShell(exec_lines, self.state)
  File "/home/dev_box/python_virt/pandas/pandas/src/pandas/doc/sphinxext/ipython_directive.py", line 306, in __init__
    self.process_input_line(line, store_history=False)
  File "/home/dev_box/python_virt/pandas/pandas/src/pandas/doc/sphinxext/ipython_directive.py", line 326, in process_input_line
    buflist = self.cout.buflist
AttributeError: '_io.StringIO' object has no attribute 'buflist'
> /home/dev_box/python_virt/pandas/pandas/src/pandas/doc/sphinxext/ipython_directive.py(326)process_input_line()
-> buflist = self.cout.buflist 

[jorisvandenbossche]

This is a python 3 issue. Can you try with current master? And first do a python make.py clean before python make.py html

[clham]

That fixed it. Not sure what the issue was.

[jorisvandenbossche]

The issue was just that the docs did not compile with python 3 (code was not python3 compatible), and this was fixed some time ago (I think #5530).