[telepathy-mission-control/master] Add a man page for the mission-control-5 daemon

[Simon McVittie]

---
 .gitignore                    |    1 +
 server/Makefile.am            |   11 +++++++++--
 server/mission-control-5.8.in |   32 ++++++++++++++++++++++++++++++++
 3 files changed, 42 insertions(+), 2 deletions(-)
 create mode 100644 server/mission-control-5.8.in

diff --git a/.gitignore b/.gitignore
index d12fd54..b346dd0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -65,6 +65,7 @@ mission-control.pc
 patches/
 stamp-*
 /server/mission-control-5
+/server/mission-control-5.8
 /server/org.freedesktop.Telepathy.AccountManager.service
 /server/org.freedesktop.Telepathy.MissionControl5.service
 tags
diff --git a/server/Makefile.am b/server/Makefile.am
index 3151a20..eab3b03 100644
--- a/server/Makefile.am
+++ b/server/Makefile.am
@@ -7,9 +7,11 @@ INCLUDES = $(DBUS_CFLAGS) $(TELEPATHY_CFLAGS) -I$(top_srcdir) \
 if HAVE_SERVER
 
 EXTRA_DIST = org.freedesktop.Telepathy.MissionControl5.service.in \
-	     org.freedesktop.Telepathy.AccountManager.service.in
+	     org.freedesktop.Telepathy.AccountManager.service.in \
+	     mission-control-5.8.in
 CLEANFILES = org.freedesktop.Telepathy.MissionControl5.service \
-	     org.freedesktop.Telepathy.AccountManager.service
+	     org.freedesktop.Telepathy.AccountManager.service \
+	     mission-control-5.8
 
 servicefiledir=$(prefix)/share/dbus-1/services
 servicefile_DATA=org.freedesktop.Telepathy.MissionControl5.service \
@@ -18,6 +20,11 @@ servicefile_DATA=org.freedesktop.Telepathy.MissionControl5.service \
 %.service: %.service.in Makefile
 	sed -e 's![@]libexecdir[@]!$(libexecdir)!' $< > $@
 
+man8_MANS = mission-control-5.8
+
+%.8: %.8.in Makefile
+	sed -e 's![@]libexecdir[@]!$(libexecdir)!' $< > $@
+
 libexec_PROGRAMS = mission-control-5
 mission_control_5_SOURCES = mc-server.c
 mission_control_5_LDADD = $(top_builddir)/src/libmissioncontrol-server.la
diff --git a/server/mission-control-5.8.in b/server/mission-control-5.8.in
new file mode 100644
index 0000000..782e88a
--- /dev/null
+++ b/server/mission-control-5.8.in
@@ -0,0 +1,32 @@
+.TH MISSION-CONTROL-5 "8" "July 2009" "Telepathy" "D-Bus services"
+\" Copyright © 2009 Collabora Ltd. <http://www.collabora.co.uk/>
+\" This document may be distributed under the same terms as
+\" telepathy-mission-control itself.
+.SH NAME
+mission-control-5 \- Telepathy account manager/chanel dispatcher
+.SH SYNOPSIS
+\fB at libexecdir@/mission\-control\-5\fR
+.SH DESCRIPTION
+Mission Control 5 implements the AccountManager and ChannelDispatcher services
+described in the Telepathy D-Bus specification, allowing clients like
+.BR empathy (1)
+to store account details, connect to accounts, request communication channels,
+and have channels dispatched to them.
+.PP
+It is a D-Bus service which runs on the session bus, and should usually be
+started automatically by D-Bus activation. However, it might be useful to
+start it manually for debugging.
+.SH OPTIONS
+There are no command-line options.
+.SH ENVIRONMENT
+.TP
+\fBMC_DEBUG\fR=\fIlevel\fR
+May be set to 1 or 2 to enable partial or full debug output from Mission
+Control itself.
+.TP
+\fBMC_TP_DEBUG\fR=\fItype\fR
+May be set to "all" for full debug output from telepathy-glib, or various
+undocumented options (which may change from telepathy-glib release to release)
+to filter the output. See telepathy-glib source code for the available options.
+.SH SEE ALSO
+.IR http://telepathy.freedesktop.org/
-- 
1.5.6.5