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

Revisit how we build and use qdoc for documentation building

    XMLWordPrintable

Details

    • 1f646bb97 (dev), 3066e9e38 (dev), c64190caa (dev), f7f02c791 (dev), 3da46b5fc (dev), aab8b7727 (dev), 710bc2d90 (dev), ef3db6245 (6.8), ff0285ce6 (6.8), 32a6d5030 (6.8), de6615057 (6.8), 1e2069b3b (6.8), 28a5486d5 (6.8), 7db1e0a05 (6.8), 2d840624d (dev)

    Description

      As far as i understand, currently we build qdoc in a Jenkins job, which is then manually provisioned in qt5.git. Then each repo's documentation is built using that qdoc.

      This means slow iteration times until a new qdoc can be provisioned, because we usually have various blockages in qt5.git.

      An alternative approach, would be to clone a separate qttools:dev + its consistent sha1 dependencies in a qtbase build , build it, and use it for docs. Do the same for other repos.
      Somehow cache the qdoc binary.

      This would reduce the time needed to wait until a new qdoc is provisioned.

      This has some open questions about how to co-ordinate the versioning around the difference sha1s.

      Attachments

        Issue Links

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

          Activity

            People

              alexandru.croitor Alexandru Croitor
              alexandru.croitor Alexandru Croitor
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:

                Gerrit Reviews

                  There are no open Gerrit changes