From 8b91d32f988fe87cb1534a2522d9ca3d8aa58d7b Mon Sep 17 00:00:00 2001
From: Andrew Nacin <wp@andrewnacin.com>
Date: Fri, 6 Sep 2013 16:56:09 +0000
Subject: [PATCH] Inline documentation for hooks in xmlrpc.php.

The old link for RSD is dead; update to the new one.

props bftrick.
see #25229.

Built from https://develop.svn.wordpress.org/trunk@25281


git-svn-id: http://core.svn.wordpress.org/trunk@25245 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 xmlrpc.php | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/xmlrpc.php b/xmlrpc.php
index 59674df727..bfbe470ca8 100644
--- a/xmlrpc.php
+++ b/xmlrpc.php
@@ -28,7 +28,7 @@ if ( isset($HTTP_RAW_POST_DATA) )
 /** Include the bootstrap for setting up WordPress environment */
 include('./wp-load.php');
 
-if ( isset( $_GET['rsd'] ) ) { // http://archipelago.phrasewise.com/rsd
+if ( isset( $_GET['rsd'] ) ) { // http://cyber.law.harvard.edu/blogs/gems/tech/rsd.html
 header('Content-Type: text/xml; charset=' . get_option('blog_charset'), true);
 ?>
 <?php echo '<?xml version="1.0" encoding="'.get_option('blog_charset').'"?'.'>'; ?>
@@ -42,7 +42,15 @@ header('Content-Type: text/xml; charset=' . get_option('blog_charset'), true);
       <api name="Movable Type" blogID="1" preferred="false" apiLink="<?php echo site_url('xmlrpc.php', 'rpc') ?>" />
       <api name="MetaWeblog" blogID="1" preferred="false" apiLink="<?php echo site_url('xmlrpc.php', 'rpc') ?>" />
       <api name="Blogger" blogID="1" preferred="false" apiLink="<?php echo site_url('xmlrpc.php', 'rpc') ?>" />
-      <?php do_action( 'xmlrpc_rsd_apis' ); ?>
+      <?php 
+      /** 
+       * Add additional APIs to the Really Simple Discovery (RSD) endpoint.
+       *
+       * @see http://cyber.law.harvard.edu/blogs/gems/tech/rsd.html
+       * @since 3.5.0
+       */ 
+      do_action( 'xmlrpc_rsd_apis' ); 
+      ?>
     </apis>
   </service>
 </rsd>
@@ -61,8 +69,13 @@ include_once(ABSPATH . WPINC . '/class-wp-xmlrpc-server.php');
  */
 $post_default_title = "";
 
-// Allow for a plugin to insert a different class to handle requests.
-$wp_xmlrpc_server_class = apply_filters('wp_xmlrpc_server_class', 'wp_xmlrpc_server');
+/** 
+ * Filter the class used for handling XML-RPC requests.
+ * 
+ * @since 3.1.0
+ * @param string The name of the XML-RPC server class.
+ */ 
+$wp_xmlrpc_server_class = apply_filters( 'wp_xmlrpc_server_class', 'wp_xmlrpc_server' );
 $wp_xmlrpc_server = new $wp_xmlrpc_server_class;
 
 // Fire off the request