setup.py installs tests, but not documentation

Once this is resolved, the two nevowinstall columns on buildbot should actually be green. We're pretty close, it'd be great to get all the way there. :)

Hm... [17018] was intended to fix this. It does appear to have fixed it when setuptools is used to install, e.g. http://buildbot.divmod.org/builders/linux32-py2.4-nevowinstall/builds/76/steps/select_2/logs/stdio , but not when setuptools is not, e.g.: http://buildbot.divmod.org/builders/linux32-py2.4-nevowinstall/builds/76/steps/select/logs/stdio

Hm, I wonder why setuptools and distutils behave differently with data_files. Inspection of the stdout logs shows that doing setup.py install with setuptools installs the "chattutorial" files: http://buildbot.divmod.org/builders/linux32-py2.4-nevowinstall/builds/76/steps/shell_8/logs/stdio and {{{setup.py install without doesn't: http://buildbot.divmod.org/builders/linux32-py2.4-nevowinstall/builds/76/steps/shell_6/logs/stdio .

I wonder if adding all those files to a MANIFEST or MANIFEST.in would make distutils install them.

(In [17289]) Branching to 'skip-howtotests-2713'

(In [17290]) Skip these tests if the howto listings cannot be found

refs #2713

Changes in the branch remove these failures by turning them into skips.

I can't think of any suitable modifications to make to any distutils files to cause these docs to be installed, since the way distutils installs things, there's no sensible place to put the files (arguably the place setuptools puts them is not sensible either, but it still puts them there).

Since I'm not actually fixing this ticket - installing the documentation - I've filed #2883 for the fix I made here.

Further, since actually installing the docs reliably is a really, really hard problem, I'm going to make the prediction that this is not going to be done in the foreseeable future and indicate that by closing this ticket as wontfix. If someone wants to figure out how to do this (on Windows, on OS X, on the various Linux distros, etc), great, please re-open this ticket.