From 0846857109aee1791540a6a90ac888300a89e6b9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ren=C3=A9=20Genz?= Date: Sun, 21 Feb 2021 21:15:22 +0000 Subject: fix typos --- docs/man/polkit.xml | 44 ++++++++++++++++++++++---------------------- 1 file changed, 22 insertions(+), 22 deletions(-) (limited to 'docs') diff --git a/docs/man/polkit.xml b/docs/man/polkit.xml index f2c1acf..99aa474 100644 --- a/docs/man/polkit.xml +++ b/docs/man/polkit.xml @@ -6,7 +6,7 @@ polkit - January 2009 + February 2021 polkit @@ -119,14 +119,14 @@ System Context | | library wraps the polkit D-Bus API and is usable from any C/C++ program as well as higher-level languages supporting GObjectIntrospection - such as Javascript and Python. A mechanism can also use the + such as JavaScript and Python. A mechanism can also use the D-Bus API or the pkcheck1 command to check authorizations. The libpolkit-agent-1 library provides an abstraction of the native authentication system, e.g. pam8 - and also facilities registration and communication with the + and also facilities for registration and communication with the polkit D-Bus service. @@ -143,7 +143,7 @@ System Context | | An authentication agent is used to make the user of a session prove that the user of the session really is the user (by authenticating as the user) or an administrative user (by - authenticating as a administrator). In order to integrate well + authenticating as an administrator). In order to integrate well with the rest of the user session (e.g. match the look and feel), authentication agents are meant to be provided by the user session that the user uses. For example, an authentication @@ -173,7 +173,7 @@ System Context | | If the system is configured without a root - account it may prompt for a specific user designated as the + account, it may prompt for a specific user designated as the administrative user: @@ -200,9 +200,9 @@ System Context | | Applications that do not run under a desktop environment (for - example, if launched from a + example, if launched from an ssh1 - login) may not have have an authentication agent associated with + login) may not have an authentication agent associated with them. Such applications may use the PolkitAgentTextListener type or the @@ -213,7 +213,7 @@ System Context | | DECLARING ACTIONS - A mechanism need to declare a set of actions in + A mechanism needs to declare a set of actions in order to use polkit. Actions correspond to operations that clients can request the mechanism to carry out and are defined in XML files that the mechanism installs into the polkit actions are namespaced and can only contain the - characters [A-Z][a-z][0-9].- e.g. ASCII, + characters "[A-Z][a-z][0-9].-", e.g. ASCII, digits, period and hyphen. Each XML file can contain more than one action but all actions need to be in the same namespace and the file needs to be named after the namespace and have the @@ -280,8 +280,8 @@ System Context | | Declares an action. The action name is specified using the id attribute and can only contain the - characters [A-Z][a-z][0-9].- - e.g. ASCII, digits, period and hyphen. + characters "[A-Z][a-z][0-9].- + ", e.g. ASCII, digits, period and hyphen. @@ -385,7 +385,7 @@ System Context | | Used for annotating an action with a key/value pair. The - key is specified using the the key + key is specified using the key attribute and the value is specified using the value attribute. This element may appear zero or more times. See below for known @@ -443,7 +443,7 @@ System Context | | The org.freedesktop.policykit.imply - annotation (its value is a string containing a space separated + annotation (its value is a string containing a space-separated list of action identifiers) can be used to define meta actions. The way it works is that if a subject is authorized for an action with this annotation, @@ -456,10 +456,10 @@ System Context | | The org.freedesktop.policykit.owner annotation can be used to define a set of users who can query whether a client is authorized to perform this action. If - this annotation is not specified then only root can query + this annotation is not specified, then only root can query whether a client running as a different user is authorized for an action. The value of this annotation is a string - containing a space separated list of PolkitIdentity entries, for example "unix-user:42 unix-user:colord". A typical use of this annotation @@ -604,15 +604,15 @@ polkit.Result = { "*_KEEP" constants (if similar functionality is required, the authorization rule can easily implement temporary authorizations using the - Date + Date type for timestamps). The addAdminRule() method is used for - adding a function may be called whenever administrator + adding a function that may be called whenever administrator authentication is required. The function is used to specify what - identies may be used for administrator authentication for the + identities may be used for administrator authentication for the authorization check identified by action and subject. Functions added are called in the order they have been added until one of the functions @@ -630,13 +630,13 @@ polkit.Result = { There is no guarantee that a function registered with addRule() or addAdminRule() is ever called - for example - an early rules file could register a function that always return + an early rules file could register a function that always returns a value, hence ensuring that functions added later are never called. - If user-provided code takes a long time to execute an exception + If user-provided code takes a long time to execute, an exception will be thrown which normally results in the function being terminated (the current limit is 15 seconds). This is used to catch runaway scripts. @@ -648,7 +648,7 @@ polkit.Result = { argv and waits for it to terminate. If an error occurs or the helper doesn't exit normally with exit code 0, an exception is thrown. If the helper does not exit within 10 - seconds it is killed. Otherwise, the program's + seconds, it is killed. Otherwise, the program's standard output is returned as a string. The spawn() method should be used sparingly as helpers may take a very long or indeterminate amount of time @@ -728,7 +728,7 @@ May 24 14:28:50 thinkpad polkitd[32217]: /etc/polkit-1/rules.d/10-test.rules:4: polkit variables passed from the mechanism. For example, the pkexec1 mechanism sets the variable program - which can be obtained in Javascript using the expression + which can be obtained in JavaScript using the expression action.lookup("program"). If there is no value for the given key, then undefined is returned. -- cgit v1.2.1