[Releasing] Documentation not generated

Äijälä Johanna Johanna.Aijala at digia.com
Tue Aug 21 08:39:54 CEST 2012


Hi,

we are still having problems with generating the documentation, here is the last log we have:

error   20-elo-2012 22:42:30    ../src/qt-webpages.qdoc:119: This page exists in more than one file: "Qt Quarterly"
error   20-elo-2012 22:42:30    ../../../qtpim/doc/src/qt-webpages.qdoc:127: [It also exists here]
error   20-elo-2012 22:42:30    ../src/qt-webpages.qdoc:123: This page exists in more than one file: "Qt Mailing Lists"
error   20-elo-2012 22:42:30    ../../../qtpim/doc/src/qt-webpages.qdoc:131: [It also exists here]
error   20-elo-2012 22:42:30    ../src/external-resources.qdoc:393: This page exists in more than one file: "Qt Centre"
error   20-elo-2012 22:42:30    ../../../qtpim/doc/src/external-resources.qdoc:347: [It also exists here]
error   20-elo-2012 22:42:30    ../src/external-resources.qdoc:398: This page exists in more than one file: "KDE"
error   20-elo-2012 22:42:30    ../../../qtpim/doc/src/external-resources.qdoc:352: [It also exists here]
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:152: This page exists in more than one file: "Widgets ??"
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:94: [It also exists here]
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:28: [It also exists here]
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:152: This page exists in more than one file: "Widgets ?? ? ????"
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:94: [It also exists here]
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:28: [It also exists here]
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:152: This page exists in more than one file: "Widgets ?? ? ????"
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:94: [It also exists here]
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:28: [It also exists here]
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:152: This page exists in more than one file: "Widgets ?? ? ????"
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:94: [It also exists here]
error   20-elo-2012 22:42:30    ../src/zh_CN/tutorials/widgets-tutorial.qdoc:28: [It also exists here]
error   20-elo-2012 22:42:34    Error in line 10661: Missing attribute in keyword at line 10661.
error   20-elo-2012 22:42:34    make[1]: *** [qch_docs] Error 255
build   20-elo-2012 22:42:34    make[1]: Leaving directory `/data2/build-dir/DQTC-RELBUILDQT500LGPLSRCPACK-SRCPKG/doc-build/qt-everywhere-opensource-src-5.0.0/qtdoc/doc'
error   20-elo-2012 22:42:34    make: *** [sub-doc-qch_docs] Error 2

This is the sha we are using: qtdoc 07ff56c42ef256dafa7c28af431af635293c84b2 and  qtbase d2bba5e5535726f277e8dc67b1478168f57b24bd. Are these correct, the latest working shas?

And this is the sequence we are using to generate docs:
  DOC_BUILD=$CUR_DIR/doc-build
  mkdir -p $DOC_BUILD
  cp -R $CUR_DIR/$PACKAGE_NAME $DOC_BUILD
  cd $DOC_BUILD/$PACKAGE_NAME
  # Build bootstrapped qdoc
  ./configure -developer-build -opensource -confirm-license -nomake examples -nomake tests -release
  (cd qtbase && make -j30 sub-tools-bootstrap && make -j30 sub-qdoc)
  # Run qmake in each module, as this generates the .pri files that tell qdoc what docs to generate
  QMAKE=$PWD/qtbase/bin/qmake
#  for i in q* ; do if [ -d $i -a -e $i/*.pro ] ; then (cd $i ; $QMAKE ; cp module-paths/modules/*.pri ../qtbase/module-paths/modules ) ; fi ; done
  for i in `cat $MODULES` ; do if [ -d $i -a -e $i/*.pro ] ; then (cd $i ; $QMAKE ; cp module-paths/modules/*.pri ../qtbase/module-paths/modules ) ; fi ; done
  # Build libQtHelp.so and qhelpgenerator
  (cd qtbase && make -j30)
  (cd qtxmlpatterns ; make -j30)
  (cd qttools ; make -j30)
  (cd qttools/src/assistant/help ; make -j30)
  (cd qttools/src/assistant/qhelpgenerator ; make -j30)
  # Generate the offline docs and qt.qch
  (cd qtdoc ; LD_LIBRARY_PATH=$PWD/../qttools/lib make -j30 qch_docs)
  # Put the generated docs back into the clean source directory
  mv $DOC_BUILD/$PACKAGE_NAME/qtdoc/doc/html $CUR_DIR/$PACKAGE_NAME/qtdoc/doc
  mv $DOC_BUILD/$PACKAGE_NAME/qtdoc/doc/qch $CUR_DIR/$PACKAGE_NAME/qtdoc/qch

So there is no segmentation fault this time, but still the docs fail.

1. Are there still bug(s) in sources?
2. Are we using correct shas?
3. Is the sequence we are using for generating docs correct?

There are three bugs for this:
https://bugreports.qt-project.org/browse/QTBUG-26880 is probably a duplicate for https://bugreports.qt-project.org/browse/QTBUG-26615 , at least they both are segfaulting. And there is https://bugreports.qt-project.org/browse/QTBUG-26849 which is a result of the previous bugs.

Br,
Johanna


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


More information about the Releasing mailing list