103 lines
2.9 KiB
ReStructuredText
103 lines
2.9 KiB
ReStructuredText
.. 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 from `app-eselect/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.
|
||
|
||
Add the distfiles archive to GENTOO_MIRRORS
|
||
-------------------------------------------
|
||
|
||
You may want to optionally add the distfiles mirror of this overlay to your
|
||
GENTOO_MIRRORS configuration in /etc/portage:
|
||
|
||
.. code:: shell
|
||
|
||
GENTOO_MIRRORS="... https://files.holgersson.xyz/gentoo/distfiles/ ..."
|
||
|
||
The distfiles are updated daily using the tool `emirrordist` from portage:
|
||
|
||
.. code:: shell
|
||
|
||
emirrordist --delete --mirror --repo holgersson-overlay --distfiles <path to webroot>
|
||
|
||
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: **0x8AD9 60BB A57A F797 88CC FEC0 3CAA 2CA5 14E4 EE5E**
|
||
|
||
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 I’m 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
|