[Qt-interest] How to use QDoc

[Malyushytsky, Alex]

>> That's not correct, qdoc is publicly available.  It's developed within
the Qt source tree under tools/qdoc3.

I am not insisting that the way I see it is right, but
availability of the executable or source code does not mean it meant to be used outside of the company.
As I believe was stated it is included in Qt package just in order for Qt documentation to be built.

I guess Qt team just don't want to deal with support of additional product.
As for me this states that you may use the tool, but it may be changed or discontinued at any time.
This is a reason why you would probably never see any documentation how the code has to be prepared so tool works properly.
The result is that you have the tool which nobody promised you to support,
you don't know how to use and can be discontinued at any time.
This includes documentation availability.

It does not mean you can't use it, but it means you are on your own with it.
It neither means anybody trying to hide it, but nobody cares to release or maintain it.

By the way I have a link which might help:

http://doc.qt.nokia.com/qdoc/


Regards,
        Alex





-----Original Message-----
From: Rohan McGovern [mailto:rohan.mcgovern at nokia.com]
Sent: Wednesday, August 18, 2010 3:16 PM
To: Malyushytsky, Alex
Cc: qt-interest at trolltech.com
Subject: Re: [Qt-interest] How to use QDoc

Malyushytsky, Alex said:
> I believe it was stated by QT team that QDoc is not going to be released to public.

That's not correct, qdoc is publicly available.  It's developed within
the Qt source tree under tools/qdoc3.

With the rest of your mail, I agree.  qdoc3 is built for Qt.  Projects
other than Qt which want a similar documentation tool should use
doxygen.

> Why would not you use other tool, which is documented?
>
> For example what feature you are missing in Doxygen, which make you too look in QDoc?
> http://www.stack.nl/~dimitri/doxygen/
>
--
Rohan McGovern
QA Engineer
Qt Development Frameworks, Nokia


---------------------------------------------------------------------------------------------------
Weidlinger Associates, Inc. made the following annotations.

“This message and any attachments are solely for the intended recipient and may contain confidential or privileged information. If you are not the intended recipient, any disclosure, copying, use, or distribution of the information included in this message and any attachments is prohibited. If you have received this communication in error, please notify us by reply e-mail and immediately and permanently delete this message and any attachments. Thank you.”

“Please consider our environment before printing this email.”