Building QtMobility docs

[Faid]

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:

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

[dalaing]

Normally you can use one of
@make docs@
or
@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.

[Faid]

This is the output I get from 'make docs':

@
~/dev/qt-mobility-git/qt-mobility$ make docs
/usr/local/Trolltech/Qt-4.7.0/bin/qdoc3 /home/ubuntu/dev/qt-mobility-git/qt-mobility/doc/src/qtmobility.qdocconf
In file included from /home/ubuntu/dev/qt-mobility-git/qt-mobility/doc/src/qtmobility.qdocconf:5:
/home/ubuntu/dev/qt-mobility-git/qt-mobility/doc/src/qt-defines.qdocconf:44: error: Environment variable 'QT_MOBILITY_SOURCE_TREE' undefined
Environment variable 'QT_MOBILITY_SOURCE_TREE' undefined

Aborting
make: *** [qch_docs] Error 1
@

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

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

Aborting
@

[dalaing]

What happens if you do
@export QT_MOBILITY_SOURCE_TREE=~/dev/qt-mobility-git/qt-mobility@
before
@make docs@?

[Faid]

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.

[dalaing]

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.

[troubalex]

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