Ticket submission guidelines

When to create a ticket

• If you discover a bug in Box Backup
  • Make sure the bug has not already been reported. Try searching the tickets or use this report {6}.
  • Be sure it is a real bug. If it may be a local configuration issue or you are not certain it is a bug please send an email to the boxbackup@… list first and ask for help there.
  • If possible please verify that the bug is not already fixed in the SVN trunk.
  • If you can provide a patch with a tested fix the bug will probably get resolved very quickly.
• If you have written a new feature
  • Make sure you attach the patch to the ticket.
  • Make sure your patch conforms to the Box coding guidelines.
  • Do not put unimplemented feature requests in a ticket, add them to the FeatureRequests page instead. It is also a good idea to send an email to boxbackup@… to alert people of your idea: someone else might like the idea and set about implementing it.

These rules apply equally to the code and official documentation. Feel free to improve the wiki documentation directly.

Creating the ticket

Use the new ticket form?.

• Be as helpful and descriptive as you can.
• Make sure you include all the pertinent details you can. eg. Platform is almost always relevant
• Follow the Advanced troubleshooting section in the main wiki if possible.
• Attach any relevant logs, using a debug build if you can.
• If Box Backup crashes include a backtrace from a debug build.
• Remember to attach files after you create the ticket. You have to create the ticket first, then you will be given the option of adding attachments.
• Please do not change the priority or milestone from the defaults. These are for the developers to set.

Patches

• should conform to the Box coding guidelines.
• should be posted as attachments as svn diff output, or failing that in unified diff format (diff -u). Run diff from the top level directory of your Box Backup source tree, rather than the leaf directory where the file is.
• should apply cleanly to SVN trunk.
• should have been tested before submission.

Support

Box Backup is a volunteer project so please be patient when waiting for a response to your ticket. We will respond to all tickets as time permits, but following these guidelines will make it easier for us and help us address your ticket quicker.

Trac is not a support forum, please use the boxbackup@… list if you need help. Please do not enter discussions in a ticket, follow up to the boxbackup-dev@… list instead.