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/project_issues.html
  11
  12 Before reporting a bug, check to see if it is already filed in the
  13 issue tracker.  If it is not, then mail your bug report to
  14 dev@cvs2svn.tigris.org.
  15
  16 To be useful, a bug report should include the following information:
  17
  18    * The revision of cvs2svn.py you ran.  Look for a line like
  19      "$LastChangedRevision: 789 $" near the top of cvs2svn.py (the
  20      number will probably be different, of course).
  21
  22    * The version of Subversion you used it with.
  23
  24    * The exact cvs2svn.py command line you invoked, and the output it
  25      produced.
  26
  27    * The data you ran it on.  If your CVS repository is small (only a
  28      few kilobytes), then just provide the repository itself.  If it's
  29      large, or if the data is confidential, then please try to come up
  30      with some smaller, releasable data set that still stimulates the
  31      bug.  Often this is just a matter of invoking cvs2svn on deeper
  32      subdirectories, until you find the minimal reproduction case.
  33
  34 The most important thing is that we be able to reproduce the bug :-).
  35 If we can reproduce it, we can usually fix it.  If we can't reproduce
  36 it, we'll probably never fix it.  So describing the bug conditions
  37 accurately is crucial.  If in addition to that, you want to add some
  38 speculations as to the cause of the bug, or even include a patch to
  39 fix it, that's great!
  40
  41 Thank you in advance,
  42 -The cvs2svn development team