July 13, 2010

Faid Faid
Lab Rat
18 posts

Building QtMobility docs

 

I’ve pulled the master branch of QtMobility and I’m looking for a way to build the documentation in ./qt-mobility/doc. I’m on Ubuntu 9.04 and have just built Qt 4.7.0 beta2. Are the QtMobility docs supposed to be built by default if I do a regular ./configure and make && make install? Due to compile errors I had to do a “./configure -modules multimedia” so I suppose I could have lost the docs in that process. If I go into the doc folder and try “qmake && make” it doesn’t build any docs however, it just prints:

  1. cd src/snippets/ && make -f Makefile
  2. make[1]: Entering directory `/home/ubuntu/dev/qt-mobility-git/qt-mobility/doc/src/snippets'
  3. make[1]: Nothing to be done for `first'.
  4. make[1]: Leaving directory `/home/ubuntu/dev/qt-mobility-git/qt-mobility/doc/src/snippets'

6 replies

July 14, 2010

david.laing david.laing
Lab Rat
65 posts

Normally you can use one of

  1. make docs

or
  1. qdoc3 doc/src/qtmobility.qdocconf

although I think the first option is preferred.

There have been some recent changes in master which might have complicated this a little – let me know how it goes.

 Signature 

David Laing
Location API team
Qt Mobility

July 14, 2010

Faid Faid
Lab Rat
18 posts

This is the output I get from ‘make docs’:

  1. ~/dev/qt-mobility-git/qt-mobility$ make docs
  2. /usr/local/Trolltech/Qt-4.7.0/bin/qdoc3 /home/ubuntu/dev/qt-mobility-git/qt-mobility/doc/src/qtmobility.qdocconf
  3. In file included from /home/ubuntu/dev/qt-mobility-git/qt-mobility/doc/src/qtmobility.qdocconf:5:
  4. /home/ubuntu/dev/qt-mobility-git/qt-mobility/doc/src/qt-defines.qdocconf:44: error: Environment variable 'QT_MOBILITY_SOURCE_TREE' undefined
  5. Environment variable 'QT_MOBILITY_SOURCE_TREE' undefined
  6.  
  7. Aborting
  8. make: *** [qch_docs] Error 1

When I run ‘qdoc3 doc/src/qtmobility.qdocconf’ I get a similar output:

  1. ~/dev/qt-mobility-git/qt-mobility$qdoc3 doc/src/qtmobility.qdocconf
  2. In file included from doc/src/qtmobility.qdocconf:5:
  3. doc/src/qt-defines.qdocconf:44: error: Environment variable 'QT_MOBILITY_SOURCE_TREE' undefined
  4. Environment variable 'QT_MOBILITY_SOURCE_TREE' undefined
  5.  
  6. Aborting

July 15, 2010

david.laing david.laing
Lab Rat
65 posts

What happens if you do

  1. export QT_MOBILITY_SOURCE_TREE=~/dev/qt-mobility-git/qt-mobility

before
@make docs@?

 Signature 

David Laing
Location API team
Qt Mobility

July 15, 2010

Faid Faid
Lab Rat
18 posts

Thanks David, that made the docs build.

p.s. Now that I have a Troll on the line.. What’s the best place to ask questions related to the bleeding edge of Qt Mobility? This forum? The Qt Mobility feedback mailing list? Is there a Qt Mobility IRC channel? d.s.

July 16, 2010

david.laing david.laing
Lab Rat
65 posts

They’re all good places to ask – although for IRC I think the regular qt IRC channel (#qt at irc.freenode.net) is the place to go. Personally I’d like to see this forum become the place were questions are asked so that people can come to a central place to ask questions and/or see if the question has been asked or answered previously.

 Signature 

David Laing
Location API team
Qt Mobility

July 16, 2010

Alexandra Alexandra
Hobby Entomologist
607 posts

ONe of the big disadvantages of IRC is that both the questions and the answers get lost. Forums and mailing-lists however archive both and can be searched.

It depends on the issue of course but building a knowledge base over time makes a lot of sense to me…

 Signature 

*THE CAKE IS A LIE*
Web Community Manager - Qt Development Frameworks

 
  ‹‹ C++ Reference in QtCreator help      QObject* parent instead of QObject *parent ››

You must log in to post a reply. Not a member yet? Register here!