[Qt-interest] How to use QDoc

[Oliver.Knoll at comit.ch]

Malyushytsky, Alex wrote on Thursday, August 19, 2010 1:37 AM:

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

If the code is deliberately published under a given license then that usually means "Do whatever fits you, as long as you respect the license." And I guess QDoc is under the same license as Qt itself, so you are free to use it :)

If it fits your needs that's a totally different question off course...

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

Well, fair enough, isn't it?

> This is a reason why you would probably never see any documentation
> how the code has to be prepared so tool works properly. 

The source is the doc... err... QDoc... uhm, the self-documenting QDoc...

(sorry, I had to write this one ;)

> It does not mean you can't use it, but it means you are on your own
> with it.

Right ;)
 
> It neither means anybody trying to hide it, but nobody cares to
> release or maintain it. 

I think no one disagrees with you that publishing the source code would be an attempt to hide it ;)

Anyway, the recommendations for e.g. Doxygen have already been given...

Cheers, Oliver
-- 
Oliver Knoll
Dipl. Informatik-Ing. ETH
COMIT AG - ++41 79 520 95 22