Forums : Ohloh General Discussion

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]

Comment ratio metrics / Perl

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 :)

AndyArmstrong over 17 years ago
 

The same seems to be true for Python docstrings.

Torsten Bronger over 17 years ago
 

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. :-)

Robin Luckey over 17 years ago
 

I'll certainly volunteer for the POD parser :)

AndyArmstrong over 17 years ago