Skip Menu |

This queue is for tickets about the Text-CSV CPAN distribution.

Report information
The Basics
Id: 87685
Status: rejected
Priority: 0/
Queue: Text-CSV

People
Owner: Nobody in particular
Requestors: ALEENA [...] cpan.org
Cc:
AdminCc:

Bug Information
Severity: Normal
Broken in: (no value)
Fixed in: (no value)



Subject: No HOW TO section in documentation
The documentation, as written now, makes the assumption the reader is savvy leaving the unsavvy readers behind. A HOW TO section would help bridge the gap. I have a .csv file with the headings on the first line of the file. Also several fields within the file are spread across multiple lines. Under HOW TO, it would be nice to see: use strict; use warnings; use Text::CSV; use Data::Dumper; open(my $file,'<','contacts.csv') or die $!; ... # what goes here? print Dumper($array_of_hashes_ref) # or $hash_of_hashes_ref
On Thu Aug 08 06:26:10 2013, ALEENA wrote: Show quoted text
> The documentation, as written now, makes the assumption the reader is > savvy leaving the unsavvy readers behind. A HOW TO section would help > bridge the gap. > > I have a .csv file with the headings on the first line of the file. > Also several fields within the file are spread across multiple lines. > > Under HOW TO, it would be nice to see: > > use strict; > use warnings; > > use Text::CSV; > use Data::Dumper; > > open(my $file,'<','contacts.csv') or die $!; > > ... # what goes here? > > print Dumper($array_of_hashes_ref) # or $hash_of_hashes_ref
See SYNOPSIS, which is your HOW TO section. IMHO it is fairly well-written already. If you don't understand the code written there, you might want to read some introductory text on Perl itself first.