#31 creating documentation doesn't work with cge 5.1.2

[Paul Gevers]

While trying to create documentation for cge 5.1.2 in the Debian package fails because pasdoc exits with a failure. It seems that it doesn't like some deprecation syntaxes in src/opengl/castlecurves.pas and src/components/castlecontrol.pas. Removing the deprecation syntax allows pasdoc to pass.

(pbuild23042) ruapehu pasdoc # ./mk_docs.sh html || echo failed
#some info tags here#
Warning[2]: Error EPasDoc: ./opengl/castlecurves.pas(239): Semicolon at the end of Class / Object / Interface / Record expected while parsing unit castlecurves.pas, continuing...
#some info tags here#
Warning[2]: Error EPasDoc: ./components/castlecontrol.pas(188): One of symbols "," or ":" expected while parsing unit castlecontrol.pas, continuing...
#some info tags here#
Info[2]:    ... Descriptions expanded
Info[2]:    Writing Docs for unit "CastleControl"
Info[2]:    Writing Docs for Introduction, "introduction"
Info[1]:    Done
failed

Of course this is more a bug in pasdoc than in cge, but due to this cge fails to build properly for me.

[Michalis Kamburelis]

Yeah, I was simultaneously fixing PasDoc when I was using some new syntax in CGE:) The result may be that for now, CGE docs can only be build with PasDoc version from SVN, not with stable PasDoc.

I think I'll prefer to fix the situation by releasing new PasDoc version soon (instead of workarounding it in CGE; for the instant fix, like you write, it can be workarounded by removing the "deprecated;"; or by replacing them with "{$ifndef PASDOC} deprecated; {$endif}".)

I'll keep this ticket open until new PasDoc version is available:)

[Michalis Kamburelis]

New PasDoc is now released!:) Sorry for such delay, busy times.