src_prepare-overlay/README.md

114 lines
4.1 KiB
Markdown
Raw Normal View History

# src_prepare Gentoo overlay
2020-07-27 22:22:27 +02:00
<p align="center">
<a href="https://gitlab.com/src_prepare/src_prepare-overlay/pipelines">
2020-08-11 04:57:55 +02:00
<img src="https://gitlab.com/src_prepare/src_prepare-overlay/badges/master/pipeline.svg">
2020-07-27 22:22:27 +02:00
</a>
<a href="https://gitlab.com/src_prepare/src_prepare-overlay/">
<img src="https://gitlab.com/src_prepare/badge/-/raw/master/hosted_on-gitlab-orange.svg">
</a>
2020-07-27 22:22:27 +02:00
<a href="https://gentoo.org/">
2020-08-11 04:57:55 +02:00
<img src="https://gitlab.com/src_prepare/badge/-/raw/master/powered-by-gentoo-linux-tyrian.svg">
2020-07-27 22:22:27 +02:00
</a>
2020-08-11 04:57:55 +02:00
<a href="./LICENSE">
<img src="https://gitlab.com/src_prepare/badge/-/raw/master/license-gplv2-blue.svg">
2020-07-27 22:22:27 +02:00
</a>
2020-07-27 22:46:19 +02:00
<a href="https://app.element.io/#/room/#src_prepare:matrix.org">
<img src="https://gitlab.com/src_prepare/badge/-/raw/master/chat-matrix-green.svg">
2020-07-27 22:22:27 +02:00
</a>
<a href="https://gitlab.com/src_prepare/src_prepare-overlay/commits/master.atom">
2020-08-11 04:57:55 +02:00
<img src="https://gitlab.com/src_prepare/badge/-/raw/master/feed-atom-orange.svg">
2020-07-27 22:22:27 +02:00
</a>
</p>
# About
2019-12-27 22:21:49 +01:00
2020-05-14 03:13:05 +02:00
This is the overlay of our Matrix group where we talk about topics related to Gentoo (development, maintainance, support, communities and more).
2019-12-27 22:21:49 +01:00
2020-09-16 05:27:39 +02:00
**WARNING: Do not expect high quality ebuilds!** While we do the best we can, most of us are still learning. Read [WARNING.md](./WARNING.md) for more information.
2019-12-27 22:21:49 +01:00
2020-02-08 23:12:03 +01:00
## Why create this overlay?
2019-12-27 22:21:49 +01:00
Mostly to have fun.
## For whom?
2020-09-06 01:47:23 +02:00
src_prepare overlay is based on the concept of the [GURU](https://wiki.gentoo.org/wiki/Project:GURU) project: to create a repository maintained collaboratively by Gentoo users, for Gentoo users.
Despite being based on the concept of the GURU project, src_prepare has different goals in mind:
2020-09-06 03:26:23 +02:00
- main git repository is hosted on [GitLab](https://gitlab.com/src_prepare/src_prepare-overlay), with mirrors set to [GitHub](https://github.com/xgqt/src_prepare-overlay) and [Codeberg](https://codeberg.org/src_prepare/src_prepare-overlay);
- easier for one to get access to the `master` branch;
- main contact with the src_prepare project is via [[matrix]](https://matrix.to/#/#src_prepare:matrix.org);
- more freedom in creating ebuilds;
- no requirement for GPG keys;
2020-09-06 18:37:28 +02:00
- no requirement for private info.
2020-09-06 01:47:23 +02:00
The src_prepare project doesn't want to overtake or compete with the GURU project. The GURU project is aimed on professionalism and quality, whereas src_prepare is aimed on openness and ease of access.
## Adding the overlay
2019-12-27 22:21:49 +01:00
### Official list
2020-02-08 23:12:03 +01:00
#### Layman
If you are using [Layman](https://wiki.gentoo.org/wiki/Layman), execute:
2020-02-25 20:27:20 +01:00
``` sh
layman -a src_prepare-overlay
```
2020-02-08 23:12:03 +01:00
#### eselect-repository
2020-02-08 23:12:03 +01:00
If you are using [eselect-repository](https://wiki.gentoo.org/wiki/Eselect/Repository), execute:
2020-02-25 20:27:20 +01:00
``` sh
eselect repository enable src_prepare-overlay
```
### Manual
2019-12-27 22:21:49 +01:00
2020-02-08 23:12:03 +01:00
If you want to manually add the overlay, see [examples/repos.conf/src_prepare-overlay.conf](https://gitlab.com/src_prepare/src_prepare-overlay/blob/master/examples/repos.conf/src_prepare-overlay.conf).
#### Layman
2020-02-08 23:12:03 +01:00
If you are using [Layman](https://wiki.gentoo.org/wiki/Layman), execute:
2020-02-25 20:27:20 +01:00
``` sh
layman -o 'https://gitlab.com/src_prepare/src_prepare-overlay/raw/master/repositories.xml' -f -a src_prepare-overlay
```
#### eselect-repository
If you are using [eselect-repository](https://wiki.gentoo.org/wiki/Eselect/Repository), execute:
``` sh
eselect repository add src_prepare-overlay git https://gitlab.com/src_prepare/src_prepare-overlay
```
2019-12-27 22:21:49 +01:00
## How do I sync this?
2020-02-08 23:12:03 +01:00
Execute:
2020-02-25 20:27:20 +01:00
``` sh
emaint sync -r src_prepare-overlay
```
2019-12-27 22:21:49 +01:00
## It says the ebuild is masked, what do I do?
2020-02-08 23:12:03 +01:00
See [examples/package.accept_keywords/src_prepare-overlay](https://gitlab.com/src_prepare/src_prepare-overlay/blob/master/examples/package.accept_keywords/src_prepare-overlay).
2019-12-27 22:21:49 +01:00
# Submitting an Issue
2020-12-27 19:25:27 +01:00
### Ebuild error
[Our issue tracker is located in our **GitLab** repository.](https://gitlab.com/src_prepare/src_prepare-overlay/-/issues) If an ebuild appears to produce an error, please report it in our GitLab repository.
# Contributing
2020-04-03 18:18:53 +02:00
We appreciate and encourage for contribution. If you want a specific package or want to create a package for us to maintain, see [CONTRIBUTING.md](/CONTRIBUTING.md).