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:
  13
  14    a) Verify that you are running the latest version of cvs2svn.
  15
  16    b) Read the current frequently-asked-questions list at
  17       http://cvs2svn.tigris.org/faq.html to see if your problem has a
  18       known solution, and to help determine if your problem is caused
  19       by corruption in your CVS repository.
  20
  21    c) Check to see if your bug is already filed in the issue tracker
  22       (see http://tinyurl.com/2uxwv for a list of all open bugs).
  23
  24 Then, mail your bug report to dev@cvs2svn.tigris.org.
  25
  26 To be useful, a bug report should include the following information:
  27
  28    * The revision of cvs2svn you ran.  Run 'cvs2svn --version' to
  29      determine this.
  30
  31    * The version of Subversion you used it with.  Run 'svnadmin
  32      --version' to determine this.
  33
  34    * The exact cvs2svn command line you invoked, and the output it
  35      produced.
  36
  37    * The contents of the configuration file that you used (if you used
  38      the --config option).
  39
  40    * The data you ran it on.  If your CVS repository is small (only a
  41      few kilobytes), then just provide the repository itself.  If it's
  42      large, or if the data is confidential, then please try to come up
  43      with some smaller, releasable data set that still stimulates the
  44      bug.  The cvs2svn project includes one script that can often help
  45      you narrow down the source of the bug to just a few *,v files,
  46      and another that helps strip proprietary information out of your
  47      repository.  See the FAQ (http://cvs2svn.tigris.org/faq.html) for
  48      more information.
  49
  50 The most important thing is that we be able to reproduce the bug :-).
  51 If we can reproduce it, we can usually fix it.  If we can't reproduce
  52 it, we'll probably never fix it.  So describing the bug conditions
  53 accurately is crucial.  If in addition to that, you want to add some
  54 speculations as to the cause of the bug, or even include a patch to
  55 fix it, that's great!
  56
  57 Thank you in advance,
  58 -The cvs2svn development team