[fpc-pascal] fpdoc questions

[Michael Van Canneyt]

On Mon, 4 Jul 2005, L505 wrote:

> 
> | >  fpdoc --package=rtl --input="system.pp -Fi/directory/"
> | >
> | > Is that the correct syntax? I can't get it to find my include files that it
> | > needs. I am putting the quotes in the wrong place maybe..
> |
> | No, the syntax is correct.
> |
> 
> I tried using absolute paths for the unit I am running fpdoc on, everything and
> it is working now.
> 
> For example to make sure the sysunixh.inc is found properly I must go
> 
> fpdoc --package=rtl --input="/home/l1/FPC/source/fpc2.0.0/rtl/linux/system.pp -F
> i/home/l1/FPC/source/fpc2.0.0/rtl/unix/;"
> 
> as opposed to running fpdoc in a local directory:
> 
> fpdoc --package=rtl --input="system.pp -Fi/home/l1/FPC/source/fpc2.0.0/rtl/unix/
> ;"
> 
>   Can't find unit sysunixh.inc
> 
> 
> Is that normal behaviour?

Normally, relative paths should work. Try using ./system.pp 


> I was going to run FPDOC in a local directory for
> convenience. If it should work locally, I will look at the sources and work on a
> local fpdocompiling patch.

Please do.

> 
> Lars
> 
> p.s. I really do like this way, versus embedded source help messes I've seen.
> definitely clean and automated.

That is one of the principal reasons why fpdoc was developed: 
strict separation of sources and documentation. 
Sources with _serious_ documentation embedded are not really easy to browse or maintain.

Michael.