[fpc-devel] fpdoc gives error on deprecated keyword

Michael Van Canneyt michael at freepascal.org
Tue Jul 21 12:08:27 CEST 2009

On Tue, 21 Jul 2009, Graeme Geldenhuys wrote:

> Michael Van Canneyt wrote:
>>>> Is fpdoc expecting a different syntax for "deprecated" keyword?
>>> fpdoc also fails to generate HTML help output for that class 
>>> (TVisOwnedQrySelect) and any other classes defined below it in the unit.
>> This is logical, as it has encountered an error.
> OK. The reason I mentioned that it did not continue to generate the HTML 
> output, is because sometimes fpdoc can handle "soft errors" like syntax 
> errors in the documentation, yet it still dumps the content as is to the HTML 
> output.
> In this case it does not do that.

Some errors are indeed 'recoverable', when others are not.

>> The problem is in the pparser unit: it does not recognize 'deprecated' 
>> after a class type definition. This unit needs to be enhanced.
> I've never worked on a pascal parser yet, but I'll try and take a stab at the 
> pparser unit - if nobody else beats me to it.
>> In fact, in the end it should parse a whole pascal unit, but that is a long
>> term goal.
> Couldn't fpdoc use the FPC parser instead of it's own?  Or are they not so 
> flexible. If fpdoc could, that would mean updating one parser would update 
> both FPC and fpdoc, plus no code duplication.
> Then again, I could be talking rubbish - like I said, I have never worked on 
> a pascal parser before. ;-)

The compiler parser pulls in way too much of the rest of the compiler, and is
intertwined with the code generator, so that is not an option. Don't think I 
haven't considered it...


More information about the fpc-devel mailing list