svn commit: r1544001 - /subversion/trunk/subversion/include/svn_auth.h

[br...@apache.org]

Author: breser
Date: Thu Nov 21 02:12:40 2013
New Revision: 1544001

URL: http://svn.apache.org/r1544001
Log:
Followup to r1543992, add the usual deprecated version number.

This feels a tad awkward since gnome_keyring, kwallet and gpg_agent
should all have basically never been added as public APIs and nobody
should have wanted to use them since.  But I guess since we didn't
bother to mark them as deprecated till now they're not until 1.9.

* subversion/include/svn_auth.h
  (svn_auth_get_windows_simple_provider,
   svn_auth_get_windows_ssl_client_cert_pw_provider,
   svn_auth_get_windows_ssl_server_trust_provider,
   svn_auth_get_keychain_simple_provider,
   svn_auth_get_keychain_ssl_client_cert_pw_provider,
   svn_auth_get_gnome_keyring_simple_provider,
   svn_auth_get_gnome_keyring_ssl_client_cert_pw_provider,
   svn_auth_get_kwallet_simple_provider,
   svn_auth_get_kwallet_ssl_client_cert_pw_provider,
   svn_auth_get_gpg_agent_simple_provider): Mark as deprecated in 1.9
   

Modified:
    subversion/trunk/subversion/include/svn_auth.h

Modified: subversion/trunk/subversion/include/svn_auth.h
URL: http://svn.apache.org/viewvc/subversion/trunk/subversion/include/svn_auth.h?rev=1544001&r1=1544000&r2=1544001&view=diff
==============================================================================
--- subversion/trunk/subversion/include/svn_auth.h (original)
+++ subversion/trunk/subversion/include/svn_auth.h Thu Nov 21 02:12:40 2013
@@ -884,8 +884,9 @@ svn_auth_get_platform_specific_client_pr
  * @note An administrative password reset may invalidate the account's
  * secret key. This function will detect that situation and behave as
  * if the password were not cached at all.
- * @deprecated Use svn_auth_get_platform_specific_provider with provider_name
- * of "windows" and provider_type of "simple".
+ * @deprecated Provided for backwards compatibility with the 1.8 API.  Use 
+ * svn_auth_get_platform_specific_provider with provider_name of "windows"
+ * and provider_type of "simple".
  */
 SVN_DEPRECATED
 void
@@ -909,7 +910,8 @@ svn_auth_get_windows_simple_provider(svn
  * @note An administrative password reset may invalidate the account's
  * secret key. This function will detect that situation and behave as
  * if the password were not cached at all.
- * @deprecated Use svn_auth_get_platform_specific_provider with provider_name
+ * @deprecated Provided for backwards compatibility with the 1.8 API.
+ * Use svn_auth_get_platform_specific_provider with provider_name
  * of "windows" and provider_type of "ssl_client_cert_pw".
  */
 SVN_DEPRECATED
@@ -929,7 +931,8 @@ svn_auth_get_windows_ssl_client_cert_pw_
  *
  * @since New in 1.5.
  * @note This function is only available on Windows.
- * @deprecated Use svn_auth_get_platform_specific_provider with provider_name
+ * @deprecated Provided for backwards compatibility with the 1.8 API.
+ * Use svn_auth_get_platform_specific_provider with provider_name
  * of "windows" and provider_type of "ssl_server_trust".
  */
 SVN_DEPRECATED
@@ -952,7 +955,8 @@ svn_auth_get_windows_ssl_server_trust_pr
  *
  * @since New in 1.4
  * @note This function is only available on Mac OS 10.2 and higher.
- * @deprecated Use svn_auth_get_platform_specific_provider with provider_name
+ * @deprecated Provided for backwards compatibility with the 1.8 API.
+ * Use svn_auth_get_platform_specific_provider with provider_name
  * of "keychain" and provider_type of "simple".
  */
 SVN_DEPRECATED
@@ -971,7 +975,8 @@ svn_auth_get_keychain_simple_provider(sv
  *
  * @since New in 1.6
  * @note This function is only available on Mac OS 10.2 and higher.
- * @deprecated Use svn_auth_get_platform_specific_provider with provider_name
+ * @deprecated Provided for backwards compatibility with the 1.8 API.
+ * Use svn_auth_get_platform_specific_provider with provider_name
  * of "keychain" and provider_type of "ssl_client_cert_pw".
  */
 SVN_DEPRECATED
@@ -1044,7 +1049,8 @@ svn_auth_gnome_keyring_version(void);
  * @since New in 1.6
  * @note This function actually works only on systems with
  * libsvn_auth_gnome_keyring and GNOME Keyring installed.
- * @deprecated Use svn_auth_get_platform_specific_provider with provider_name
+ * @deprecated Provided for backwards compatibility with the 1.8 API.
+ * Use svn_auth_get_platform_specific_provider with provider_name
  * of "gnome_keyring" and provider_type of "simple".
  */
 SVN_DEPRECATED
@@ -1074,7 +1080,8 @@ svn_auth_get_gnome_keyring_simple_provid
  * @since New in 1.6
  * @note This function actually works only on systems with
  * libsvn_auth_gnome_keyring and GNOME Keyring installed.
- * @deprecated Use svn_auth_get_platform_specific_provider with provider_name
+ * @deprecated Provided for backwards compatibility with the 1.8 API.
+ * Use svn_auth_get_platform_specific_provider with provider_name
  * of "gnome_keyring" and provider_type of "ssl_client_cert_pw".
  */
 SVN_DEPRECATED
@@ -1105,7 +1112,8 @@ svn_auth_kwallet_version(void);
  * @since New in 1.6
  * @note This function actually works only on systems with libsvn_auth_kwallet
  * and KWallet installed.
- * @deprecated Use svn_auth_get_platform_specific_provider with provider_name
+ * @deprecated Provided for backwards compatibility with the 1.8 API.
+ * Use svn_auth_get_platform_specific_provider with provider_name
  * of "kwallet" and provider_type of "simple".
  */
 SVN_DEPRECATED
@@ -1126,7 +1134,8 @@ svn_auth_get_kwallet_simple_provider(svn
  * @since New in 1.6
  * @note This function actually works only on systems with libsvn_auth_kwallet
  * and KWallet installed.
- * @deprecated Use svn_auth_get_platform_specific_provider with provider_name
+ * @deprecated Provided for backwards compatibility with the 1.8 API.
+ * Use svn_auth_get_platform_specific_provider with provider_name
  * of "kwallet" and provider_type of "ssl_client_cert_pw".
  */
 SVN_DEPRECATED
@@ -1151,7 +1160,8 @@ svn_auth_get_kwallet_ssl_client_cert_pw_
  * @since New in 1.8
  * @note This function actually works only on systems with
  * GNU Privacy Guard installed.
- * @deprecated Use svn_auth_get_platform_specific_provider with provider_name
+ * @deprecated Provided for backwards compatibility with the 1.8 API.
+ * Use svn_auth_get_platform_specific_provider with provider_name
  * of "gpg_agent" and provider_type of "simple".
  */
 SVN_DEPRECATED