man: fix link markup

[thirdparty/systemd.git] / man / org.freedesktop.locale1.xml

diff --git a/man/org.freedesktop.locale1.xml b/man/org.freedesktop.locale1.xml
index fb6f585ac799abb1944631bda59b7b0786d78fef..3956eaf8a7b8c1f58189a4bb3d2461f3562ba1e4 100644 (file)
--- a/man/org.freedesktop.locale1.xml
+++ b/man/org.freedesktop.locale1.xml
@@ -34,11 +34,7 @@
 
     <para>The service exposes the following interfaces on the bus:</para>
 
-    <programlisting>
-$ gdbus introspect --system \
-        --dest org.freedesktop.locale1 \
-        --object-path /org/freedesktop/locale1
-
+    <programlisting executable="systemd-localed" node="/org/freedesktop/locale1" interface="org.freedesktop.locale1">
 node /org/freedesktop/locale1 {
   interface org.freedesktop.locale1 {
     methods:
@@ -69,6 +65,34 @@ node /org/freedesktop/locale1 {
 };
     </programlisting>
 
+    <!--Autogenerated cross-references for systemd.directives, do not edit-->
+
+    <variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.locale1"/>
+
+    <variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.locale1"/>
+
+    <variablelist class="dbus-method" generated="True" extra-ref="SetLocale()"/>
+
+    <variablelist class="dbus-method" generated="True" extra-ref="SetVConsoleKeyboard()"/>
+
+    <variablelist class="dbus-method" generated="True" extra-ref="SetX11Keyboard()"/>
+
+    <variablelist class="dbus-property" generated="True" extra-ref="Locale"/>
+
+    <variablelist class="dbus-property" generated="True" extra-ref="X11Layout"/>
+
+    <variablelist class="dbus-property" generated="True" extra-ref="X11Model"/>
+
+    <variablelist class="dbus-property" generated="True" extra-ref="X11Variant"/>
+
+    <variablelist class="dbus-property" generated="True" extra-ref="X11Options"/>
+
+    <variablelist class="dbus-property" generated="True" extra-ref="VConsoleKeymap"/>
+
+    <variablelist class="dbus-property" generated="True" extra-ref="VConsoleKeymapToggle"/>
+
+    <!--End of Autogenerated section-->
+
     <refsect2>
       <title>Methods</title>
 
@@ -98,7 +122,8 @@ node /org/freedesktop/locale1 {
 
       <para>Use the empty string for the keymap parameters you wish not to set.</para>
 
-      <para>The <varname>interactive</varname> boolean parameters can be used to control whether PolicyKit
+      <para>The <varname>interactive</varname> boolean parameters can be used to control whether
+      <ulink url="https://www.freedesktop.org/software/polkit/docs/latest/">polkit</ulink>
       should interactively ask the user for authentication credentials if required.</para>
     </refsect2>
 
@@ -132,14 +157,28 @@ node /org/freedesktop/locale1 {
     <refsect2>
       <title>Security</title>
 
-      <para>Changing the system locale or keymap using this interface is authenticated via PolicyKit. The
-      PolicyKit action for <function>SetLocale()</function> is
-      <constant>org.freedesktop.locale1.set-locale</constant>. The PolicyKit action for
+      <para>Changing the system locale or keymap using this interface is authenticated via polkit. The
+      polkit action for <function>SetLocale()</function> is
+      <constant>org.freedesktop.locale1.set-locale</constant>. The polkit action for
       <function>SetX11Keyboard()</function> and <function>SetVConsoleKeyboard()</function> is
       <constant>org.freedesktop.locale1.set-keyboard</constant>.</para>
     </refsect2>
   </refsect1>
 
+  <refsect1>
+    <title>Examples</title>
+
+    <example>
+      <title>Introspect <interfacename>org.freedesktop.locale1</interfacename> on the bus</title>
+
+      <programlisting>
+$ gdbus introspect --system \
+  --dest org.freedesktop.locale1 \
+  --object-path /org/freedesktop/locale1
+      </programlisting>
+    </example>
+  </refsect1>
+
   <refsect1>
     <title>Versioning</title>