Submitting Patches

From ReactOS Wiki
Jump to: navigation, search
This page is probably outdated

ReactOS main repository was moved to GitHub in October 2017. See Commiting Changes for details.
A Wiki Administrator should look at this page and decide or discuss what to do with it.


Since ReactOS does not have a definite maintainer for each section of the code, you should search for a bug report matching the issue you'd like to fix, and perhaps file a new bug in Jira and attach your patch. Set the severity level to major to draw the developers attention to the patch. If you are unsure about something, talk to a developer in the Town Square Mattermost Channel.

Test your patch

Thoroughly check that your change works as intended.

Test your changes with the latest code from GIT. Something may have changed in the latest revision that either breaks your change or causes your change to break something else. Make sure that ReactOS can still boot and that any application or system that may be affected by your change still runs properly.

Preparing the patch

Make sure that your patch is against the latest code from GIT. Where you have made changes to an existing source file, you have to use the diff function of your GIT client to obtain a file that contains only the changes that you have made. If possible, start the diff in root directory to preserve path information of changed files. Please create one patch file only, even for multiple files (new ones as well) as long as they belong to one change.

Also make sure that you have installed an GIT client. The page Subversion – Access the sources gives you more information about getting an GIT client for your operating system.

Then read the section Creating a patch/diff file of the usage page for your GIT client.
All these usage pages are listed here: Subversion – Usage of the SVN clients.

Attaching the patch to the bug report

If your changes are all in one patch file, you can simply attach the patch file to the bug report.

If your changes can't be stored in just one patch file (for example binary files can't be stored in patch files), create a ZIP file containing your new files and attach it to the bug report.

Add the label PATCH to the bug report. If you are unable to edit the label, ask someone to add it for you (Either in Jira or in Mattermost).

Important: provide your real name and e-mail address. Patches from unknown authors are not accepted!

Tracking Patches

Once you submit a patch, you can track it via the "Pending Patches" list.

If you feel like it's taking us a while to review your patch, please don't hesitate to comment on the ticket with that. We are doing our best to review the patches as soon as possible, but we have limited resources so delays can happen unfortunately.

Common mistakes