X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_bus_path_encode.xml;h=55a6fd0056f6b4dd3ec4c451e9aecb8f147ecb4e;hb=4a02e68602be9f6f3caac0f6195672490f715fe1;hp=5c166d072bea96a634216143b6b63e0de2ad9782;hpb=a6278b88305b237b02eabff0d870b57fe851822d;p=elogind.git
diff --git a/man/sd_bus_path_encode.xml b/man/sd_bus_path_encode.xml
index 5c166d072..55a6fd005 100644
--- a/man/sd_bus_path_encode.xml
+++ b/man/sd_bus_path_encode.xml
@@ -1,4 +1,4 @@
-
+
@@ -82,16 +82,16 @@ along with systemd; If not, see .
prefix and an external identifier string as arguments, plus a
place to store the returned bus path string. The bus path prefix
must be a valid bus path, starting with a slash
- /, but not ending in one. The external
- identifier string may be in any format, may be the empty string
- and no restrictions on the charset are made - however it must
+ /, and not ending in one. The external
+ identifier string may be in any format, may be the empty string,
+ and has no restrictions on the charset â however, it must
always be NUL-terminated. The returned string
will be the concatenation of the bus path prefix plus an escaped
version of the external identifier string. This operation may be
reversed with sd_bus_decode(). It is
- recommended to only use external identifiers here that generally
+ recommended to only use external identifiers that generally
require little escaping to be turned into valid bus path
- identifiers (for example by sticking to a 7bit ASCII character
+ identifiers (for example, by sticking to a 7-bit ASCII character
set), in order to ensure the resulting bus path is still short and
easily processed.
@@ -101,12 +101,12 @@ along with systemd; If not, see .
takes a bus path and a prefix string, plus a place to store the
returned external identifier string. If the bus path does not
start with the specified prefix, 0 is returned and the returned
- string is set to NULL. Otherwise the the
+ string is set to NULL. Otherwise, the
string following the prefix is unescaped and returned in the
external identifier string.
- The escaping used will will replace all characters which are
- invalid in a bus object path by _ followed by a
+ The escaping used will replace all characters which are
+ invalid in a bus object path by _, followed by a
hexadecimal value. As a special case, the empty string will be
replaced by a lone _.
@@ -118,12 +118,12 @@ along with systemd; If not, see .
returns positive or 0, and a valid bus path in the return
argument. On success, sd_bus_path_decode()
returns a positive value if the prefixed matched, or 0 if it
- didn't. If the prefix matched the external identifier is returned
- in the return parameter. If it did not match NULL is returned in
+ did not. If the prefix matched, the external identifier is returned
+ in the return parameter. If it did not match, NULL is returned in
the return parameter. On failure, a negative errno-style error
number is returned by either function. The returned strings must
be
- free3'd
+ free3'd
by the caller.
@@ -133,7 +133,7 @@ along with systemd; If not, see .
sd_bus_path_encode() and
sd_bus_path_decode() are available as a
shared library, which can be compiled and linked to with the
- libsystemd pkg-config1
+ libsystemd pkg-config1
file.
@@ -143,7 +143,7 @@ along with systemd; If not, see .
systemd1,
sd-bus3,
- free3
+ free3