sphinx/reportbug.rst

   1 Report a bug
   2 ============
   3
   4 If you believe that there is a bug in ``###pkgname###``, we would be grateful if
   5 you take the time to report it. Only known problems can get fixed!
   6
   7 Here are a few tips to help you report this bug in a way that facilitates its
   8 resolution.
   9
  10 .. container:: foldup
  11
  12   .. container:: expandinstructions
  13
  14      Click on an item to expand it
  15
  16   Please double-check the name of the faulty package
  17     If you have trouble with a command, you can identify the corresponding package
  18     by running this command in a terminal::
  19
  20       $ dpkg -S `readlink -f $(which COMMAND)`
  21
  22     where ``COMMAND`` is the name of the command that fails.
  23
  24     If you believe there is a problem with a file installed on your system you
  25     can find the responsible package by running::
  26
  27       $ dpkg -S FULLPATH
  28
  29     where ``FULLPATH`` is the complete absolute path of the file.
  30
  31   Try to reproduce the bug
  32     If you cannot reproduce the bug it is likely that the package maintainer
  33     also cannot do it. Please make an attempt to find out under which
  34     circumstances the faulty behavior occurs. However, if you can't figure it
  35     out, please report the bug nevertheless -- maybe someone else can provide
  36     the missing information.
  37
  38   Describe the problem so that the developer can reproduce it
  39     That means including every single detail -- not just the "important" ones.
  40     What kind of system (hardware/software) are you using? What did you do
  41     exactly when the bug hit you?
  42
  43     Remember: bug reports are not just input for developers, but also help other
  44     users to identify whether they are affected by the same problem, and a
  45     recommended solution applies to them as well.
  46
  47     A good bug report is an important service to the community!
  48
  49     More information on high quality bug reporting is available at:
  50     http://raphaelhertzog.com/go/bugreporting/
  51
  52
  53 Please email bug reports to the neurodebian-users_ or neurodebian-devel_
  54 mailing list -- whichever is more appropriate. In rare cases where your
  55 bug report contains confidential information, please email it directly
  56 to `team@neuro.debian.net <mailto:team@neuro.debian.net?subject=BUG-###pkgname###:>`_.
  57
  58 If you have evidence that the faulty behavior is not specific to NeuroDebian,
  59 your bug report is best directed to the developers of the respective software.
  60
  61 .. raw:: html
  62
  63   <script type="text/javascript">
  64     var split = location.search.replace('?', '').split('=')
  65     if ( split[0] == 'p' ) {
  66       $(document.body).html($(document.body).html().replace('###pkgname###', split[1]));
  67     }
  68   </script>
  69
  70 .. include:: link_names.txt