Initial commit

1 files changed, 61 insertions, 0 deletions

diff --git a/README.html b/README.html
new file mode 100644
index 0000000..f2a791e
--- /dev/null
+++ b/README.html
@@ -0,0 +1,61 @@
+<h1>opentmpfiles</h1>
+<p>
+ This is an overlay voor the Gentoo Linux distribution, it provides ebuilds for
+ opentmpfiles which is about to be removed from the official repository in
+ favor of a systemd version.
+</p>
+<h2>Why this overlay?</h2>
+<p>
+ Gentoo can be -if you want- a systemd-free distro, it is one of the things i
+ like about it. Opentmpfiles is Gentoo's implementation of tmpfiles and it is
+ about to be replaced by the systemd version of tmpfiles. There has been
+ <a href="https://forums.gentoo.org/viewtopic-t-1138687.html">quite some
+ discussion</a> about that and I created this overlay to keep opentmpfiles.
+</p>
+<h2>What is in this overlay?</h2>
+<p>
+ This overlay provides two packages:
+</p>
+<ul>
+ <li>virtual/tmpfiles, modified to only have opentmpfiles</li>
+ <li>sys-apps/opentmpfiles, only modified to have an additional SRC_URI</li>
+</ul>
+<h2>How to use this overlay?</h2>
+<p>
+ First you'll have to clone this overlay on a place you like, a common place
+ these days is <b>/var/db/repos</b>. So cd into that directory and use
+ <b>git clone https://code.pa4wdh.nl.eu.org/gentoo/opentmpfiles</b>, this will
+ create a directory called opentmpfiles with the overlay in it.
+</p>
+<p>
+ Next you have to make portage aware of the repo, for that you'll have to
+ create a config file under <b>/etc/portage/repos.conf</b>. Create a file
+ called <b>opentmpfiles.conf</b> and give it these contents:
+</p>
+<pre>
+[opentmpfiles]
+location = /var/db/repos/opentmpfiles
+sync-type = git
+sync-uri = https://code.pa4wdh.nl.eu.org/gentoo/opentmpfiles
+</pre>
+<p>
+ If you placed the overlay on a different place than <b>/var/db/repos</b> make
+ sure to adapt the <b>location</b> line to your needs.
+</p>
+<p>
+ In the official Gentoo repository the package sys-apps/opentmpfiles is still
+ masked, so you still have to unmask it to be able to use it. Add
+ sys-apps/opentmpfiles to /etc/portage/package.unmask to do that.
+</p>
+<h2>What can i do with this?</h2>
+<p>
+ This overlay will help you to keep opentmpfiles, eliminating an other systemd
+ component from your system.
+</p>
+<p>
+ If you have any feedback on this overlay, you're quite likely to find me on
+ the <a href="https://forums.gentoo.org">Gentoo forums</a>.
+</p>
+<p>
+ Have fun!
+</p>