-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add README file with package documentation
- Loading branch information
1 parent
028ba5f
commit 6f3dca5
Showing
1 changed file
with
31 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,31 @@ | ||
## What is in this repository? | ||
|
||
This is an [Open Build Service (OBS) Source | ||
Service](https://openbuildservice.org/help/manuals/obs-user-guide/cha.obs.source_service.html) | ||
to allow clang builds for Debian packages. | ||
|
||
An OBS instance using this package to rebuild Debian Unstable packages against | ||
clang is available at [irill8.siege.inria.fr](https://irill8.siege.inria.fr). | ||
|
||
## How to use this package? | ||
|
||
Since this Source Service is supposed to be used in `buildtime` mode, it must be available | ||
to the OBS project as a package (just build this package in your OBS project and make sure | ||
the `Use for Build Flag` is enabled). | ||
|
||
Then, you must activate the source service for the target package. To do so, | ||
read [OBS Source Service | ||
documentation](https://openbuildservice.org/help/manuals/obs-user-guide/cha.obs.source_service.html). | ||
In short, you need to add a `_service` file to the target package working | ||
directory with the following content: | ||
|
||
``` | ||
<services> | ||
<service name="clang_build" mode="buildtime" /> | ||
</services> | ||
``` | ||
|
||
and trigger the target package build. | ||
|
||
Check the build log, searching for `Running build time source services...` to | ||
make sure your source service was triggered. |