[systemd-commits] 2 commits - docs/gudev man/udev.xml TODO

[Kay Sievers]

 TODO                      |   13 ++++++----
 docs/gudev/gudev-docs.xml |   56 ++--------------------------------------------
 man/udev.xml              |   12 +++++++--
 3 files changed, 20 insertions(+), 61 deletions(-)

New commits:
commit b45f770f0049fbdf3f6c9db0ab11deeff4ccd86d
Author: Kay Sievers <kay at vrfy.org>
Date:   Sat Apr 14 21:53:26 2012 +0200

    udev: clarify man page regarding starting dameons

diff --git a/TODO b/TODO
index 12ce158..48591e4 100644
--- a/TODO
+++ b/TODO
@@ -19,17 +19,20 @@ Features:
 
 * cg_create_and_attach() should fail for non-available controllers
 
-* make gtk-doc optional (like kmod?)
+* udevd: SIGKILL all non-udevd processes in udev.service cgroup when entering idle
+  (the time to be able start services from udev rules is over on systemd systems)
 
-* udev: find a way to tell udev to not cancel firmware requests in initramfs
+* udev: remove /sys and /dev configurability
 
-* udev: scsi_id -> sg3_utils?
+* udev: find a way to tell udev to not cancel firmware requests when running in initramfs
 
-* udev: add trigger --subsystem-match=usb/usb_device
+* udev: scsi_id -> sg3_utils -> kill scsi_id
+
+* udev: add trigger --subsystem-match=usb/usb_device device
 
 * udev: libudev.so.1
-  - remove deprecated symbols
   - use symbol versioning
+  - remove deprecated symbols
   - return object with *_unref()
   - kill: udev_monitor_from_socket()
   - kill: udev_queue_get_failed_list_entry()
diff --git a/man/udev.xml b/man/udev.xml
index 1012866..417fb11 100644
--- a/man/udev.xml
+++ b/man/udev.xml
@@ -287,6 +287,8 @@
             successfully. The device properties are made available to the
             executed program in the environment. The program's stdout
             is available in the RESULT key.</para>
+            <para>This can only be used for very short-running foreground tasks. For details
+            see <option>RUN</option>.</para>
           </listitem>
         </varlistentry>
 
@@ -401,10 +403,12 @@
             /usr/lib/udev, otherwise the absolute path must be specified. The program
             name and following arguments are separated by spaces. Single quotes can
             be used to specify arguments with spaces.</para>
-            <para>This can only be used for very short running tasks. Running an
+            <para>This can only be used for very short-running foreground tasks. Running an
             event process for a long period of time may block all further events for
-            this or a dependent device. Starting daemons or other long running processes
-            is not appropriate for udev.</para>
+            this or a dependent device.</para>
+            <para>Starting daemons or other long running processes is not appropriate
+            for udev; the forked processes, detached or not, will be unconditionally
+            killed after the event handling has finished.</para>
           </listitem>
         </varlistentry>
 
@@ -470,6 +474,8 @@
                 </listitem>
               </varlistentry>
             </variablelist>
+            <para>This can only be used for very short-running foreground tasks. For details
+            see <option>RUN</option>.</para>
           </listitem>
         </varlistentry>
 

commit 4090d4ca12f687852e9434272e36909760a222d3
Author: Kay Sievers <kay at vrfy.org>
Date:   Sat Apr 14 21:23:36 2012 +0200

    gudev: gtk-doc - hide licence stuff which consumes three-fourths of the index page

diff --git a/docs/gudev/gudev-docs.xml b/docs/gudev/gudev-docs.xml
index cf83d14..b40b615 100644
--- a/docs/gudev/gudev-docs.xml
+++ b/docs/gudev/gudev-docs.xml
@@ -8,62 +8,12 @@
   <bookinfo>
     <title>GUDev Reference Manual</title>
     <releaseinfo>For GUdev version &version;</releaseinfo>
-    <authorgroup>
-      <author>
-        <firstname>David</firstname>
-        <surname>Zeuthen</surname>
-        <affiliation>
-          <address>
-            <email>davidz at redhat.com</email>
-          </address>
-        </affiliation>
-      </author>
-      <author>
-        <firstname>Bastien</firstname>
-        <surname>Nocera</surname>
-        <affiliation>
-          <address>
-            <email>hadess at hadess.net</email>
-          </address>
-        </affiliation>
-      </author>
-    </authorgroup>
 
     <copyright>
-      <year>2011</year>
-      <holder>The GUDev Authors</holder>
+      <year>2012</year>
+      <holder>David Zeuthen &lt;davidz at redhat.com&gt;</holder>
+      <holder>Bastien Nocera &lt;hadess at hadess.net&gt;</holder>
     </copyright>
-
-    <legalnotice>
-      <para>
-        Permission is granted to copy, distribute and/or modify this
-        document under the terms of the <citetitle>GNU Free
-        Documentation License</citetitle>, Version 1.1 or any later
-        version published by the Free Software Foundation with no
-        Invariant Sections, no Front-Cover Texts, and no Back-Cover
-        Texts. You may obtain a copy of the <citetitle>GNU Free
-        Documentation License</citetitle> from the Free Software
-        Foundation by visiting <ulink type="http"
-        url="http://www.fsf.org">their Web site</ulink> or by writing
-        to:
-
-        <address>
-          The Free Software Foundation, Inc.,
-          <street>59 Temple Place</street> - Suite 330,
-          <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>,
-          <country>USA</country>
-        </address>
-      </para>
-
-      <para>
-        Many of the names used by companies to distinguish their
-        products and services are claimed as trademarks. Where those
-        names appear in any freedesktop.org documentation, and those
-        trademarks are made aware to the members of the
-        freedesktop.org Project, the names have been printed in caps
-        or initial caps.
-      </para>
-    </legalnotice>
   </bookinfo>
 
   <reference id="ref-API">