Although the perldoc for CGI.pm shows the OO interface, when you look at anything else Lincoln Stein has written about it, he shows the functional interface instead.

When I bugged him about it last week on the boat, he said something like "Yeah, that whole doc needs to be rewritten, but I'm too busy at the moment".

I take that to mean that Lincoln himself prefers the functional interface for small to medium programs, and simply has the OO interface in the docs because of inertia.

-- Randal L. Schwartz, Perl hacker