introspection: unbreak a couple of docstrings

A couple of argument documentation strings were long enough to be broken
up to span over multiple lines. gdbus-codegen, on the other hand, was
of differing opinion and promptly punished the offense by garbling the
resulting docbook.

Merge the string into single lines.
This commit is contained in:
Lubomir Rintel
2022-03-18 14:57:08 +01:00
parent 87d16e7020
commit d1e73f0ece
2 changed files with 15 additions and 12 deletions

View File

@@ -117,7 +117,6 @@
LoadConnections: LoadConnections:
@filenames: Array of paths to on-disk connection profiles in directories monitored by NetworkManager. @filenames: Array of paths to on-disk connection profiles in directories monitored by NetworkManager.
@status: Success or failure of the operation as a whole. True if NetworkManager at least tried to load the indicated connections, even if it did not succeed. False if an error occurred before trying to load the connections (eg, permission denied). @status: Success or failure of the operation as a whole. True if NetworkManager at least tried to load the indicated connections, even if it did not succeed. False if an error occurred before trying to load the connections (eg, permission denied).
Note that before 1.20, NetworkManager had a bug and this @status value was wrong. It is better to assume success if the method does not return with a D-Bus error. On top of that, you can look at @failures to know whether any of the requested files failed.
@failures: Paths of connection files that could not be loaded. @failures: Paths of connection files that could not be loaded.
Loads or reloads the indicated connections from disk. You should call this Loads or reloads the indicated connections from disk. You should call this
@@ -125,6 +124,10 @@
that NetworkManager sees the changes. that NetworkManager sees the changes.
As with AddConnection(), this operation does not necessarily As with AddConnection(), this operation does not necessarily
start the network connection. start the network connection.
Note that before 1.20, NetworkManager had a bug and this @status value was wrong.
It is better to assume success if the method does not return with a D-Bus error.
On top of that, you can look at @failures to know whether any of the requested files failed.
--> -->
<method name="LoadConnections"> <method name="LoadConnections">
<arg name="filenames" type="as" direction="in"/> <arg name="filenames" type="as" direction="in"/>

View File

@@ -119,8 +119,7 @@
@options: Further options for the method call. @options: Further options for the method call.
@path: Object path of the new connection that was just added. @path: Object path of the new connection that was just added.
@active_connection: The path of the active connection object representing this active connection. @active_connection: The path of the active connection object representing this active connection.
@result: a dictionary of additional output arguments for future extension. Currently, not additional @result: a dictionary of additional output arguments for future extension. Currently, not additional output arguments are supported.
output arguments are supported.
Adds a new connection using the given details (if any) as a template Adds a new connection using the given details (if any) as a template
(automatically filling in missing settings with the capabilities of the (automatically filling in missing settings with the capabilities of the
@@ -287,18 +286,19 @@
<!-- <!--
CheckpointAdjustRollbackTimeout: CheckpointAdjustRollbackTimeout:
@add_timeout: number of seconds from ~now~ in which the @checkpoint: The checkpoint to be rolled back.
timeout will expire. Set to 0 to disable the timeout. @add_timeout: number of seconds from <emphasis>now</emphasis> in which the timeout will expire. Set to 0 to disable the timeout.
Note that the added seconds start counting from now,
not "Created" timestamp or the previous expiration
time. Note that the "Created" property of the checkpoint
will stay unchanged by this call. However, the "RollbackTimeout"
will be recalculated to give the approximate new expiration time.
The new "RollbackTimeout" property will be approximate up to
one second precision, which is the accuracy of the property.
@since: 1.12 @since: 1.12
Reset the timeout for rollback for the checkpoint. Reset the timeout for rollback for the checkpoint.
Note that the added seconds start counting from now,
not "Created" timestamp or the previous expiration
time. Note that the "Created" property of the checkpoint
will stay unchanged by this call. However, the "RollbackTimeout"
will be recalculated to give the approximate new expiration time.
The new "RollbackTimeout" property will be approximate up to
one second precision, which is the accuracy of the property.
--> -->
<method name="CheckpointAdjustRollbackTimeout"> <method name="CheckpointAdjustRollbackTimeout">
<arg name="checkpoint" type="o" direction="in"/> <arg name="checkpoint" type="o" direction="in"/>