[Pkg-telepathy-maintainers] Bug#448625: telepathy-mission-control: mc-account lacks a man page

[Simon McVittie]

Package: telepathy-mission-control
Version: 4.42-1
Severity: minor
Tags: patch

[I'm a maintainer, but filing a bug for the sake of the NM process...]

The mc-account utility in Mission Control doesn't have a man page. I
attach one.

mission-control itself doesn't have a man page either, but it's not
really meant to be run by users, except to debug (it should really move
to /usr/libexec on distros that have it, or somewhere in /usr/lib on
Debian). I attach a template man page (it's a .in file which expects
@libexecdir@ to be substituted, because I suspect that's the format that
will be most useful upstream).

I'll submit both of these upstream.

    Simon
-------------- next part --------------
.TH MC-ACCOUNT "1" "October 2007" "Telepathy" "User Commands"
.SH NAME
mc-account \- set Telepathy account parameters for Mission Control
.SH SYNOPSIS
\fBmc-account\fR \fBlist\fR
.PP
\fBmc-account\fR \fBadd\fR \fIprofile\fR \fIdisplay-name\fR \fBstring:account\fR=\fIuser\fR [\fBstring:password\fR=\fBpassword\fR] [(\fBint\fR|\fBbool\fR|\fBstring\fR)\fB:\fR\fIkey\fR\fB=\fR\fIvalue\fR...]
.PP
\fBmc-account\fR \fBset\fR \fIaccount-name\fR (\fBint\fR|\fBbool\fR|\fBstring\fR)\fB:\fR\fIkey\fR\fB=\fR\fIvalue\fR [...]
.PP
\fBmc-account\fR \fBdisplay\fR \fraccount-name\fR \fIdisplay-name\fR
.PP
\fBmc-account\fR \fBshow\fR \fraccount-name\fR
.PP
\fBmc-account\fR \fBenable\fR \fraccount-name\fR
.PP
\fBmc-account\fR \fBdisable\fR \fraccount-name\fR
.PP
\fBmc-account\fR \fBdelete\fR \fraccount-name\fR
.SH DESCRIPTION
mc-account manipulates configured Telepathy accounts in Nokia's Mission Control
via a command-line interface.
.PP
If available, consider using the
.BR empathy-accounts (1)
graphical user interface instead.
.SH COMMANDS
.TP
\fBmc-account\fR \fBlist\fR
List configured accounts and their displayed names.

.TP
\fBmc-account\fR \fBadd\fR \fIprofile\fR \fIdisplay-name\fR \fBstring:account\fR=\fIuser\fR [\fBstring:password\fR=\fBpassword\fR] [(\fBint\fR|\fBbool\fR|\fBstring\fR)\fB:\fR\fIkey\fR\fB=\fR\fIvalue\fR...]
Add a new account. Almost all profiles will need the \fIaccount\fR and
\fIpassword\fR parameters; some profiles may have additional required
parameters.

.TP
\fBmc-account\fR \fBset\fR \fIaccount-name\fR (\fBint\fR|\fBbool\fR|\fBstring\fR)\fB:\fR\fIkey\fR\fB=\fR\fIvalue\fR [...]
Change an account's parameters.

.TP
\fBmc-account\fR \fBdisplay\fR \fraccount-name\fR \fIdisplay-name\fR
Set the displayed name for an account.

.TP
\fBmc-account\fR \fBshow\fR \fraccount-name\fR
Show details of the given account.

.TP
\fBmc-account\fR \fBenable\fR \fraccount-name\fR
Enable the given account. mission-control will connect to it.

.TP
\fBmc-account\fR \fBdisable\fR \fraccount-name\fR
Disable the given account. mission-control will disconnect from it.

.TP
\fBmc-account\fR \fBdelete\fR \fraccount-name\fR
Delete the given account from mission-control.

.SH "SEE ALSO"
.BR empathy-accounts (1),
\fIhttp://telepathy.freedesktop.org/\fR
-------------- next part --------------
.TH MISSION-CONTROL "8" "October 2007" "Telepathy" "D-Bus services"
.SH NAME
mission-control \- Telepathy account management daemon
.SH SYNOPSIS
\fB at libexecdir@/mission\-control\fR
.SH DESCRIPTION
\fBmission\-control\fR (also known as NMC, for Nokia Mission Control) is a
Telepathy component providing a way for "end-user" applications to
abstract some of the details of connection managers, to provide a simple
way to manipulate a bunch of connection managers at once, and to remove
the need to have in each program the account definitions and credentials.
It is used by Telepathy user interfaces such as
.BR empathy (1)
and the chat UI on Nokia's Maemo-based internet tablets.
.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 SEE ALSO
.IR http://mission-control.sourceforge.net/ ,
.IR http://telepathy.freedesktop.org/ ,
.IR http://telepathy.freedesktop.org/wiki/CategoryGabble ,
.BR empathy (1)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 266 bytes
Desc: Digital signature
Url : http://lists.alioth.debian.org/pipermail/pkg-telepathy-maintainers/attachments/20071030/ff5763a0/attachment.pgp