chiark / gitweb /
update TODO
[elogind.git] / DISTRO_PORTING
index 4190538..2b08bf8 100644 (file)
@@ -1,5 +1,6 @@
 Porting systemd To New Distributions
 
+HOWTO:
         You need to make the follow changes to adapt systemd to your
         distribution:
 
@@ -9,7 +10,8 @@ Porting systemd To New Distributions
         you need to add/change things.
 
         1) Patch src/hostname-setup.c so that systemd knows where to
-        read your host name from.
+        read your host name from. You might also want to update
+        status_welcome() in util.c.
 
         2) Check the unit files in units/ if they match your
         distribution. Most likely you will have to make additions to
@@ -22,15 +24,35 @@ Porting systemd To New Distributions
         and you should be able to find the places where you need to
         add/change things.
 
-        4) Try it out.
+        4) Try it out. Play around with 'systemd --test --system' for
+        a test run of systemd without booting. This will read the unit
+        files and print the initial transaction it would execute
+        during boot-up. This will also inform you about ordering loops
+        and suchlike.
 
 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.
+        planet, hence please do not send us patches that add systemd
+        support for non-mainstream or niche distributions.
 
         Thank you for understanding.
+
+BE CONSIDERATE:
+        We'd like to keep differences between the distributions
+        minimal. This both simplifies our maintenance work, as well
+        as it helps administrators to move from one distribution to
+        another.
+
+        Hence we'd like to ask you to keep your changes minimal, and
+        not rename any units without a very good reason (if you need a
+        particular name for compatibility reasons, consider using
+        alias names via symlinks). Before you make changes that change
+        semantics from upstream, please talk to us!
+
+        In SysV almost every distribution uses a different
+        nomenclature and different locations for the boot-up
+        scripts. We'd like to avoid chaos like that with systemd right
+        from the beginning. So please, be considerate!