[fpc-pascal] Re: fpdoc and overloaded functions.

Graeme Geldenhuys graemeg.lists at gmail.com
Wed Sep 13 15:48:42 CEST 2006

I see FPC docs have the same issue...

For example: TypInfo.GetPropList

No easy way to document each overloaded method...

  - Graeme -

On 13/09/06, Graeme Geldenhuys <graemeg.lists at gmail.com> wrote:
> Hi,
> What is the best way to document overloaded functions using fpdoc?
> For example, I have a Find function which has been overloaded four
> times with different parameters.  Looking in the generated *.xml file,
> I only have one Find element, followed by all the different
> parameters, each in there own element node.
> In my previous documenting system, I had a different description for
> each Find method. With fpdoc, I can only have one.  I thought if I
> documented the parameters, the html output might be what I wanted, but
> it isn't.
> See the link below to help explain what I mean:
>   http://opensoft.homeip.net/tiopf/tiobject/ttiobject.find.html
> Problems:
> 1. How do I get a different description for each overloaded Find method.
> 2. Why is the title "Arguments" repeated. (Note I only documented the
> first two Find methods as an example). I normally don't document the
> functions, I rather mention them in the function description.
> 3. Is there no other way (html layout) so the arguments are easier to
> match there respected overloaded functions.  Currently it is difficult
> to see what argument relates to what overloaded function.
> Is there a FPC html doc possibly showing the correct / better way of
> documenting overloaded functions.
> Regards,
>   - Graeme -
> --
> There's no place like

There's no place like

More information about the fpc-pascal mailing list