-
Notifications
You must be signed in to change notification settings - Fork 237
Reporting Bugs and Feature Requests
If Unison is not working the way you expect, here are some steps to follow.
The unison project does not provide support for old versions. As of 2021-06, help will only be provided for 2.51.3 and newer, and some people are only willing to think about 2.51.4 or git master beyond 2.51.4. If you are running an older version, especially 2.48, please upgrade before asking for help. See https://github.com/bcpierce00/unison/wiki/Downloading-Unison for how to get precompiled binaries.
This guidance to update applies even if your operating system provides an older version. The group of people contributing to unison maintenance is not responsible for how packaging systems (including GNU/Linux distributions) update unison, even though some of them help with some systems. Please address issues such as "FooOS 42 has unison 2.48" to FooOS.
First, look in the manual, and the FAQ section of the old website at https://alliance.seas.upenn.edu/~bcpierce/wiki/index.php. Lots of questions are answered there.
Next, try running Unison with the "-debug all" command line option. This will cause Unison to generate a detailed trace of what it's doing, which may help pinpoint where the problem is occurring.
Try to reduce the complexity of what you are doing; sync locally even if that's not what you ultimately want. If you can succeed at that, add things back one at a time.
If the previous two steps didn't clarify matters, try sending an email describing your problem to the users' list. (Make sure you subscribe first, so that you'll see people's responses in case they reply only to the list!)
Please include the version of Unison you are using (unison -version)`, the ocaml version you compiled with, the OS type you are running it on, the version of the OS, a record of what gets printed when the -debug all`` option is included, and as much information as you can about what went wrong. Be sure to include version information for both machines.
The Github issue tracker has open tickets for bugs, and for enhancement requests. If you can clearly articulate that unison is behaving incorrectly, you are welcome to file a bug report.
Note that bugs must be against recent versions. Even if you report a bug against 2.51.2 in 2020-10, you will be asked to update and retest.
The language should be along the lines of "unison does this wrong. I did X and should have gotten Y but Z happened". If you are about to write "I don't understand how to do X" or "If I did Y would it work", that is a clue that your message belongs on the users list and is not a bug report.
Please set labels, and do not be offended if they are summarily adjusted. Almost always, defect or crash is appropriate.
Please understand that there are not a lot of people spending a lot of time maintaining unison, and that therefore requests for non-trivial features that would be useful to a tiny number of people are not necessarily a good tradeoff of the usefulness of the request vs the cognitive load of open tickets. That said, feature requests that are likely of interest to at least some others are welcome.
Please phrase feature requests as "Add ability to do X" or something along those lines.