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

\a broken when target contains brackets

    XMLWordPrintable

Details

    • Bug
    • Resolution: Done
    • P2: Important
    • 5.6.0 Alpha
    • 5.6
    • Build tools: qdoc
    • None
    • 72e5fda3bd1b50ee3e0da0b5ef6505e632f7f5bc

    Description

      When a link target contains brackets qdoc prints a warning that it "can't link to 'Foobar (comment)'. This is happening in the 5.6 branch. An example is the positioning documentation:

      cd qtlocation/src/positioning
make html_docs

      The outcome is 

      /home/bb/dev/qt/qt56/qtlocation/src/positioning/doc/src/qtpositioning-qml.qdoc:28: warning: Can't link to 'Positioning (QML)'
/home/bb/dev/qt/qt56/qtlocation/src/positioning/doc/src/cpp-position.qdoc:28: warning: Can't link to 'Log File Position Source (C++)'
/home/bb/dev/qt/qt56/qtlocation/src/positioning/doc/src/cpp-position.qdoc:28: warning: Can't link to 'GeoFlickr QML'
/home/bb/dev/qt/qt56/qtlocation/src/positioning/doc/src/cpp-qml-positioning.qdoc:28: warning: Can't link to 'Plane Spotter (QML)'
/home/bb/dev/qt/qt56/qtlocation/src/positioning/doc/src/qtpositioning.qdoc:56: warning: Can't link to 'Positioning (QML)'
/home/bb/dev/qt/qt56/qtlocation/src/positioning/doc/src/qtpositioning.qdoc:56: warning: Can't link to 'Positioning (C++)'
/home/bb/dev/qt/qt56/qtlocation/src/positioning/doc/src/qtpositioning.qdoc:56: warning: Can't link to 'GeoFlickr (QML)'
/home/bb/dev/qt/qt56/qtlocation/src/positioning/doc/src/qtpositioning.qdoc:56: warning: Can't link to 'Log File Position Source (C++)'
/home/bb/dev/qt/qt56/qtlocation/src/positioning/doc/src/qtpositioning.qdoc:56: warning: Can't link to 'SatelliteInfo (C++/QML)'
/home/bb/dev/qt/qt56/qtlocation/src/positioning/doc/src/qtpositioning.qdoc:56: warning: Can't link to 'Weather Info (C++/QML)'

      Attachments

        For Gerrit Dashboard: QTBUG-47919
        # Subject Branch Project Status CR V
        124205,3 qdoc: Correctly resolve non-function links that end in parentheses 5.6 qt/qtbase Status: MERGED +2 0

        Activity

          People

            treinio Topi Reiniö
            ablasche Alex Blasche
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes