4
###############################################################################
6
# A template for submitting a bug report.
8
# Run this program and read the output from the command line.
10
# reverse('�'), March 2004, John McNamara, jmcnamara@cpan.org
18
REPORTING A BUG OR ASKING A QUESTION
20
Feel free to report bugs or ask questions. However, to save time
21
consider the following steps first:
23
Read the documentation:
25
The Spreadsheet::WriteExcel documentation has been refined in
26
response to user questions. Therefore, if you have a question it is
27
possible that someone else has asked it before you and that it is
28
already addressed in the documentation. Since there is a lot of
29
documentation to get through you should at least read the table of
30
contents and search for keywords that you are interested in.
32
Look at the example programs:
34
There are over 40 example programs shipped with the standard
35
Spreadsheet::WriteExcel distribution. Many of these were created in
36
response to user questions. Try to identify an example program that
37
corresponds to your query and adapt it to your needs.
40
print "Press enter ..."; <STDIN>;
44
If you submit a bug report here are some pointers.
46
1. Put "WriteExcel:" at the beginning of the subject line. This helps
47
to filter genuine messages from spam.
49
2. Describe the problems as clearly and as concisely as possible.
51
3. Send a sample program. It is often easier to describe a problem in
52
code than in written prose.
54
4. The sample program should be as small as possible to demonstrate the
55
problem. Don't copy and past large sections of your program. The
56
program should also be self contained and working.
58
A sample bug report is generated below. If you use this format then it
59
will help to analyse your question and respond to it more quickly.
61
Please don't send patches without contacting the author first.
65
print "Press enter ..."; <STDIN>;
70
=======================================================================
72
To: John McNamara <jmcnamara@cpan.org>
73
Subject: WriteExcel: Problem with something.
77
I am using Spreadsheet::WriteExcel and I have encountered a problem. I
78
want it to do SOMETHING but the module appears to do SOMETHING_ELSE.
80
Here is some code that demonstrates the problem.
85
use Spreadsheet::WriteExcel;
87
my $workbook = Spreadsheet::WriteExcel->new("reload.xls");
88
my $worksheet = $workbook->add_worksheet();
90
$worksheet->write(0, 0, "Hi Excel!");
95
I tested using Excel XX (or Gnumeric or OpenOffice.org).
97
My automatically generated system details are as follows:
101
print "\n Perl version : $]";
102
print "\n OS name : $^O";
103
print "\n Module versions: (not all are required)\n";
107
Spreadsheet::WriteExcel
115
for my $module (@modules) {
117
eval "require $module";
120
$version = $module->VERSION;
121
$version = '(unknown)' if not defined $version;
124
$version = '(not installed)';
127
printf "%21s%-24s\t%s\n", "", $module, $version;