From: Lennart Poettering <lennart@poettering.net>
Date: Sun, 16 May 2010 23:39:51 +0000 (+0200)
Subject: docs: add terse distribution porting guide
X-Git-Tag: 0.git+20100605+dfd8ee-1~13^2~3^2~3
X-Git-Url: https://err.no/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=eb10a76494542fb560efd09c16b40826fc37bc5f;p=systemd

docs: add terse distribution porting guide
---

diff --git a/DISTRO_PORTING b/DISTRO_PORTING
new file mode 100644
index 00000000..41905383
--- /dev/null
+++ b/DISTRO_PORTING
@@ -0,0 +1,36 @@
+Porting systemd To New Distributions
+
+        You need to make the follow changes to adapt systemd to your
+        distribution:
+
+        0) Make your distribution recognized via the autoconf checks
+        in configure.ac. Grep for the word "fedora" (case
+        insensitively) and you should be able to find the places where
+        you need to add/change things.
+
+        1) Patch src/hostname-setup.c so that systemd knows where to
+        read your host name from.
+
+        2) Check the unit files in units/ if they match your
+        distribution. Most likely you will have to make additions to
+        units/*.m4 and create a copy of units/fedora/ with changes for
+        your distribution.
+
+        3) Adjust Makefile.am to register the unit files you added in
+        step 2. Also you might need to update the m4 invocation in
+        Makefile.am. Grep for the word "fedora" (case insensitively)
+        and you should be able to find the places where you need to
+        add/change things.
+
+        4) Try it out.
+
+CONTRIBUTING UPSTREAM:
+
+        We are interested in merging your changes upstream, if they
+        are for a big, and well-known distribution. Unfortunately we
+        don't have the time and resources to maintain
+        distribution-specific patches for all distributions on the
+        planet, hence please do not send us patches that adds systemd
+        support to non-mainstream or niche distributions.
+
+        Thank you for understanding.
diff --git a/Makefile.am b/Makefile.am
index 973c08e4..683a00bc 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -102,7 +102,8 @@ EXTRA_DIST = \
 	units/systemd-logger.service.in \
 	units/syslog.target.in \
 	LICENSE \
-	README
+	README \
+	DISTRO_PORTING
 
 if TARGET_FEDORA
 dist_systemunit_DATA += \