Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Mailing lists / lazarus / 2013-04

Building LCL docs

5 messages · 3 people · –

Reply by email Subscribe to this list Your subscription

Read-only archive. Use j and k to move between messages.

Graeme Geldenhuys

Hi,

What is the state of building LCL docs? Is it even possible at the moment?

I've tried using fpdoc from FPC 2.6.2, 2.6.3 and 2.7.1. I each case fpdoc crashes. I've tried generating HTML, CHM and IPF documentation - no luck with any of them.

I'm using Lazarus (trunk) from r40661 (28 March 2013).

Regards,
- Graeme -

fpGUI Toolkit - a cross-platform GUI toolkit using Free Pascal http://fpgui.sourceforge.net/

Reply by email

Mattias Gaertner
to Graeme Geldenhuys
Show quoted text 9 lines
Hi, What is the state of building LCL docs? Is it even possible at the moment? I've tried using fpdoc from FPC 2.6.2, 2.6.3 and 2.7.1. I each case fpdoc crashes. I've tried generating HTML, CHM and IPF documentation - no luck with any of them. I'm using Lazarus (trunk) from r40661 (28 March 2013).

Confirmed. fpdoc crashes under Linux 64bit too.

Mattias

Reply by email

Marco van de Voort
to Mattias Gaertner
Mattias Gaertner wrote 7 lines
> I've tried using fpdoc from FPC 2.6.2, 2.6.3 and 2.7.1. I each case > fpdoc crashes. I've tried generating HTML, CHM and IPF documentation - > no luck with any of them. > > I'm using Lazarus (trunk) from r40661 (28 March 2013). Confirmed. fpdoc crashes under Linux 64bit too.

I'm still debugging, but I get the feeling this is because someone passes some fpmake as an unit (to document) while it is a pascal main program. Of course fpdoc could check better, but probably all it can do is throw an error.

So probably the scripts that auto create lists of units should filter out fpmake.

Reply by email

Mattias Gaertner
to Marco van de Voort
Show quoted text 13 lines
On Fri, Apr 12, 2013 at 04:45:15PM +0200, Mattias Gaertner wrote: > > I've tried using fpdoc from FPC 2.6.2, 2.6.3 and 2.7.1. I each case > > fpdoc crashes. I've tried generating HTML, CHM and IPF documentation - > > no luck with any of them. > > > > I'm using Lazarus (trunk) from r40661 (28 March 2013). > > Confirmed. fpdoc crashes under Linux 64bit too. I'm still debugging, but I get the feeling this is because someone passes some fpmake as an unit (to document) while it is a pascal main program. Of course fpdoc could check better, but probably all it can do is throw an error.

That would be much better than a crash.

So probably the scripts that auto create lists of units should filter out fpmake.

yes

Mattias

Reply by email

Marco van de Voort
to Mattias Gaertner
Mattias Gaertner wrote 6 lines
> I'm still debugging, but I get the feeling this is because someone passes > some fpmake as an unit (to document) while it is a pascal main program. Of > course fpdoc could check better, but probably all it can do is throw an > error. That would be much better than a crash.

For now, I only added a check there, since I don't where to thoroughly fix this. (it should probably happen much earlier, probably at the "program" kw)

> So probably the scripts that auto create lists of units should filter out > fpmake. yes

Did that too, build_lcl_docs.lpr

I still have some exceptions at the end of the compile sometimes. Luckily I have been able to find a root cause of them (unitialized variables, -gttt and -CR have been very helpful, as usual).

Most problems seem to be in TClassTreeBuilder.AddToClassTree.

Also the CHMs are not as nicely hyperlinked as the 2.6.0 builds were, somehow the .xct content isn't resolved always in again the classtree stuff.

Reply by email