Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-50287

Conflicting example titles causes one to go undocumented

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Done
    • Icon: P4: Low P4: Low
    • Some future release
    • 5.6.0 Beta
    • Documentation
    • None
    • Debian/testing, GNU/Linux, x86_64
    • Iaf8602fc338dadcc0998f33d41ad9fbc827589e2

      During make docs:

      .../qt5/qtbase/examples/widgets/doc/src/systray.qdoc:28: warning: This page title exists in more than one file: System Tray Icon Example
      .../qt5/qtbase/examples/widgets/desktop/systray/doc/src/systray.qdoc:28: warning: [It also exists here]
      .../qt5/qtbase/examples/widgets/doc/src/systray.qdoc:28: error: HTML file already exists; overwriting .../qt5/qtbase/doc/qtwidgets/qtwidgets-desktop-systray-example.html
      qdoc: error: HTML file already exists; overwriting .../qt5/qtbase/doc/qtwidgets/qtwidgets-desktop-systray-window-cpp.html
      qdoc: error: HTML file already exists; overwriting .../qt5/qtbase/doc/qtwidgets/qtwidgets-desktop-systray-window-h.html
      qdoc: error: HTML file already exists; overwriting .../qt5/qtbase/doc/qtwidgets/qtwidgets-desktop-systray-main-cpp.html
      qdoc: error: HTML file already exists; overwriting .../qt5/qtbase/doc/qtwidgets/qtwidgets-desktop-systray-systray-pro.html
      qdoc: error: HTML file already exists; overwriting .../qt5/qtbase/doc/qtwidgets/qtwidgets-desktop-systray-systray-qrc.html
      make[5]: Leaving directory '.../qt5/qtbase/src/widgets'
      

      and, sure enough, a find | xargs grep reveals

      qt5/qtbase/examples/widgets/doc/src/systray.qdoc:30:    \title System Tray Icon Example
      qt5/qtbase/examples/widgets/desktop/systray/doc/src/systray.qdoc:30:    \title System Tray Icon Example
      

      The diff between these two files is small - I suspect the file got moved and we somehow managed to not delete one of them, or someone rebased a change past the move and inadvertently restored the deleted version of the file with some fixes that should be ported to the moved version.
      (Assign to me if you want me to do git magic to uncover the detailed history.)

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

            vertries Nico Vertriest (Inactive)
            Eddy Edward Welbourne
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:

                There are no open Gerrit changes