[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-kdoc
Subject:    Re: some bugs(?) in kdoc-2.07a
From:       Sirtaj Singh Kang <ssk () physics ! unimelb ! edu ! au>
Date:       1999-04-15 22:39:19
[Download RAW message or body]

On Thu, 15 Apr 1999, Ted Irons wrote:

> I'm not sure if bugs should  be reported to this list,
> or directly to Taj.  Please let me know.  Thanks.

Either will do.

> Is there a list of known kdoc-2 bugs someplace?
> (Eg the 'int a,b;' problem still seems to be around.)

Have a look at the TODO file; it's got bugs, todo and wishlist items (very
haphazard).

I will check if the KDE bug reporting system is willing to accept bugs for
kdoc, I think it should be ok.
 
> would say which file it is processing (currently it only
> seems to do this if it is successful?)

Hmm.. I have not noticed this behaviour. I will look into it.
 
Re: the "unknown class" message: it will mark anything that is has not
parsed itself as unknown; so istream etc will be noted as unknown. I am
currently writing the inheritance parser so many of these problems will
disappear soon. The old one was a quick hack just to get kdoc working.

> It doesn't appear that the html versions of the header
> files are being generated - or did I miss some switch
> on the command line?

This is also a TODO pending the reaching of the parser to a usable state. 
If you look on the kde web page, you can get to an archive of this list; a
recent message contained a stop-gap implementation of this feature if you
really need it right away. 

> Does the restriction still exist that documentation
> is to be picked up only from the header files and
> not from the *.cc files also?

The framework to do this is already mostly in place, but I have not tried
kdoc on real .cc/.cpp files yet so if it works it will be a miracle. I
hope to make it optional to write the doc comment before the function 
implementation instead of in the header.

-Taj.

Sirtaj S. Kang       taj@kde.org         ssk@physics.unimelb.edu.au
School of Physics    Univ of Melbourne   Less hype. More code. KDE.

[prev in list] [next in list] [prev in thread] [next in thread]