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

QDoc: Restore support for outputting to a single directory

    XMLWordPrintable

Details

    • 67697ecfd4be9b9835bfda1c47562f5e5e349134, 68218ea38d34ad93055f022b40c193c162e35879, 7f777897715290573ebdc580eb4e9fdc0bee3de6

    Description

      Get QDoc to output HTML files onto a single directory.

      Before Qt 5.0, QDoc naturally outputted its generated HTML files onto a single directory.

      This would help the canonization of documentation URLs to doc/qt/ and as a result:
      -better usability for people entering HTML filenames
      -better search results as Google prefers canonized URLs

      There should be an option to turn this on in QDoc. The modularized documentation should be the default for packaging and the non-modularized build just for the website.

      Things to consider:
      -the relative links from one module to another in the HTML generator.
      -the collision pages and pages with the same filenames (small risk as this was communicated a long time ago).

      Attachments

        Issue Links

          depends on

          Bug - A problem which impairs or prevents the functions of the product. QTBUG-32881 Qt Sensors Grue and Explorer examples generate QDoc warnings

          • P2: Important - Urgent, should be fixed, but will not stop the release.
          • Closed

          Bug - A problem which impairs or prevents the functions of the product. QTBUG-32935 QDoc is having problems with an internal class with a \relates command

          • P3: Somewhat important - Should be fixed, but doesn't affect the release in any way.
          • Closed

          Bug - A problem which impairs or prevents the functions of the product. QTBUG-32990 QDoc: Extra "module.html" pages created

          • P3: Somewhat important - Should be fixed, but doesn't affect the release in any way.
          • Closed
          is required for

          Task - A task that needs to be done. QTBUG-32173 Qt 5.2 Documentation Issues (meta bug)

          • P2: Important - Urgent, should be fixed, but will not stop the release.
          • Closed
          No reviews matched the request. Check your Options in the drop-down menu of this sections header.

          Activity

            People

              gbk Martin Smith (Qt)
              jerome.pasion Jerome Pasion
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: