holgersson-overlay/README.rst

81 lines
2.4 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.. Title: Readme for holgersson-overlay
.. Author: Nils Freydank <holgersson [ascii-symbol-64] posteo [ascii-symbol-46] de>
Main
====
This is my private and unofficial overlay_ for Gentoo/Linux.
There will be different ebuilds from different sources, hopefully only temporary
before submitting to the `main Gentoo bugtracker`_ resp. to the `main portage tree`_.
Setup and synchronisation
=========================
There are several possible ways of adding this overlay:
Adding the overlay manually
---------------------------
You can clone the repository and create `/etc/portage/repos.conf/holgersson-overlay.conf`
with the following contents:
.. code-block:: ini
[holgersson-overlay]
priority = 50
location = /path/to/local/holgersson-overlay
sync-type = git
sync-uri = https://github.com/gentoo-mirror/holgersson-overlay.git
Using eselect-repository
------------------------
Run eselect repository:
.. code:: shell
$ eselect repository enable holgersson-overlay
Using layman
------------
Run layman from `app-portage/layman`:
.. code:: shell
$ layman -a holgersson-overlay
and optional for global updates:
.. code-block:: shell
$ layman -S
$ emerge --sync
You might want to set `USE="sync-plugin-portage"` for layman, too.
Maintainer
==========
If you encounter bugs, please send a mail to
**holgersson [ascii-symbol-64] posteo [ascii-symbol-46] de**
or open a bug report on the `main Gentoo bugtracker`_
(please remember to Cc me there). Bug descriptions, suggestions, patches,
critics and chorus of praise are all welcome!
GPG key ID: **0x00EF D31F 1B60 D5DB ADB8 31C1 C0EC E696 0E54 475B**
License and copying
===================
- The contents of this document are licensed under the `CC-BY-SA-3.0 license`. The ebuilds are licensed under the `GNU General Public License v2` for compability with the main Gentoo/portage tree.
- Source files might have different licenses; these should be outlined in the ebuilds themselves.
- The licenses are choosen to fit into the main gentoo licenses pool; if you suggest other licenses, or think Im mistaken in the licenses I indicate anywhere please contact the maintainer (see the resp. section above)!
.. _overlay: https://git.holgersson.xyz/holgersson-overlay
.. _`main Gentoo bugtracker`: https://bugs.gentoo.org
.. _`main portage tree`: https://packages.gentoo.org/
.. vim:fileencoding=utf-8:ts=4:syntax=rst:colorcolumn=81