Uploaded image for project: 'Data Management'
  1. Data Management
  2. DM-9684

Doxygen document creation at NCSA is broken

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Invalid
    • Resolution: Done
    • Fix Version/s: None
    • Component/s: lsstDoxygen
    • Labels:
      None
    • Team:
      Architecture

      Description

      It looks like doxygen html creation has stopped working following the merge of DM-9458.

      DM-9458 was merged on 27th Feb 2017 during the day and the most recent document build is from earlier that morning.

        Attachments

          Issue Links

            Activity

            Hide
            tjenness Tim Jenness added a comment - - edited

            An example failure can be seen at https://ci.lsst.codes/job/release/job/run-rebuild/434/consoleFull#console-section-3

            The relevant error seems to be:

            cp: cannot stat ‘html’: No such file or directory
            *** Failed to copy doxygen documentation
            

            The create_xlinkdocs.sh script effectively does:

            makeDocs --nodot datarel "$DATAREL_VERSION" > MakeDocs.out
            doxygen MakeDocs.out
            cp -ar html "$DOC_INSTALL_DIR"
            

            and it is complaining here that the html directory can not be found despite doxygen running without errors. I have looked at my changes from DM-9458 and none of my changes affect the HTML output. Furthermore, the makeDocs default output directory for HTML has been ./doc/html since 2011 and this has not changed (and the script does not override the default). I am therefore confused as to how this ever worked because the script that is failing seems to be assuming the output is in ./html.

            Joshua Hoblitt did something else change on Monday?

            Show
            tjenness Tim Jenness added a comment - - edited An example failure can be seen at https://ci.lsst.codes/job/release/job/run-rebuild/434/consoleFull#console-section-3 The relevant error seems to be: cp: cannot stat ‘html’: No such file or directory *** Failed to copy doxygen documentation The create_xlinkdocs.sh script effectively does: makeDocs --nodot datarel "$DATAREL_VERSION" > MakeDocs.out doxygen MakeDocs.out cp -ar html "$DOC_INSTALL_DIR" and it is complaining here that the html directory can not be found despite doxygen running without errors. I have looked at my changes from DM-9458 and none of my changes affect the HTML output. Furthermore, the makeDocs default output directory for HTML has been ./doc/html since 2011 and this has not changed (and the script does not override the default). I am therefore confused as to how this ever worked because the script that is failing seems to be assuming the output is in ./html . Joshua Hoblitt did something else change on Monday?
            Hide
            tjenness Tim Jenness added a comment -

            Work for fixing this in the link script is on DM-9689.

            Show
            tjenness Tim Jenness added a comment - Work for fixing this in the link script is on DM-9689 .

              People

              Assignee:
              tjenness Tim Jenness
              Reporter:
              tjenness Tim Jenness
              Watchers:
              John Swinbank, Jonathan Sick, Joshua Hoblitt, Tim Jenness
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved:

                  Jenkins

                  No builds found.