Sign in Join

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

Mailing lists / fpc-pascal / 2012-01

FPDoc visibility sections

3 messages · 2 people ·

Reply by email Subscribe to this list Your subscription

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

Unknown author

Found some strange behaviour imho. For some reason there are extra visibility sections inserted in my documentation, instead of following the source. I expected fpdoc to respect the visibility directives instead of deciding autonomously when to place one.

See for example:

documentation:http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/nvidia-widgets/doc/nvwidgets/uicontext.html [1]

sources (starting from line 209):
http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/nvidia-widgets/src/nvwidgets/nvWidgets.pas?revision=2227&view=markup [2]

Is there a way to manage this behaviour?

Regards, Darius

Links:
------
[1]
http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/nvidia-widgets/doc/nvwidgets/uicontext.html [2]
http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/nvidia-widgets/src/nvwidgets/nvWidgets.pas?revision=2227|+|amp|+|view=markup

Michael Van Canneyt
to Unknown author
Show quoted text 18 lines
Found some strange behaviour imho. For some reason there are extra visibility sections inserted in my documentation, instead of following the source. I expected fpdoc to respect the visibility directives instead of deciding autonomously when to place one.   See for example:   documentation:http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/nvidia-widgets/doc/nvwidgets/uicontext.html sources (starting from line 209): http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/nvidia-widgets/src/nvwidgets/nvWidgets.pas?revision=2227&view=markup   Is there a way to manage this behaviour?

No. It's a bug.

Please enter a bug report, and post a sample unit and description file.

Michael.

Unknown author
to Michael Van Canneyt

I filed the report here:
http://bugs.freepascal.org/view.php?id=21022 [4]

BTW, it think it has
to do with overloaded methods. Whenever fpdoc encounters such methods it will enclose them in visibility directives.

Regards, Darius

Michael Van Canneyt wrote
On Wed, 4 Jan 2012,
[3] wrote
> Found some strange behaviour

imho. For some reason there are extra visibility sections inserted in my documentation, instead of following the source. I expected fpdoc to respect the visibility directives instead of deciding autonomously when to place one. See for example:
documentation:http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/nvidia-widgets/doc/nvwidgets/uicontext.html [1] sources (starting from line 209):
http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/nvidia-widgets/src/nvwidgets/nvWidgets.pas?revision=2227&view=markup [2] Is there a way to manage this behaviour?

No. It's a bug.

Please enter a bug report, and post a sample unit and description file.

Michael.

Links:
------
[1]
http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/nvidia-widgets/doc/nvwidgets/uicontext.html [2]
http://lazarus-ccr.svn.sourceforge.net/viewvc/lazarus-ccr/components/nvidia-widgets/src/nvwidgets/nvWidgets.pas?revision=2227|+|amp|+|view=markup [3]

[4]
http://bugs.freepascal.org/view.php?id=21022