[fpc-pascal] Re: fpdoc and overloaded functions.
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:
> 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:
> 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.
> - Graeme -
> There's no place like 127.0.0.1
There's no place like 127.0.0.1
More information about the fpc-pascal