[Development] How to build Qt5's docs?

[lars.knoll at nokia.com]

On Aug 22, 2012, at 9:16 AM, ext Äijälä Johanna <Johanna.Aijala at digia.com> wrote:

> 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?

qhelpgenerator is not there in your setup for some reason. Did you forget to build it?

Lars

> 
> 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
> _______________________________________________
> Development mailing list
> Development at qt-project.org
> http://lists.qt-project.org/mailman/listinfo/development