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

List:       kde-kdoc
Subject:    Re: KDoc patch - Objective-C support added to document extraction tool
From:       Richard Dale <Richard_Dale () tipitina ! demon ! co ! uk>
Date:       1999-10-27 15:59:57
[Download RAW message or body]

> > Oh dear! Are there significant differences - have I worked on the wrong one
> > then?
> 
> There are big differences! kdoc 2.0 alpha is a complete rewrite and is
> available from the CVS kdoc module or from

Thanks for the info. I'm really pleased with kdoc 1.0 at the moment, having
only just got it working (especially combined with KDevelop). So I think I'll
probably wait until kdoc 2.0 is standard issue, before having a go at adding
Objective-C support.

FYI, here is a small snippet of Objective-C:

@interface SecondClass : NSObject
{
    int h;
    char *dummy;
}

- init;
- printName;

@end

And the same in C++:

class SecondClass : public NSObject
{
   int h;
    char *dummy;
  (void) init();
  (void) printName();
};

-- Richard

 On Wed, 27 Oct 1999, Sirtaj Singh Kang wrote:
> On Wed, 27 Oct 1999, Richard Dale wrote:
> [snip]
> > I have:
> > 
> > duke 1050% kdoc -v
> > kdoc: 1.17  (c) Torben Weis, Sirtaj S. Kang                                    
> > 
> > Oh dear! Are there significant differences - have I worked on the wrong one
> > then?
> 
> There are big differences! kdoc 2.0 alpha is a complete rewrite and is
> available from the CVS kdoc module or from
> 
> 	http://www.ph.unimelb.edu.au/~ssk/kde/kdoc/
> 
> .. but there is good news. The parser is much easier to work with. OTOH I
> have no experience with ObjC and have never seen a single line of ObjC
> code, so I don't know exactly how difficult it will be to add your stuff.
> 
> The parser works something like this:
> 
> read a decl:
> 	read a line
> 	discard if macro, comment or blank
> 	read and parse doc comment if /**
> 	accumulate
> 	end if ; or {
> 	
> identify decl:
> 	match decl with various regexps (eg class/struct/function etc)
> 	call handler for that decl type
> 
> if ObjC declarations are also terminated with ; or { it should not be too
> hard to incorporate them into the parser.
> 
> -Taj.
> 
> Sirtaj S. Kang       taj@kde.org         ssk@physics.unimelb.edu.au
> Univ of Melbourne	The "gui" in "Penguin" is pronounced "K-D-E"

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