[Pkg-utopia-commits] r1110 -
packages/experimental/policykit/debian/man
Michael Biebl
biebl at costa.debian.org
Wed Oct 25 22:52:30 UTC 2006
Author: biebl
Date: 2006-10-25 22:52:30 +0000 (Wed, 25 Oct 2006)
New Revision: 1110
Modified:
packages/experimental/policykit/debian/man/polkit-grant-privilege.1
packages/experimental/policykit/debian/man/polkit-is-privileged.1
packages/experimental/policykit/debian/man/polkit-list-privileges.1
packages/experimental/policykit/debian/man/polkit-revoke-privilege.1
packages/experimental/policykit/debian/man/polkitd.8
Log:
Write proper man pages.
Modified: packages/experimental/policykit/debian/man/polkit-grant-privilege.1
===================================================================
--- packages/experimental/policykit/debian/man/polkit-grant-privilege.1 2006-10-25 21:12:33 UTC (rev 1109)
+++ packages/experimental/policykit/debian/man/polkit-grant-privilege.1 2006-10-25 22:52:30 UTC (rev 1110)
@@ -1,59 +1,52 @@
-.\" Hey, EMACS: -*- nroff -*-
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.\" Some roff macros, for reference:
-.\" .nh disable hyphenation
-.\" .hy enable hyphenation
-.\" .ad l left justify
-.\" .ad b justify to both left and right margins
-.\" .nf disable filling
-.\" .fi enable filling
-.\" .br insert line break
-.\" .sp <n> insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
-.TH "POLKIT-GRANT-PRIVILEGE" "1" "August 14, 2006" "David Zeuthen <davidz at redhat.com>" ""
+.TH "POLKIT-GRANT-PRIVILEGE" "1" "October 13, 2006" "David Zeuthen <davidz at redhat.com>" "PolicyKit"
.SH "NAME"
-policykit \- program to do something
+polkit-grant-privilege \- grant privilege for accessing a resource
+
.SH "SYNOPSIS"
.B policykit
-.RI [ options ] " files" ...
-.br
-.B bar
-.RI [ options ] " files" ...
+.RI [ options ]
+.RB \-p
+.I <privilege>
+.RB [\-u
+.IR <user> ]
+.RB [\-r
+.IR <resource> ]
+
.SH "DESCRIPTION"
-This manual page documents briefly the
-.B policykit
-and
-.B bar
-commands.
-.PP
-.\" TeX users may be more comfortable with the \fB<whatever>\fP and
-.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
-.\" respectively.
-\fBpolicykit\fP is a program that...
+.B polkit-grant-privilege
+allows to grant a privilege for accessing a ressource for the given user. The resource may be omitted.
+
.SH "OPTIONS"
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`\-').
A summary of options is included below.
-For a complete description, see the Info files.
.TP
+.B \-u, \-\-user
+User to grant privilege to
+.TP
+.B \-p, \-\-privilege
+Privilege to grant
+.TP
+.B \-r, \-\-resource
+Resource
+.TP
.B \-h, \-\-help
-Show summary of options.
-.TP
-.B \-v, \-\-version
-Show version of program.
+Show summary of options
+.TP
+.B \-v, \-\-verbose
+Verbose operation
+.TP
+.B \-V, \-\-version
+Show version number of the program
+
.SH "SEE ALSO"
-.BR bar (1),
-.BR baz (1).
-.br
-The programs are documented fully by
-.I R "The Rise and Fall of a Fooish Bar" ,
-available via the Info system.
+.BR polkitd (8),
+.BR polkit-revoke-privilege (1),
+.BR polkit-is-privileged (1),
+.BR polkit-list-privileges (1).
+
.SH "AUTHOR"
-policykit was written by <upstream author>.
+policykit was written by David Zeuthen <davidz at redhat.com>.
.PP
-This manual page was written by Michael Biebl <biebl at teco.edu>,
+This manual page was written by Michael Biebl <biebl at debian.org>,
for the Debian project (but may be used by others).
Modified: packages/experimental/policykit/debian/man/polkit-is-privileged.1
===================================================================
--- packages/experimental/policykit/debian/man/polkit-is-privileged.1 2006-10-25 21:12:33 UTC (rev 1109)
+++ packages/experimental/policykit/debian/man/polkit-is-privileged.1 2006-10-25 22:52:30 UTC (rev 1110)
@@ -1,59 +1,57 @@
-.\" Hey, EMACS: -*- nroff -*-
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.\" Some roff macros, for reference:
-.\" .nh disable hyphenation
-.\" .hy enable hyphenation
-.\" .ad l left justify
-.\" .ad b justify to both left and right margins
-.\" .nf disable filling
-.\" .fi enable filling
-.\" .br insert line break
-.\" .sp <n> insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
-.TH "POLKIT-IS-PRIVILEGED" "1" "August 14, 2006" "David Zeuthen <davidz at redhat.com>" ""
+.TH "POLKIT-IS-PRIVILEGED" "1" "October 13, 2006" "David Zeuthen <davidz at redhat.com>" "PolicyKit"
.SH "NAME"
-policykit \- program to do something
+polkit-is-privileged \- query system policy whether a given user is allowed for a given privilege for a given resource
+
.SH "SYNOPSIS"
-.B policykit
-.RI [ options ] " files" ...
-.br
-.B bar
-.RI [ options ] " files" ...
+.B polkit-is-privileged
+.RI [ options ]
+.RB \-u
+.IR <uid>
+.RB \-p
+.IR <privilege>
+.RB [\-r
+.IR <resource> ]
+.RB [\-s
+.IR <system-bus-connection-name> ]
+
.SH "DESCRIPTION"
-This manual page documents briefly the
-.B policykit
-and
-.B bar
-commands.
-.PP
-.\" TeX users may be more comfortable with the \fB<whatever>\fP and
-.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
-.\" respectively.
-\fBpolicykit\fP is a program that...
+.B polkit-is-privileged
+queries system policy whether a given user is allowed for a given privilege for a given resource. The resource may be omitted.
+
.SH "OPTIONS"
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`\-').
A summary of options is included below.
-For a complete description, see the Info files.
-.TP
+.TP
+.B \-u, \-\-user
+Username or user id
+.TP
+.B \-s, \-\-system-bus-unique-name
+Unique system bus connection name
+.TP
+.B \-r, \-\-resource
+Resource
+.TP
+.B \-p, \-\-privilege
+Privilege to test for
+.TP
.B \-h, \-\-help
-Show summary of options.
-.TP
-.B \-v, \-\-version
-Show version of program.
+Show summary of options
+.TP
+.B \-v, \-\-verbose
+Verbose operation
+.TP
+.B \-V, \-\-version
+Show version number of the program
+
.SH "SEE ALSO"
-.BR bar (1),
-.BR baz (1).
-.br
-The programs are documented fully by
-.I R "The Rise and Fall of a Fooish Bar" ,
-available via the Info system.
+.BR polkitd (8),
+.BR polkit-grant-privilege (1),
+.BR polkit-revoke-privilege (1),
+.BR polkit-list-privileges (1).
+
.SH "AUTHOR"
-policykit was written by <upstream author>.
+policykit was written by David Zeuthen <davidz at redhat.com>.
.PP
-This manual page was written by Michael Biebl <biebl at teco.edu>,
+This manual page was written by Michael Biebl <biebl at debian.org>,
for the Debian project (but may be used by others).
Modified: packages/experimental/policykit/debian/man/polkit-list-privileges.1
===================================================================
--- packages/experimental/policykit/debian/man/polkit-list-privileges.1 2006-10-25 21:12:33 UTC (rev 1109)
+++ packages/experimental/policykit/debian/man/polkit-list-privileges.1 2006-10-25 22:52:30 UTC (rev 1110)
@@ -1,59 +1,43 @@
-.\" Hey, EMACS: -*- nroff -*-
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.\" Some roff macros, for reference:
-.\" .nh disable hyphenation
-.\" .hy enable hyphenation
-.\" .ad l left justify
-.\" .ad b justify to both left and right margins
-.\" .nf disable filling
-.\" .fi enable filling
-.\" .br insert line break
-.\" .sp <n> insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
-.TH "POLKIT-LIST-PRIVILEGE" "1" "August 14, 2006" "" "David Zeuthen <davidz at redhat.com>"
+.TH "POLKIT-LIST-PRIVILEGES" "1" "October 13, 2006" "David Zeuthen <davidz at redhat.com>" "PolicyKit"
.SH "NAME"
-policykit \- program to do something
+polkit-list-privileges \- list privileges for a given user
+
.SH "SYNOPSIS"
-.B policykit
-.RI [ options ] " files" ...
-.br
-.B bar
-.RI [ options ] " files" ...
+.B polkit-list-privileges
+.RI [ options ]
+.RB [\-u
+.IR <user> ]
+
.SH "DESCRIPTION"
-This manual page documents briefly the
-.B policykit
-and
-.B bar
-commands.
-.PP
-.\" TeX users may be more comfortable with the \fB<whatever>\fP and
-.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
-.\" respectively.
-\fBpolicykit\fP is a program that...
+.B polkit-list-privileges
+lists the currently assigned privileges for the given user.
+If no user is given, it lists the privileges of the current user.
+
.SH "OPTIONS"
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`\-').
A summary of options is included below.
-For a complete description, see the Info files.
+.TP
+.B \-u, \-\-user
+Username or user id
.TP
.B \-h, \-\-help
-Show summary of options.
-.TP
-.B \-v, \-\-version
-Show version of program.
+Show summary of options
+.TP
+.B \-v, \-\-verbose
+Verbose operation
+.TP
+.B \-V, \-\-version
+Show version number of the program
+
.SH "SEE ALSO"
-.BR bar (1),
-.BR baz (1).
-.br
-The programs are documented fully by
-.I R "The Rise and Fall of a Fooish Bar" ,
-available via the Info system.
+.BR polkitd (8),
+.BR polkit-grant-privilege (1),
+.BR polkit-revoke-privilege (1),
+.BR polkit-is-privileged (1).
+
.SH "AUTHOR"
-policykit was written by <upstream author>.
+policykit was written by David Zeuthen <davidz at redhat.com>.
.PP
-This manual page was written by Michael Biebl <biebl at teco.edu>,
+This manual page was written by Michael Biebl <biebl at debian.org>,
for the Debian project (but may be used by others).
Modified: packages/experimental/policykit/debian/man/polkit-revoke-privilege.1
===================================================================
--- packages/experimental/policykit/debian/man/polkit-revoke-privilege.1 2006-10-25 21:12:33 UTC (rev 1109)
+++ packages/experimental/policykit/debian/man/polkit-revoke-privilege.1 2006-10-25 22:52:30 UTC (rev 1110)
@@ -1,59 +1,53 @@
-.\" Hey, EMACS: -*- nroff -*-
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.\" Some roff macros, for reference:
-.\" .nh disable hyphenation
-.\" .hy enable hyphenation
-.\" .ad l left justify
-.\" .ad b justify to both left and right margins
-.\" .nf disable filling
-.\" .fi enable filling
-.\" .br insert line break
-.\" .sp <n> insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
-.TH "POLKIT-REVOKE-PRIVILEGE" "1" "August 14, 2006" "David Zeuthen <davidz at redhat.com>" ""
+.TH "POLKIT-REVOKE-PRIVILEGE" "1" "October 13, 2006" "David Zeuthen <davidz at redhat.com>" "PolicyKit"
.SH "NAME"
-policykit \- program to do something
+polkit-revoke-privilege \- revoke a privilege for accessing a resource
+
.SH "SYNOPSIS"
-.B policykit
-.RI [ options ] " files" ...
-.br
-.B bar
-.RI [ options ] " files" ...
+.B polkit-revoke-privilege
+.RI [ options ]
+.RB \-p
+.I <privilege>
+.RB [\-u
+.IR <user> ]
+.RB [\-r
+.IR <resource> ]
+
.SH "DESCRIPTION"
-This manual page documents briefly the
-.B policykit
-and
-.B bar
-commands.
-.PP
-.\" TeX users may be more comfortable with the \fB<whatever>\fP and
-.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
-.\" respectively.
-\fBpolicykit\fP is a program that...
+.B polkit-revoke-privilege
+allows to revoke a privilege for accessing a given resource for the given
+user. The resource may be omitted.
+
.SH "OPTIONS"
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`\-').
A summary of options is included below.
-For a complete description, see the Info files.
.TP
+.B \-u, \-\-user
+User to revoke privilege from
+.TP
+.B \-p, \-\-privilege
+Privilege to revoke
+.TP
+.B \-r, \-\-resource
+Resource
+.TP
.B \-h, \-\-help
-Show summary of options.
-.TP
-.B \-v, \-\-version
-Show version of program.
+Show summary of options
+.TP
+.B \-v, \-\-verbose
+Verbose operation
+.TP
+.B \-V, \-\-version
+Show version number of the program
+
.SH "SEE ALSO"
-.BR bar (1),
-.BR baz (1).
-.br
-The programs are documented fully by
-.I R "The Rise and Fall of a Fooish Bar" ,
-available via the Info system.
+.BR polkitd (8),
+.BR polkit-grant-privilege (1),
+.BR polkit-is-privileged (1),
+.BR polkit-list-privileges (1).
+
.SH "AUTHOR"
-policykit was written by <upstream author>.
+policykit was written by David Zeuthen <davidz at redhat.com>.
.PP
-This manual page was written by Michael Biebl <biebl at teco.edu>,
+This manual page was written by Michael Biebl <biebl at debian.org>,
for the Debian project (but may be used by others).
Modified: packages/experimental/policykit/debian/man/polkitd.8
===================================================================
--- packages/experimental/policykit/debian/man/polkitd.8 2006-10-25 21:12:33 UTC (rev 1109)
+++ packages/experimental/policykit/debian/man/polkitd.8 2006-10-25 22:52:30 UTC (rev 1110)
@@ -1,59 +1,45 @@
-.\" Hey, EMACS: -*- nroff -*-
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.\" Some roff macros, for reference:
-.\" .nh disable hyphenation
-.\" .hy enable hyphenation
-.\" .ad l left justify
-.\" .ad b justify to both left and right margins
-.\" .nf disable filling
-.\" .fi enable filling
-.\" .br insert line break
-.\" .sp <n> insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
-.TH "POLKITD" "8" "August 14, 2006" "David Zeuthen <davidz at redhat.com>" ""
+.TH "POLKITD" "8" "October 13, 2006" "David Zeuthen <davidz at redhat.com>" "PolicyKit"
.SH "NAME"
-polkitd \- program to do something
+polkitd \- maintains a list of privileges and provides interfaces for changing it
+
.SH "SYNOPSIS"
.B polkitd
-.RI [ options ] " files" ...
-.br
-.B bar
-.RI [ options ] " files" ...
+.RI [ options ]
+
.SH "DESCRIPTION"
-This manual page documents briefly the
-.B policykit
-and
-.B bar
-commands.
-.PP
-.\" TeX users may be more comfortable with the \fB<whatever>\fP and
-.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
-.\" respectively.
-\fBpolicykit\fP is a program that...
+The PolicyKit daemon
+.B polkitd
+maintains a list of privileges and provides interfaces for changing it.
+
.SH "OPTIONS"
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`\-').
A summary of options is included below.
-For a complete description, see the Info files.
+.TP
+.B \-n, \-\-no\-daemon
+Do not daemonize, run in foreground
+.TP
+.B \-v, \-\-verbose
+Print debug output
.TP
.B \-h, \-\-help
-Show summary of options.
+Show summary of options
.TP
-.B \-v, \-\-version
-Show version of program.
+.B \-V \-\-version
+Show version number of the program.
+
+.SH "FILES"
+The configuration files which define the available policies are located in
+.I /etc/PolicyKit/privilege.d/.
+
.SH "SEE ALSO"
-.BR bar (1),
-.BR baz (1).
-.br
-The programs are documented fully by
-.I R "The Rise and Fall of a Fooish Bar" ,
-available via the Info system.
+.BR polkit-grant-privilege (1),
+.BR polkit-revoke-privilege (1),
+.BR polkit-is-privileged (1),
+.BR polkit-list-privileges (1).
+
.SH "AUTHOR"
-policykit was written by <upstream author>.
+policykit was written by David Zeuthen <davidz at redhat.com>.
.PP
-This manual page was written by Michael Biebl <biebl at teco.edu>,
+This manual page was written by Michael Biebl <biebl at debian.org>,
for the Debian project (but may be used by others).
More information about the Pkg-utopia-commits
mailing list