[nongnu] elpa/xml-rpc 960b2510e3 61/64: Update README

[Stefan Kangas]

branch: elpa/xml-rpc
commit 960b2510e3bc05ba94bff95d9f20a5443b2d2058
Author: Mark A. Hershberger <mah@nichework.com>
Commit: Mark A. Hershberger <mah@nichework.com>

    Update README
---
 README.org | 149 ++++++++++++++++++++++++++++++++++++++++++++++++++++---------
 xml-rpc.el |   4 +-
 2 files changed, 131 insertions(+), 22 deletions(-)

diff --git a/README.org b/README.org
index ac678853cf..f0d4e5ff3c 100644
--- a/README.org
+++ b/README.org
@@ -1,13 +1,26 @@
 * Commentary:
+[[https://melpa.org/#/xml-rpc][file:https://melpa.org/packages/xml-rpc-badge.svg]]
+
+This is an [[http://xmlrpc.com/][XML-RPC]] client implementation in elisp, 
capable of both synchronous and asynchronous method calls (using the url 
package's async retrieval functionality).
 
-This is an XML-RPC client implementation in elisp, capable of both synchronous 
and asynchronous method calls (using the url package's async retrieval 
functionality).
 XML-RPC is remote procedure calls over HTTP using XML to describe the function 
call and return values.
 
 xml-rpc.el represents XML-RPC datatypes as lisp values, automatically 
converting to and from the XML datastructures as needed, both for method 
parameters and return values, making using XML-RPC methods fairly transparent 
to the lisp code.
 
 * Installation:
 
-If you use ELPA (http://tromey.com/elpa), you can install via the M-x 
package-list-packages interface. This is preferrable as you will have access to 
updates automatically.
+If you use [[http://elpa.gnu.org/][ELPA]], and have configured the 
[[https://melpa.org/][MELPA]] repository, then =M-x package-install RET xml-rpc 
RET= interface. This is preferrable as you will have access to updates 
automatically.
+
+If you would like to use ELPA, but this is your first time to use it or MELPA, 
then try evaluating the following code in emacs:
+#+begin_src elisp
+  (progn
+    (require 'package)
+    (add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/";) 
t)
+    (unless (package-installed-p 'xml-rpc)
+      (with-temp-buffer
+        (url-insert-file-contents 
"https://raw.githubusercontent.com/xml-rpc-el/xml-rpc-el/master/xml-rpc.el";)
+        (package-install-from-buffer))))
+#+end_src
 
 Otherwise, just make sure this file in your load-path (usually =~/.emacs.d= is 
included) and put
 #+begin_src elisp
@@ -17,7 +30,7 @@ in your =~/.emacs= or =~/.emacs.d/init.el= file.
 
 * Requirements
 
-xml-rpc.el uses the url package for http handling and =xml.el= for XML parsing 
or, if you have Emacs 27 with =libxml= included, =libxml=. url is a part of the 
W3 browser package.  The url package that is part of Emacs 22+ works great.
+xml-rpc.el uses the url package for http handling and =xml.el= for XML parsing 
or, if you have Emacs 27+ with =libxml= included, =libxml=. The url package 
that is part of Emacs works fine.
 
 * Bug reports
 
@@ -59,25 +72,121 @@ Here follows some examples demonstrating the use of 
xml-rpc.el
 #+end_src
 
 ** Some real world working examples for fun and play
-
-*** Check the temperature (celsius) outside jonas@codefactory.se's apartment
+These were last tested working on 2020-09-06.
+*** Fetch the first state name from UserLand's server
 #+begin_src elisp
-(xml-rpc-method-call
-     "http://flint.bengburken.net:80/xmlrpc/onewire_temp.php";
-     'onewire.getTemp)
+  (xml-rpc-method-call "http://betty.userland.com/rpc2";
+                       'examples.getStateName '(1))
 #+end_src
 
-*** Fetch the latest NetBSD news the past 5 days from O'reillynet
+#+RESULTS:
+: Alabama
+*** Get a list of supported methods from a blog
 #+begin_src elisp
-(xml-rpc-method-call "http://www.oreillynet.com/meerkat/xml-rpc/server.php";
-                  'meerkat.getItems
-                  '(("channel" . 1024)
-                    ("search" . "/NetBSD/")
-                    ("time_period" . "5DAY")
-                    ("ids" . 0)
-                    ("descriptions" . 200)
-                    ("categories" . 0)
-                    ("channels" . 0)
-                    ("dates" . 0)
-                    ("num_items" . 5)))
+  (mapconcat (lambda (s) (when s s))
+    (xml-rpc-method-call "https://hexmode.wordpress.com/xmlrpc.php";
+                         'mt.supportedMethods)
+    "\n")
 #+end_src
+
+#+RESULTS:
+#+begin_example
+wp.getUsersBlogs
+wp.newPost
+wp.editPost
+wp.deletePost
+wp.getPost
+wp.getPosts
+wp.newTerm
+wp.editTerm
+wp.deleteTerm
+wp.getTerm
+wp.getTerms
+wp.getTaxonomy
+wp.getTaxonomies
+wp.getUser
+wp.getUsers
+wp.getProfile
+wp.editProfile
+wp.getPage
+wp.getPages
+wp.newPage
+wp.deletePage
+wp.editPage
+wp.getPageList
+wp.getAuthors
+wp.getCategories
+wp.getTags
+wp.newCategory
+wp.deleteCategory
+wp.suggestCategories
+wp.uploadFile
+wp.deleteFile
+wp.getCommentCount
+wp.getPostStatusList
+wp.getPageStatusList
+wp.getPageTemplates
+wp.getOptions
+wp.setOptions
+wp.getComment
+wp.getComments
+wp.deleteComment
+wp.editComment
+wp.newComment
+wp.getCommentStatusList
+wp.getMediaItem
+wp.getMediaLibrary
+wp.getPostFormats
+wp.getPostType
+wp.getPostTypes
+wp.getRevisions
+wp.restoreRevision
+blogger.getUsersBlogs
+blogger.getUserInfo
+blogger.getPost
+blogger.getRecentPosts
+blogger.newPost
+blogger.editPost
+blogger.deletePost
+metaWeblog.newPost
+metaWeblog.editPost
+metaWeblog.getPost
+metaWeblog.getRecentPosts
+metaWeblog.getCategories
+metaWeblog.newMediaObject
+metaWeblog.deletePost
+metaWeblog.getUsersBlogs
+mt.getCategoryList
+mt.getRecentPostTitles
+mt.getPostCategories
+mt.setPostCategories
+mt.supportedMethods
+mt.supportedTextFilters
+mt.getTrackbackPings
+mt.publishPost
+pingback.ping
+pingback.extensions.getPingbacks
+demo.sayHello
+demo.addTwoNumbers
+wpStats.get_key
+wpStats.check_key
+wpStats.get_blog_id
+wpStats.get_site_id
+wpStats.update_bloginfo
+wpStats.update_postinfo
+wpStats.ping_blog
+wpStats.flush_posts
+wpcom.get_user_blogids
+wpcom.getFeatures
+wpcom.addApplicationPassword
+wpcom.blackberryUploadFile
+wpcom.blackberryGetUploadingFileKeys
+wpcom.getUsersSubs
+wpcom.set_mobile_push_notification_settings
+wpcom.get_mobile_push_notification_settings
+wpcom.mobile_push_register_token
+wpcom.mobile_push_unregister_token
+wpcom.mobile_push_set_blogs_list
+wpcom.mobile_push_win_phone_get_last_notification
+#+end_example
+
diff --git a/xml-rpc.el b/xml-rpc.el
index 9b9463410a..46e4772a1f 100644
--- a/xml-rpc.el
+++ b/xml-rpc.el
@@ -11,8 +11,8 @@
 ;; Version: 1.6.15
 ;; Created: May 13 2001
 ;; Keywords: xml rpc network
-;; URL: http://github.com/hexmode/xml-rpc-el
-;; Last Modified: <2020-09-06 18:40:07 mah>
+;; URL: http://github.com/xml-rpc-el/xml-rpc-el
+;; Last Modified: <2020-09-06 20:07:23 mah>
 
 (defconst xml-rpc-version "1.6.15"
   "Current version of xml-rpc.el")