[Development] What are differences/relations among CMake targets with "docs" word?

[Haowei Hsu]

Thanks for your reply, Eike.
There is another question confusing me:
What are the *qattributionsscanner_XXX* targets doing?

[image: image.png]
---
Haowei Hsu

Eike Ziller <Eike.Ziller at qt.io> 於 2023年8月2日 週三 下午2:11寫道：

> Hi,
>
> prepare_docs runs qdoc with -prepare,
> generate_docs runs qdoc with -generate (depends on prepare_docs),
> html_docs is basically a synonym for generate_docs,
> qch_docs creates the QtHelp databases (.qch files) for Assistant/Qt
> Creator,
> and docs ist a target that depends on html_docs and qch_docs, so it
> triggers them both.
> The "install" variants install the html files and the QtHelp databases
> respectively, with install_docs again triggering both.
>
> See https://code.qt.io/cgit/qt/qtbase.git/tree/cmake/QtDocsHelpers.cmake
> for the details.
>
> Br, Eike
>
> > Am 02.08.2023 um 04:02 schrieb Haowei Hsu <hwhsu1231 at gmail.com>:
> >
> > Hello, Qt Development Team.
> >
> > I noticed that there the following CMake targets with "docs" word in
> qt/qtbase:
> >     •
> > docs(_xxx)
> >     • generate_docs(_xxx)
> >     • html_docs(_xxx)
> >     • install_docs(_xxx)
> >     • install_html_docs(_xxx)
> >     • install_qch_docs(_xxx)
> >     • prepare_docs(_xxx)
> >     • qch_docs(_xxx)
> >
> > I wondered what are differences/relations among them?
> >
> > <image.png>
> >
> > Besides, I found that both html_docs(_xxx) and docs(_xxx) generate the
> same HTML
> > output, but there are lots of Warning Messages when building
> html_docs(_xxx). For
> > example, warning: Can't link to 'index.html'
> >
> > <image.png>
> >
> > ---
> > Haowei Hsu
> > --
> > Development mailing list
> > Development at qt-project.org
> > https://lists.qt-project.org/listinfo/development
>
> --
> Eike Ziller
> Principal Software Engineer
>
> The Qt Company GmbH
> Erich-Thilo-Str. 10
> 12489 Berlin, Germany
> eike.ziller at qt.io
> https://qt.io
>
> Geschäftsführer: Mika Pälsi,
> Juha Varelius, Jouni Lintunen
> Sitz der Gesellschaft: Berlin, Registergericht: Amtsgericht
> Charlottenburg, HRB 144331 B
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.qt-project.org/pipermail/development/attachments/20230805/9526bfd1/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 25000 bytes
Desc: not available
URL: <http://lists.qt-project.org/pipermail/development/attachments/20230805/9526bfd1/attachment-0001.png>