Skip Menu |

This queue is for tickets about the Spreadsheet-WriteExcel CPAN distribution.

Maintainer(s)' notes

If you are reporting a bug in Spreadsheet::WriteExcel here are some pointers

1) State the issues as clearly and as concisely as possible. A simple program or Excel test file (see below) will often explain the issue better than a lot of text.

2) Provide information on your system, version of perl and module versions. The following program will generate everything that is required. Put this information in your bug report.

    #!/usr/bin/perl -w

    print "\n    Perl version   : $]";
    print "\n    OS name        : $^O";
    print "\n    Module versions: (not all are required)\n";

    my @modules = qw(
                      Spreadsheet::WriteExcel
                      Parse::RecDescent
                      File::Temp
                      OLE::Storage_Lite
                      IO::Stringy
                      Spreadsheet::ParseExcel
                      Scalar::Util
                      Unicode::Map
                    );

    for my $module (@modules) {
        my $version;
        eval "require $module";

        if (not $@) {
            $version = $module->VERSION;
            $version = '(unknown)' if not defined $version;
        }
        else {
            $version = '(not installed)';
        }

        printf "%21s%-24s\t%s\n", "", $module, $version;
    }

    __END__

3) Upgrade to the latest version of Spreadsheet::WriteExcel (or at least test on a system with an upgraded version). The issue you are reporting may already have been fixed.

4) Create a small but complete example program that demonstrates your problem. The program should be as small as possible. At the same time it should be a complete program that generates an Excel file. If the Spreadsheet::WriteExcel section is part of a much larger program then simplify it down to the essentials. Simulate any DB reads with an array.

5) Say if you tested with Excel, OpenOffice, Gnumeric or something else. Say which version of that application you used.

6) If you are submitting a patch you should check with the author whether the issue has already been patched or if a fix is in the works. Patches should be accompanied by test cases.

Asking a question

If you would like to ask a more general question there is the Spreadsheet::WriteExcel Google Group.

Report information
The Basics
Id: 53346
Status: resolved
Priority: 0/
Queue: Spreadsheet-WriteExcel

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

Bug Information
Severity: Wishlist
Broken in: 2.33
Fixed in: (no value)



Subject: Add an index.html
Hi there: In Debian, registering HTML documentation with doc-base requires an index.html file (or something similar pointing to all the other documentation in your distribution). I'd like to add the included HTML documentation to doc-base, as it provides a common interface to all the HTML documentation in Debian through various GUI tools. Cheers, Jonathan
On Mon Jan 04 13:19:36 2010, JAWNSY wrote:

Show quoted text
> In Debian, registering HTML documentation with doc-base requires an
> index.html file (or something similar pointing to all the other
> documentation in your distribution).
>
> I'd like to add the included HTML documentation to doc-base, as it
> provides a common interface to all the HTML documentation in Debian
> through various GUI tools.

Hi Jonathan,

So you would like me to add an index.html?

Is there any preferred format?

Is it okay if it goes in the docs dir or does it need to be in the root of the tarball?

John.
--
 


John, Thanks for the quick reply. The same directory where the other HTML files are should be good -- actually it doesn't even need to be called index.html, it could be contents.html or whatever you prefer. Just *a* file which I can point to, that in turn points to other files -- perhaps with a description of what the other files are. Basically, just a page you'd want someone to look at if they didn't know where to start in the HTML docs directory. I think this is the first page that will be displayed in the document navigator thing when someone selects your package (libspreadsheet-writeexcel-perl). Thanks very much for your contribution to the CPAN, and for working with us in Debian to get great software out there for everyone :) Cheers, Jonathan On Mon Jan 04 18:06:25 2010, JMCNAMARA wrote: Show quoted text
> On Mon Jan 04 13:19:36 2010, JAWNSY wrote: >
> > In Debian, registering HTML documentation with doc-base requires an > > index.html file (or something similar pointing to all the other > > documentation in your distribution). > > > > I'd like to add the included HTML documentation to doc-base, as it > > provides a common interface to all the HTML documentation in Debian > > through various GUI tools.
> > Hi Jonathan, > > So you would like me to add an index.html? > > Is there any preferred format? > > Is it okay if it goes in the docs dir or does it need to be in the > root of the > tarball? > > John. > --
On Mon Jan 04 20:40:20 2010, JAWNSY wrote:
Show quoted text

> TThe same directory where the other HTML
> files are should be good -- actually it doesn't even need to be
> called index.html, it could be contents.html or whatever you
> prefer.
>
> Just *a* file which I can point to, that in turn points to other files
> -- perhaps with a description of what the other files are.
> Basically, just a page you'd want someone to look at if they didn't
> know where to start in the HTML docs directory.

Hi Jonathan,

I've added an index.html to the docs dir of the distro and pushed it to github:

http://github.com/jmcnamara/spreadsheet-writeexcel

Oddly, there was an existing index.html file in the docs dir until a few releases ago when I did a tidy up and deleted it.

I alsp tagged the release on github as JYU01 in case you want to pre-test it but the tips will do as well.


Show quoted text
> Thanks very much for your contribution to the CPAN, and for working with us in Debian to get great
> software out there for everyone

No problem, I'm always happy to help Debian, it has helped me enough in the past.

John.
-- 

John, I just checked the latest version via github and it looks good. I'm not totally sure what all of Debian's requirements are, but from where I sit, that looks absolutely perfect. For now I've set WriteExcel.html as the index (though that's not really correct), so it should do for now. I'll correct it for the next release of Spreadsheet::WriteExcel (version 2.33 has already hit unstable) Cheers, Jonathan