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

List:       kde-kdoc
Subject:    Re: Development of kdoc cancelled?
From:       Alexander Mueller <amueller () multamedio ! de>
Date:       1999-10-01 7:41:51
[Download RAW message or body]

Bernd Gehrmann wrote:
> 
> On Tue, 28 Sep 1999 Mike J. Chen wrote:
> >About a week ago I sent out to the list a bunch of bug fixes which I'd
> >made to my local copy.  I'm curious, did anyone get it?
> 
> No, but that's not unusual. I have sent two or three mails over the
> last 9 months, and none of them got through.
> 
> Bernd.

O.K. guys, if it's likely that patches and/or bug reports don't
get throught to kdoc@kde.org or taj@kde.org I'll repost my
bug reports here. I would have liked to fix those bugs myself
but I don't know anything about programming in Perl.

Here are my bug reports just as I sent them to kdoc@kde.org...

====================================================================


kdoc2 seems to have some problems parsing overloaded operators.
I hope the description of these problems is helpful to you. I
couldnīt patch the code myself and send you the changes since
Iīm not a Perl programmer.

Take a look at this code snippet (and don't mind the German comments):

// The > operator is overloaded here

/**
* Vergleichsoperator
*/
bool operator > (DateValue& aDate);

This code results in:

<A NAME=operator >></A><A NAME=ref42></A><table width="100%">
<tr bgcolor="#eeeeee"><td><strong>bool  <b>operator &gt;</b>
(<A HREF="DateValue.html">DateValue</A>&amp; aDate)
</strong></td></tr></table></p><p>  Vergleichsoperator</p>

The problem is that any HTML browser would misinterpret the
expression <A NAME=operator >></A> and would display garbage.



Another problem arises form this piece of code:

// The () operator is overloaded here

/**
* Wert als bool lesen
*/
bool operator() ();

When producing HTML output kdoc2 simply "forgets" the second
parentheses. That meams it produces

<A NAME=operator>

instead of 

<A NAME=operator ()>

and (in the corresponding full-list file)

<A HREF="BoolValue.html#operator">

instead of

<A HREF="BoolValue.html#operator ()">


Regards

Alexander Mueller
IBIS MULTA MEDIO GmbH
Wuerzburg, Germany


====================================================================	


The current kdoc2 snapshot seems to have some
problems with template members. C++ code like

map<string, string, less<string> > mTablesToKeys;

results in an error message like

Unidentified decl: map<string, string, less<string> > mTablesToKeys;


Greetings from Germany

Alexander Mueller
IBIS MULTA MEDIO GmbH
Wuerzburg, Germany


====================================================================


When trying out kdoc with some of my C++ code I noticed
that kdoc didn't handle @internal or @deprecated tags
properly. In fact it didn't handle them at all. I must
admit that as a C++ programmer I don't really understand
a single line of Perl code, but nevertheless I dared to
look into kdoc's source. I found that kdoc actually
does handle those @internal and @deprecated tags.
Am I just doing something wrong or is parsing and
generating html output from those tags not implemented
yet?

Regards

Alexander Mueller
IBIS MULTA MEDIO GmbH
97082 Wuerzburg, Germany

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