| Subject: | csv() function has misleading documentation for method call interface |
The csv() function is callable as a method, as is briefly documented:
my $csv = Text::CSV_XS->new ();
my $aoa = $csv->csv (in => "file.csv"); # ignore object attributes
However this is misleading. I believe it means that attributes *for* the object (such as eol) passed to the method will be ignored, and only the calling object's existing attributes will be used (this is what appears to happen). But it is more likely to be interpreted that the object itself is ignored. I think it is worth clarifying the intended behavior.