[Development] How to build Qt5's docs?

Äijälä Johanna Johanna.Aijala at digia.com
Wed Aug 22 09:16:17 CEST 2012


Hi Casper, 

I'm still unable to create the docs, I checked that I have latest sources from git, both https://codereview.qt-project.org/#change,33187 and https://codereview.qt-project.org/#change,32986 are included.

This is what I'm getting:

../src/zh_CN/getting-started/how-to-learn-qt.qdoc:28: Can't create link to 'Examples and Demos Launcher'
../src/zh_CN/tutorials/widgets-tutorial.qdoc:152: This page exists in more than one file: "Widgets ??"
../src/zh_CN/tutorials/widgets-tutorial.qdoc:94: [It also exists here]
../src/zh_CN/tutorials/widgets-tutorial.qdoc:28: [It also exists here]
../src/zh_CN/tutorials/widgets-tutorial.qdoc:152: This page exists in more than one file: "Widgets ?? ? ????"
../src/zh_CN/tutorials/widgets-tutorial.qdoc:94: [It also exists here]
../src/zh_CN/tutorials/widgets-tutorial.qdoc:28: [It also exists here]
../src/zh_CN/tutorials/widgets-tutorial.qdoc:152: This page exists in more than one file: "Widgets ?? ? ????"
../src/zh_CN/tutorials/widgets-tutorial.qdoc:94: [It also exists here]
../src/zh_CN/tutorials/widgets-tutorial.qdoc:28: [It also exists here]
../src/zh_CN/tutorials/widgets-tutorial.qdoc:152: This page exists in more than one file: "Widgets ?? ? ????"
../src/zh_CN/tutorials/widgets-tutorial.qdoc:94: [It also exists here]
../src/zh_CN/tutorials/widgets-tutorial.qdoc:28: [It also exists here]
/bin/sh: /home/joaijala/Work/qt5_srcpkg/doc-build/qt-everywhere-opensource-src-5.0.0/qtbase/bin/qhelpgenerator: not found
make[1]: *** [qch_docs] Error 127
make[1]: Leaving directory `/home/joaijala/Work/qt5_srcpkg/doc-build/qt-everywhere-opensource-src-5.0.0/qtdoc/doc'
make: *** [sub-doc-qch_docs] Error 2

Is there any other fixes still pending?

Br,
Johanna

-----Original Message-----
From: development-bounces+johanna.aijala=digia.com at qt-project.org [mailto:development-bounces+johanna.aijala=digia.com at qt-project.org] On Behalf Of casper.vandonderen at nokia.com
Sent: 22. elokuuta 2012 9:50
To: alan.ezust at gmail.com; loaden at gmail.com
Cc: development at qt-project.org
Subject: Re: [Development] How to build Qt5's docs?

>On Tue, Aug 21, 2012 at 9:03 AM, Alan Ezust <alan.ezust at gmail.com> wrote:
>>
>> The issue is that in the doc/html/qt.qhp file, on line 14348, is an xml element
>> with a ref="".
>>
>> This is the problem I was having.
>> What is interesting to know is what is on that line? And I bet you it
>> is QDeclarativeImageProvider.

> Sorry, I meant to say QImageCleanupFunction here.

Ah, I thought we had fixed that one.
Cherry-picking https://codereview.qt-project.org/#change,33187 will make qhelpgenerator just generate a warning and not stop processing. A consequence is that you cannot search for the missing ref="" items in the documentation, but at least it gets generated.

Casper
_______________________________________________
Development mailing list
Development at qt-project.org
http://lists.qt-project.org/mailman/listinfo/development



More information about the Development mailing list