[Development] Building Qt documentation with developer-build

[Mitch Curtis]

> -----Original Message-----
> From: Nils Jeisecke <nils.jeisecke at saltation.com>
> Sent: Friday, 5 October 2018 2:17 PM
> To: Jaroslaw Kobus <Jaroslaw.Kobus at qt.io>
> Cc: Mitch Curtis <mitch.curtis at qt.io>; development at qt-project.org
> Subject: Re: [Development] Building Qt documentation with developer-build
> 
> Hi!
> 
> Am 05.10.2018 um 05:46 hat Jaroslaw Kobus geschrieben:
> > You may also want to check the
> > https://bugreports.qt.io/browse/QTBUG-65762 - if you think the issue
> > is still not solved, you may reopen / report new bug report.
> 
> After rebuilding Qt it works now. On macOS is is sufficient to install clang with
> brew. The qmake stuff looks at the brew default location with
> 5.12 so setting LLVM_INSTALL_DIR is not necessary.
> 
> Thanks for your help!
> 
> However building the documentation with "make docs" in one of the
> submodules is rather slow. Pretty annoying when you only want to check
> whether your changes look ok when compiled to HTML.

Yeah, it is. One kinda small speed-up can be made by only running make html_docs in a specific folder, such as src/qml if you're editing QML docs, rather than doing it in the top level qtdeclarative directory and building both QML and Qt Quick docs.

> Nils