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