write man page masters in DocBook XML

The troff man pages will still be checked into the tree but the
source is DocBook XML format living in the docs/ directory now.
Start with the easy ones, the main udev page is still left to
rewrite.

Signed-off-by: Kay Sievers <kay.sievers@suse.de>

1 files changed, 39 insertions, 41 deletions

diff --git a/udevd.8 b/udevd.8
index 02e2e2c5f8..01b90ccfb3 100644
--- a/udevd.8
+++ b/udevd.8
@@ -1,43 +1,41 @@
-.TH UDEVD 8 "February 2004" "" "Linux Administrator's Manual"
-.SH NAME
-udevd, udevdsend \- udev event serializer daemon and udev event sender
-.SH SYNOPSIS
-.BI udevsend
+.\" ** You probably do not want to edit this file directly **
+.\" It was generated using the DocBook XSL Stylesheets (version 1.69.0).
+.\" Instead of manually editing it, you probably should edit the DocBook XML
+.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
+.TH "UDEVD" "8" "August 2005" "udev" "udevd, udevsend, udevcontrol"
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+udevd \- event managing daemon
+.SH "SYNOPSIS"
+.HP 6
+\fBudevd\fR [\fB\-\-daemon\fR]
+.HP 20
+\fBudevcontrol \fR\fB\fIcommand\fR\fR
+.HP 19
+\fBudevsend \fR\fB\fIsubsystem\fR\fR
 .SH "DESCRIPTION"
-.B udevd
-allows the serialization of
-.BR hotplug (8)
-events. The events generated by the kernel may arrive in random order
-in userspace, that makes it neccessary to reorder them.
-.br
-.B udevd
-takes care of the kernel supplied
-.B SEQNUM
-sequence number and arranges the events for execution in the correct order.
-Missing sequences delay the execution of the following events until a timeout
-is reached. Events without any sequence number are bypassing the queue and
-will be executed immediately.
-.br
-For each event a
-.BR udev (8)
-instance is executed in the background with the complete environment received
-by the hotplug event. All further events for the same device are delayed until
-the execution is finished. This way there will never be more than one instance
-running for a single device at the same time.
-.br
-.B udevd
-receives the events from
-.B udevsend
-If
-.B udevd
-isn't already running,
-.B udevsend
-will start it.
+.PP
+udevd listens to kernel uevents and passes the incoming events to udev. It ensures the right event order and takes care, that events for child devices are delayed until the parent has finished the device handling.
+.SH "OPTIONS"
+.TP
+\fB\-\-daemon\fR
+Detach and run in the background.
+.TP
+\fBlog_priority=\fR\fB\fIvalue\fR\fR
+udevcontrol can dynamically set the log level of udevd. Valid values are the numerical syslog priorities or their textual representations: err, info and debug.
+.TP
+\fBstop_exec_queue\fR
+udevcontrol stops the execution of events from udevd.
+.TP
+\fBstart_exec_queue\fR
+udevcontrol starts the execution of events from udevd.
+.SH "AUTHOR"
+.PP
+Written by Kay Sievers 
+<kay.sievers@vrfy.org>.
 .SH "SEE ALSO"
-.BR udev (8),
-.BR udevinfo (8),
-.BR hotplug (8)
-.SH AUTHORS
-.B udevd
-was developed primarily by Kay Sievers <kay.sievers@vrfy.org>, with much help
-from others.
+.PP
+\fBudev\fR(8)