Opened 9 years ago

Last modified 9 years ago

#14199 closed defect

Docbuilder and auto-generated files — at Version 7

Reported by: jdemeyer Owned by: mvngu
Priority: blocker Milestone: sage-5.8
Component: documentation Keywords:
Cc: jhpalmieri Merged in:
Authors: Reviewers:
Report Upstream: N/A Work issues:
Branch: Commit:
Dependencies: Stopgaps:

Status badges

Description (last modified by jdemeyer)

On some OS X 10.6 system, I noticed that suddenly the following changes appeared in my working repository:

  • doc/en/reference/misc/sagetex.rst

    diff --git a/doc/en/reference/misc/sagetex.rst b/doc/en/reference/misc/sagetex.rst
    a b  
    1 Installing and using SageTeX
    2 ============================
     1.. nodoctest
    4 SageTeX is a system for embedding computations and plots from Sage into
    5 LaTeX documents. It is included by default with Sage, so if you have
    6 installed Sage, you already have SageTeX. However, to get it to work,
    7 you need to make TeX aware of SageTeX. Instructions for that are in the
    8 "Make SageTeX known to TeX" section of the `Sage installation guide
    9 <>`_ (`this link
    10 <../../installation/index.html>`_ should take you to a local copy of the
    11 installation guide).
     3.. _sagetex:
     8.. This file has been autogenerated.
     11.. automodule:: sagetex
     12   :members:
     13   :undoc-members:
     14   :show-inheritance:

If this an autogenerated file, it should not be tracked by Mercurial. And also, what happened to this file, why did all content get removed?

This happened with sage-5.8.beta2, it is always reproducible (at least on this particular build), even when no source files have changed. The output of a make doc-html run can be found in doc.log.

Making the file sagetex.rst unwritable shows where the file is written:

Traceback (most recent call last):
  File "/Users/buildbot/sage-5.8.beta2/devel/sage/doc/common/", line 45, in build_ref_doc
    getattr(ReferenceSubBuilder(doc, lang), format)(*args, **kwds)
  File "/Users/buildbot/sage-5.8.beta2/devel/sage/doc/common/", line 662, in _wrapper
    self.write_auto_rest_file(module_name.replace(os.path.sep, '.'))
  File "/Users/buildbot/sage-5.8.beta2/devel/sage/doc/common/", line 924, in write_auto_rest_file
    outfile = open(filename, 'w')
IOError: [Errno 13] Permission denied: '/Users/buildbot/sage-5.8.beta2/devel/sage/doc/en/reference/misc/sagetex.rst'

Change History (7)

comment:1 Changed 9 years ago by jdemeyer

  • Description modified (diff)

comment:2 Changed 9 years ago by jdemeyer

  • Description modified (diff)

comment:3 Changed 9 years ago by jdemeyer

  • Description modified (diff)

comment:4 Changed 9 years ago by jhpalmieri

  • Cc jhpalmieri added

comment:5 follow-up: Changed 9 years ago by jhpalmieri

I think I may have seen something like this a long time ago, in the early stages of testing #6495, but then I thought it had to do with maybe not deleting the old doc output or something like that. Was this a build from scratch or an upgrade?

I think that the only OS X 10.6 system that I have access to is, and I can't reproduce this there, at least after building the docs a few times with a freshly built Sage 5.8.beta2.

comment:6 in reply to: ↑ 5 Changed 9 years ago by jdemeyer

Replying to jhpalmieri:

Was this a build from scratch or an upgrade?

I don't remember, it was on a buildbot machine (bsd.math), but I guess it was a build from scratch. On bsd.math look for /Users/buildbot/sage-5.8.beta2-14199.tar.bz2 which is a build with this problem.

comment:7 Changed 9 years ago by jdemeyer

  • Description modified (diff)
Note: See TracTickets for help on using tickets.