Reporting Bugs in Darcs ======================= To report a bug in Darcs, just send an email to `bugs@darcs.net `_ describing the problem. It will appear as an unread bug on `http://bugs.darcs.net/. `_ If you have never reported a Darcs bug before, your message will be held in a quarantine area until a human confirms that it's not spam. Therefore your first bug report might not appear for a day or two. Sorry! If this happens, please wait a day before resending the bug. Otherwise two tickets get created, and we have to merge them. Please also ensure that the subject concisely expresses the problem: "darcs get doesn't work over sshfs" is a better subject than "bug report". Help Us to Help You ------------------- Thanks for your bug report! To fix a bug, we need to be able to reproduce it reliably. That means we need a set of instructions that will, at least for you, ALWAYS cause the bug to appear. Often the easiest way to do this is simply to make the buggy repository publicly available. That is, so we can "darcs get URL" to get it. Is there such a URL? It might be that if you "darcs get" the repository, the problem goes away. In that case, we need an exact copy of the buggy repository (i.e. a tarball or zip file) somewhere we can download. Best of all is if you can reproduce the problem in a brand new repository. So instead of us having to go through your whole repository, we can just use a set of instructions like darcs init touch foo darcs add foo darcs record --all --message 'Added foo.' foo ... that will cause the problem to appear. This allows us to add those instructions almost verbatim into the bugs/ or tests/ directories in Darcs' source, making our work much easier. Any of this will give us a huge head start on fixing your bug. It's also helpful if you can send the details to `bugs@darcs.net `_, which will create a bug ticket on `http://bugs.darcs.net/ `_ which we (and you!) can use to track the status of the bug. -------------- *Sounds like a candidate for ``http://code.haskell.org/darcs/darcs-team/``* -- `EricKow `_ 2009-01-03