perlcritic man page

[John Dollar]

Is it just me, or is the man page for perlcritic messed up?

I ask because it's very confusing when it comes to severity.

First, it states for the "-severity N" option:

Severity values are integers ranging from 1 (least severe) to 5 (most
severe). The default is 5.

(which makes you figure it defaults to the MOST SEVERE.)

Then later on, for "-severity NAME":

SEVERITY NAME ...is equivalent to... SEVERITY NUMBER
--------------------------------------------------------
-severity gentle -severity 5
-severity stern -severity 4
-severity harsh -severity 3
-severity cruel -severity 2
-severity brutal -severity 1

Which is 100% the opposite.

Then for the "-gentle | -stern | -harsh | -cruel | -brutal" options:

These are named shortcuts for setting the "-severity" option. For
example, "-cruel" is equivalent to "-severity 4".

Umm...no...according to the table above, 4 is "-stern", not "-cruel".

And, of course, the real answer is that the table for "-severity NAME" is the
*ONLY* place that it is correct. However, it DOES default to 5, which is the
LEAST severe.

So, either this is written in some new version of the English language I've
never seen where words change their meanings paragraph to paragraph, or it's
completely confusing/wrong/needs fixing/etc./etc.