[Development] How to build Qt5's docs?

[casper.vandonderen at nokia.com]

Hi,

There is an issue with the widgets-tutorial because the chinese docs are probably not parsed properly. The crash in qhelpgenerator however comes from missing \relates qdoc commands.
Can you try cherry-picking https://codereview.qt-project.org/#change,32986 (or wait until it is integrated).

That should fix the rest of the problems. (I think)

Casper

From: ext Loaden <loaden at gmail.com<mailto:loaden at gmail.com>>
Date: Tuesday, August 21, 2012 11:48 AM
To: Casper van Donderen <casper.vandonderen at nokia.com<mailto:casper.vandonderen at nokia.com>>
Cc: "Ramsay Lincoln (Nokia-MP/Brisbane)" <lincoln.ramsay at nokia.com<mailto:lincoln.ramsay at nokia.com>>, "development at qt-project.org<mailto:development at qt-project.org>" <development at qt-project.org<mailto:development at qt-project.org>>, "Alpert Alan (Nokia-MP/Brisbane)" <alan.alpert at nokia.com<mailto:alan.alpert at nokia.com>>
Subject: Re: [Development] How to build Qt5's docs?

I can confirmed this change fixed the qt3d's docs issue.
But Still has a error with widgets-tutorial.qdoc.

../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]
Error in line 14348: Missing attribute in keyword at line 14348.
make[2]: *** [docs] Error 255
make[2]: Leaving directory `/home/loaden/qpSOFT/Projects/BuildQt5-x64/qtdoc/doc'
make[1]: *** [sub-doc-docs] Error 2
make[1]: Leaving directory `/home/loaden/qpSOFT/Projects/BuildQt5-x64/qtdoc'
make: *** [module-qtdoc-docs] Error 2

2012/8/21 <casper.vandonderen at nokia.com<mailto:casper.vandonderen at nokia.com>>
I just fixed this in https://codereview.qt-project.org/#change,33170
After that integrates the documentation should build properly.



--
Best Regards
Yuchen

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.qt-project.org/pipermail/development/attachments/20120821/b62a84a8/attachment.html>