BUGS

   1                                                        -*- text -*-
   2
   3                         REPORTING BUGS
   4                         ==============
   5
   6 This document tells how and where to report bugs in cvs2svn.  It is
   7 not a list of all outstanding bugs -- we use an online issue tracker
   8 for that, see
   9
  10    http://cvs2svn.tigris.org/issue_tracker.html
  11
  12 Before reporting a bug, check to see
  13
  14    a) if you are already running the latest version of cvs2svn
  15
  16    b) if your bug is already filed in the issue tracker (see
  17       http://tinyurl.com/2uxwv for a list of all open bugs).
  18
  19 Then, mail your bug report to dev@cvs2svn.tigris.org.
  20
  21 To be useful, a bug report should include the following information:
  22
  23    * The revision of cvs2svn you ran.  Run 'cvs2svn --version' to
  24      discover this.
  25
  26    * The version of Subversion you used it with.
  27
  28    * The exact cvs2svn command line you invoked, and the output it
  29      produced.
  30
  31    * The data you ran it on.  If your CVS repository is small (only a
  32      few kilobytes), then just provide the repository itself.  If it's
  33      large, or if the data is confidential, then please try to come up
  34      with some smaller, releasable data set that still stimulates the
  35      bug.  Often this is just a matter of invoking cvs2svn on deeper
  36      subdirectories, until you find the minimal reproduction case.
  37
  38 The most important thing is that we be able to reproduce the bug :-).
  39 If we can reproduce it, we can usually fix it.  If we can't reproduce
  40 it, we'll probably never fix it.  So describing the bug conditions
  41 accurately is crucial.  If in addition to that, you want to add some
  42 speculations as to the cause of the bug, or even include a patch to
  43 fix it, that's great!
  44
  45 Thank you in advance,
  46 -The cvs2svn development team