Dear Open Hub Users,
We’re excited to announce that we will be moving the Open Hub Forum to
https://community.blackduck.com/s/black-duck-open-hub.
Beginning immediately, users can head over,
register,
get technical help and discuss issue pertinent to the Open Hub. Registered users can also subscribe to Open Hub announcements here.
On May 1, 2020, we will be freezing https://www.openhub.net/forums and users will not be able to create new discussions. If you have any questions and concerns, please email us at
[email protected]
I assume the comment ratio metric doesn't include embedded POD when scanning Perl?
Many Perl developers interleave POD and Perl
=head3 C<foo>
Set or get the foo factor for this frobnicator. Called with no arguments returns the current foo factor
my $foo_factor = $frob->foo;
Called with a single argument sets the foo factor
$frob->foo(11.5);
=cut
sub foo {
...
}
It's also possible to use POD for block comments
=begin comment
Setting foo while the frobnicator is processing documents is safe but won't take effect until the next run. At the start of the current run all settings are captured in a closure - so setting foo has no immediate effect.
=end comment
Are such blocks counted as comments? I think they should be :)
The same seems to be true for Python docstrings.
We're going to open up our source code parser/line counter very soon. We're hoping some brave soul will take it upon themselves to add POD and docstring support to our parser. :-)
I'll certainly volunteer for the POD parser :)