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

Let QDoc output to subdirectories

    XMLWordPrintable

Details

    • Task
    • Resolution: Done
    • P2: Important
    • 5.0.0
    • None
    • Documentation
    • None
    • aee67a4ae65b9dc9b0a97fe9adf9c850c201de11 5ea45bb50a8b1df8d16650e17a7a2b42488ba7b0 980c2ff51b44200d19b01e66649e4c3c2afa8d92 55124462bdcc46ef7da45f9abfb202699127102d 460ea409c5c0a7c61b0d6bdee8b6018d5815d82c a0d220d0727863d6be4291227c2eb828619b7f2d

    Description

      Currently qdoc can only output content to one directory. When using a repository with subdirectories this might make a mess.

      For instance you download the qt5 bundle (qt5.git), you will now have subdiretories for all modules, such as qtbase, qtdoic, qtdeclarative. If those modules now contain a file with the same name (say index.qdoc which should generate index.html) they will overwrite each other.

      A solution could be that you would output to <outputdir>/qtbase/index.html and <outputdir>/qtdoc/index.html. A problem that would appear here however is that it is unclear to which page you want to link if the title, input and output names are the same (index.qdoc generates index.html with title Index) a way to circumevent that is to set the title of the page correctly to something like QtBase Index.

      Attachments

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

        Activity

          People

            gbk Martin Smith (Qt)
            cvandonderen Casper van Donderen
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews