PDL::Bugs - Man Page

How to diagnose and report PDL problems

Version

version 1.0000

Description

This module explains how to get help with a PDL problem and how, when, and where to submit a bug report.  In the future it may be extended to provide some sort of automated bug reporting capability.

If You Have a PDL Problem

The primary resource for support for the Perl Data Language is via the PDL mailing lists.  The pdl-general list is for general use and discussions and is the one to use for questions about problems with PDL or PDL use for computation.  This is almost always the list to post to for PDL problems.

The pdl-devel list is specifically for PDL development and often contains discussions of a rather technical nature relating to PDL internals.  This is not the list for general PDL discussion or questions: <http://pdl.perl.org/?page=mailing-lists>.

NOTE: Both pdl-general and pdl-devel are read by the PDL developers so you don't save time or increase the probability of response by posting to pdl-devel or by cross-posting to pdl-devel.  Please stick to pdl-general list posts unless you want to talk PDL implementation and development.

NOTE: There is also a PDL IRC channel which can be useful for immediate questions if populated.  However, it has the big disadvantage of not being easily searched or routinely read by all PDL developers and users.  As a result, if you get an answer there, it may be incorrect or incomplete depending on who happens to be chatting at the time.  It is definitely not readily searchable.

Reporting Bugs

Please submit bug reports via the GitHub issue tracker at <https://github.com/PDLPorters/pdl/issues>.

where you can review the previously submitted bug reports. Click on New issue to generate a bug report.  If you do not already have a GitHub account, you will need to create one to submit the report.

Try to include any information you think might help someone isolate, reproduce, and fix your problem.

At a minimum, include the following information:

Other things that are often helpful:

Alternatively, send an e-mail report with the above information (including the output of perldl -V) to the pdl-devel mailing list. See <http://pdl.perl.org/?page=mailing-lists> for info on how to subscribe to this list.

Before You Send a Report

BEFORE you report a bug make sure you got the latest release version of PDL, always available from CPAN, check <http://metacpan.org/pod/PDL>.

Also, you can check the FAQ at <http://pdl.perl.org/?docs=FAQ&title=PDL::FAQ>. and the mailing list archives for hints. You can find links to the searchable archives at <http://pdl.perl.org/?page=mailing-lists>.

and there is a Google enable search box on the top right of <http://pdl.perl.org> which usually gives the best results.

Patches

Patches can be submitted in several ways, in order of decreasing preference:

  1. Fork the pdl repository on GitHub, make and test your changes, and submit a pull request;
  2. Edit (or suggesting an edit to) the files in-place on GitHub;
  3. Email a patch to the pdl-devel mailing list.

Patches should be made against the latest released PDL or, ideally, against the current git sources which you can browse and check out at <https://github.com/PDLPorters/pdl>.

Thanks, The PDL developers.

Info

2021-02-15 perl v5.32.1 User Contributed Perl Documentation