qubes-doc/developers/source-code.md

49 lines
2.1 KiB
Markdown
Raw Normal View History

2010-04-06 18:49:54 -04:00
---
2015-04-10 16:17:45 -04:00
layout: doc
title: Source Code
permalink: /doc/source-code/
redirect_from:
- /en/doc/source-code/
- /doc/SourceCode/
- /wiki/SourceCode/
2010-04-06 18:49:54 -04:00
---
Qubes Source Code Repositories
==============================
2010-04-06 19:35:50 -04:00
All the Qubes code is kept in GIT repositories. We divided the project into several components, each of which has its own separate repository, some of them:
2010-04-06 19:35:50 -04:00
2014-05-09 11:19:27 -04:00
- `core-admin.git` -- the core Qubes infrastructure responsible for VM management, VM templates, fs sharing, etc.
- `gui-daemon.git` -- GUI virtualization, Dom0 side.
- `gui-agent-linux.git` -- GUI virtualization, Linux VM side.
- `linux-template-builder.git` - scripts and other files used to create Qubes templates images.
2010-04-06 19:35:50 -04:00
You can browse the repositories [online on
GitHub](https://github.com/QubesOS/). The Qubes official repositories are on
this `QubesOS` github account.
2010-04-06 19:35:50 -04:00
To clone a repository:
~~~
git clone git://github.com/QubesOS/<repo_name>.git <repo_name>
~~~
2010-04-07 05:51:32 -04:00
e.g.:
~~~
git clone git://github.com/QubesOS/qubes-core-admin.git core-admin
~~~
2010-04-06 19:35:50 -04:00
## Sending a patch
2015-08-01 14:55:12 -04:00
If you want to contribute to the project, there are two ways:
2015-08-01 14:55:12 -04:00
* **Preferred**: Use github [fork & pull requests](https://guides.github.com/activities/forking/)
* Sending a patch via the project's mailing list (`git format-patch`).
2015-08-01 14:55:12 -04:00
1. Make all the changes in your working directory, i.e. edit files, move them around (you can use 'git mv' for this), etc.
2. Add the changes and commit them (git add, git commit). Never mix different changes into one commit! Write a good description of the commit. The first line should contain a short summary, and then, if you feel like more explanations are needed, enter an empty new line, and then start the long, detailed description (optional).
3. Test your changes NOW: check if RPMs build fine, etc.
4. Create the patch using 'git format-patch'. This has an advantage over 'git diff', because the former will also include your commit message, your name and email, so that \*your\* name will be used as a commit's author.
5. Send your patch to qubes-devel. Start the message subject with the '[PATCH]' string.