Document deprecated functions.

All of these are a part of public API with some external users.  Do the
minimum to avoid a warning; ideally we should also add a
*_DISABLE_DEPRECATED macro etc.

https://bugs.freedesktop.org/show_bug.cgi?id=63573

diff --git a/docs/polkit/polkit-1-sections.txt b/docs/polkit/polkit-1-sections.txt
index dfc407aa12655d53379bd7d69fc8c8a2a1a29fb7..a77379523856fb4e592dfc84f8f15cf9927f8970 100644 (file)
--- a/docs/polkit/polkit-1-sections.txt
+++ b/docs/polkit/polkit-1-sections.txt
@@ -25,6 +25,7 @@ PolkitCheckAuthorizationFlags
 polkit_authority_get_async
 polkit_authority_get_finish
 polkit_authority_get_sync
+polkit_authority_get
 polkit_authority_get_owner
 polkit_authority_get_backend_name
 polkit_authority_get_backend_version
@@ -173,6 +174,7 @@ polkit_unix_process_set_start_time
 polkit_unix_process_get_start_time
 polkit_unix_process_set_uid
 polkit_unix_process_get_uid
+polkit_unix_process_get_owner
 <SUBSECTION Standard>
 PolkitUnixProcessClass
 POLKIT_UNIX_PROCESS
@@ -320,6 +322,7 @@ PolkitAgentRegisterFlags
 polkit_agent_listener_register
 polkit_agent_listener_register_with_options
 polkit_agent_listener_unregister
+polkit_agent_register_listener
 <SUBSECTION Standard>
 POLKIT_AGENT_LISTENER
 POLKIT_AGENT_IS_LISTENER

diff --git a/src/polkit/polkitunixprocess.c b/src/polkit/polkitunixprocess.c
index 913be3ac6a0a6a76c6f5995a13d320a8d963de0a..9d30cd213b7fd4cf04f3ed10dd72123f5d549734 100644 (file)
--- a/src/polkit/polkitunixprocess.c
+++ b/src/polkit/polkitunixprocess.c
@@ -740,6 +740,13 @@ out:
 }
 
 /* deprecated public method */
+/**
+ * polkit_unix_process_get_owner:
+ * @process: A #PolkitUnixProcess.
+ * @error: Return location for error.
+ *
+ * (deprecated)
+ */
 gint
 polkit_unix_process_get_owner (PolkitUnixProcess  *process,
                                GError            **error)

diff --git a/src/polkitagent/polkitagentlistener.c b/src/polkitagent/polkitagentlistener.c
index 5bddd035cc0edca1e46fac361eb4978b85f8d44a..29a0fdfd0c0bbb9488a65f6d262b43c76b337086 100644 (file)
--- a/src/polkitagent/polkitagentlistener.c
+++ b/src/polkitagent/polkitagentlistener.c
@@ -535,6 +535,15 @@ listener_died (gpointer user_data,
   server_free (server);
 }
 
+/**
+ * polkit_agent_register_listener:
+ * @listener: A #PolkitAgentListener.
+ * @subject: The subject to become an authentication agent for, typically a #PolkitUnixSession object.
+ * @object_path: The D-Bus object path to use for the authentication agent or %NULL for the default object path.
+ * @error: Return location for error.
+ *
+ * (deprecated)
+ */
 gboolean
 polkit_agent_register_listener (PolkitAgentListener  *listener,
                                 PolkitSubject        *subject,