[fpc-devel] FPDoc and Lazarus

[michael.vancanneyt at wisa.be]

On Mon, 5 Sep 2011, Felipe Monteiro de Carvalho wrote:

> Hello,
>
> I think that one thing passed here unnoticed Michael, Hans-Peter is
> correct in pointing out that the fpdoc.css is missing and this
> prevents building the FCL docs and nothing is written about this in
> the README.
>
> I think it should be added to the subversion, but which fpdoc.css
> should I add? The one which Lazarus uses? Or do you have a more
> special version for fpc?
>
> I did just this:
>
> cd fpcdocs
> make rtl.chk
> make fcl.chk
>
> and I got:
>
> FPDoc - Free Pascal Documentation Tool
> Version 2.4.4 [2011/05/01]
> (c) 2000 - 2003 Areca Systems GmbH / Sebastian Guenther, sg at freepascal.org
>
> new alias #rtl.System.IInterface (IUnknown)
> new alias #rtl.System.IInterface (IUnknown)
> new alias #rtl.System.IInterface (IUnknown)
> new alias #rtl.System.IInterface (IUnknown)
> new alias #rtl.System.IInterface (IUnknown)
> exception at 000C1293:
> ../packages/fcl-base/src/iostream.pp.
> cp fpdoc.cst fcl/fpdoc.css
> cp: fcl/fpdoc.css: No such file or directory
> make: *** [fcl.chk] Error 1

It is normal that this fails, since the fpdoc run gave an error and did not
produce the fcl dir. What is strange is that the Makefile should not even
run the command in that file.

> I would also like to add to the README the syntax to pass a path to
> the CSS, but this command had no effect for me:
>
> make fcl.chk OPT=-css-file=/Users/felipe/Programas/lazarus/docs/html/fpdoc.css

Define CSSFILE
make fcl.chk CSSFILE=/Users/felipe/Programas/lazarus/docs/html/fpdoc.css

>
> The only way that I could make it work was by creating a directory fcl
> and putting fpdoc.css from Lazarus inside it.
>
> Now it works for me with these commands:
>
> make rtl.chk
> make fcl.chk
> make html FPCSRCDIR=../fpctrunk/
>
> Except for the fact that I have no latex installed, so the html
> generation fails.
>
> One more question:
>
> What is the output of make rtl.chk? I could find nothing...

The rtl dir.

Michael.