Promote the marshalling format to a top-level section

[platform/upstream/dbus.git] / doc / dbus-uuidgen.1

diff --git a/doc/dbus-uuidgen.1 b/doc/dbus-uuidgen.1
index 480fd18..8ed8dd2 100644 (file)
--- a/doc/dbus-uuidgen.1
+++ b/doc/dbus-uuidgen.1
@@ -1,36 +1,36 @@
 .\" 
 .\" 

-.\" dbus-uuidgen manual page.
+.\" dbus\-uuidgen manual page.

 .\" Copyright (C) 2006 Red Hat, Inc.
 .\"
 .\" Copyright (C) 2006 Red Hat, Inc.
 .\"

-.TH dbus-uuidgen 1
+.TH dbus\-uuidgen 1

 .SH NAME
 .SH NAME

-dbus-uuidgen \- Utility to generate UUIDs
+dbus\-uuidgen \- Utility to generate UUIDs

 .SH SYNOPSIS
 .PP
 .SH SYNOPSIS
 .PP

-.B dbus-uuidgen [\-\-version] [\-\-ensure[=FILENAME]] [\-\-get[=FILENAME]]
+.B dbus\-uuidgen [\-\-version] [\-\-ensure[=FILENAME]] [\-\-get[=FILENAME]]

 
 .SH DESCRIPTION
 
 
 .SH DESCRIPTION
 

-The \fIdbus-uuidgen\fP command generates or reads a universally unique ID.
+The \fIdbus\-uuidgen\fP command generates or reads a universally unique ID.

 
 .PP
 
 .PP

-Note that the D-Bus UUID has no relationship to RFC 4122 and does not generate
+Note that the D\-Bus UUID has no relationship to RFC 4122 and does not generate

 UUIDs compatible with that spec. Many systems have a separate command
 for that (often called "uuidgen").
 
 .PP
 See http://www.freedesktop.org/software/dbus/ for more information
 UUIDs compatible with that spec. Many systems have a separate command
 for that (often called "uuidgen").
 
 .PP
 See http://www.freedesktop.org/software/dbus/ for more information

-about D-Bus.
+about D\-Bus.

 
 .PP
 
 .PP

-The primary usage of \fIdbus-uuidgen\fP is to run in the post-install
-script of a D-Bus package like this:
+The primary usage of \fIdbus\-uuidgen\fP is to run in the post\-install
+script of a D\-Bus package like this:

 .nf
 .nf

-  dbus-uuidgen --ensure
+  dbus\-uuidgen \-\-ensure

 .fi
 
 .PP
 .fi
 
 .PP

-This will ensure that /var/lib/dbus/machine-id exists and has the uuid in it.
+This will ensure that /var/lib/dbus/machine\-id exists and has the uuid in it.

 It won't overwrite an existing uuid, since this id should remain fixed
 for a single machine until the next reboot at least.
 
 It won't overwrite an existing uuid, since this id should remain fixed
 for a single machine until the next reboot at least.
 


@@ -43,15 +43,15 @@ sockets, local X displays, localhost.localdomain resolution, process
 IDs, and so forth.
 
 .PP
 IDs, and so forth.
 
 .PP

-If you run \fIdbus-uuidgen\fP with no options it just prints a new uuid made
+If you run \fIdbus\-uuidgen\fP with no options it just prints a new uuid made

 up out of thin air.
 
 .PP
 up out of thin air.
 
 .PP

-If you run it with --get, it prints the machine UUID by default, or
+If you run it with \-\-get, it prints the machine UUID by default, or

 the UUID in the specified file if you specify a file.
 
 .PP
 the UUID in the specified file if you specify a file.
 
 .PP

-If you try to change an existing machine-id on a running system, it will
+If you try to change an existing machine\-id on a running system, it will

 probably result in bad things happening. Don't try to change this file. Also,
 don't make it the same on two different systems; it needs to be different
 anytime there are two different kernels running.
 probably result in bad things happening. Don't try to change this file. Also,
 don't make it the same on two different systems; it needs to be different
 anytime there are two different kernels running.


@@ -63,27 +63,27 @@ because there are two different kernels.
 .SH OPTIONS
 The following options are supported:
 .TP
 .SH OPTIONS
 The following options are supported:
 .TP

-.I "--get[=FILENAME]"
-If a filename is not given, defaults to localstatedir/lib/dbus/machine-id
+.I "\-\-get[=FILENAME]"
+If a filename is not given, defaults to localstatedir/lib/dbus/machine\-id

 (localstatedir is usually /var). If this file exists and is valid, the
 uuid in the file is printed on stdout. Otherwise, the command exits 
 with a nonzero status.
 
 .TP
 (localstatedir is usually /var). If this file exists and is valid, the
 uuid in the file is printed on stdout. Otherwise, the command exits 
 with a nonzero status.
 
 .TP

-.I "--ensure[=FILENAME]"
-If a filename is not given, defaults to localstatedir/lib/dbus/machine-id
+.I "\-\-ensure[=FILENAME]"
+If a filename is not given, defaults to localstatedir/lib/dbus/machine\-id

 (localstatedir is usually /var). If this file exists then it will be
 validated, and a failure code returned if it contains the wrong thing.
 If the file does not exist, it will be created with a new uuid in it.
 On success, prints no output.
 
 .TP
 (localstatedir is usually /var). If this file exists then it will be
 validated, and a failure code returned if it contains the wrong thing.
 If the file does not exist, it will be created with a new uuid in it.
 On success, prints no output.
 
 .TP

-.I "--version"
-Print the version of dbus-uuidgen
+.I "\-\-version"
+Print the version of dbus\-uuidgen

 
 .SH AUTHOR
 See http://www.freedesktop.org/software/dbus/doc/AUTHORS
 
 .SH BUGS
 
 .SH AUTHOR
 See http://www.freedesktop.org/software/dbus/doc/AUTHORS
 
 .SH BUGS

-Please send bug reports to the D-Bus mailing list or bug tracker,
+Please send bug reports to the D\-Bus mailing list or bug tracker,

 see http://www.freedesktop.org/software/dbus/
 see http://www.freedesktop.org/software/dbus/