update TODO

[elogind.git] / man / systemd.unit.xml

diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index dddcf09e3dc343573f9446d2a48a85b38b50dc7e..1afa600a08fac4434a77a50cff86a582b821e7f1 100644 (file)
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -211,6 +211,10 @@
                 template <literal>.d/</literal> subdirectory and reads
                 its <literal>.conf</literal> files.</para>
 
+                <!-- Note that we do not document .include here, as we
+                     consider it mostly obsolete, and want people to
+                     use .d/ drop-ins instead. -->
+
                 <para>Note that while systemd offers a flexible
                 dependency system between units it is recommended to
                 use this functionality only sparingly and instead rely
@@ -1552,6 +1556,16 @@
                     </tbody>
                   </tgroup>
                 </table>
+
+               <para>Please note that specifiers
+               <literal>%U</literal>, <literal>%h</literal>,
+               <literal>%s</literal> are mostly useless when systemd
+               is running in system mode.  PID 1 cannot query the
+               user account database for information, so the
+               specifiers only work as shortcuts for things which are
+               already specified in a different way in the unit
+               file. They are fully functional when systemd is
+               running in <option>--user</option> mode.</para>
         </refsect1>
 
         <refsect1>