Build of man pages fails: man/_static/ does not exist

[Jeroen T. Vermeulen]

Running “make man” in a fresh branch fails at a late stage, with output like:

«
writing... maas.8 { } maas-import-pxe-files.8 { } maas-region-admin.8 { }
build succeeded, 5 warnings.

Exception occurred:
  File "mybranch/docs/versions.py", line 34, in write_versions_file
    with open(versions_file, 'wb') as f:
IOError: [Errno 2] No such file or directory: u'mybranch/man/_static/versions.json'
»

The error generates an additional traceback file in /tmp, but I believe that to hold a derivative error:

«
Traceback (most recent call last):
  File "/usr/lib/python2.7/dist-packages/sphinx/cmdline.py", line 254, in main
    app.build(force_all, filenames)
  File "/usr/lib/python2.7/dist-packages/sphinx/application.py", line 221, in build
    self.emit('build-finished', None)
  File "/usr/lib/python2.7/dist-packages/sphinx/application.py", line 400, in emit
    results.append(callback(self, *args))
  File "mybranch/docs/versions.py", line 34, in write_versions_file
    with open(versions_file, 'wb') as f:
IOError: [Errno 2] No such file or directory: u'mybranch/man/_static/versions.json'
»

[Raphaël Badin (rvb)]

I can't reproduce this (either on my machine or on a fresh canonistack instance). Can you try again and re-open this bug if it still fails for you?

[Jeroen T. Vermeulen (jtv)]

The generated man pages are kept in revision control. There has to be something to build, or “make” simply won't build the man pages.

Try deleting one of the man/*.8 files, or updating one of the rst files in doc/man.