gravaty 10.0.0 → 11.0.1

data/html/created.rid

@@ -1,58 +1,51 @@
-Thu, 12 Mar 2020 09:39:01 +0100
-CHANGELOG	Thu, 12 Mar 2020 09:31:40 +0100
+Mon, 26 Jul 2021 10:33:53 +0200
+CHANGELOG	Tue, 20 Jul 2021 12:54:16 +0200
 COPYING.md	Thu, 21 Feb 2019 10:06:36 +0100
-Gemfile	Mon, 09 Mar 2020 10:29:51 +0100
-ISSUES.md	Mon, 09 Mar 2020 10:29:15 +0100
-README.md	Thu, 12 Mar 2020 09:27:39 +0100
-Rakefile	Mon, 09 Mar 2020 10:24:52 +0100
-acknowledgements.md	Mon, 09 Mar 2020 10:33:26 +0100
-authors.md	Mon, 09 Mar 2020 10:32:59 +0100
-copyright.md	Mon, 09 Mar 2020 10:31:22 +0100
-examples/avatar.rb	Mon, 09 Mar 2020 10:21:26 +0100
-examples/basics.rb	Mon, 09 Mar 2020 10:21:26 +0100
-examples/cacert.pem	Tue, 10 Mar 2020 09:54:32 +0100
-examples/profile.rb	Mon, 09 Mar 2020 10:21:26 +0100
-examples/xmlrpc.rb	Wed, 11 Mar 2020 09:02:20 +0100
+Gemfile	Thu, 07 Jan 2021 17:56:06 +0100
+README.md	Mon, 26 Jul 2021 10:27:30 +0200
+Rakefile	Thu, 07 Jan 2021 17:56:06 +0100
+copyright.md	Mon, 30 Nov 2020 11:45:38 +0100
+examples/avatar.rb	Fri, 08 Jan 2021 14:14:08 +0100
+examples/basics.rb	Fri, 08 Jan 2021 14:13:32 +0100
+examples/profile.rb	Fri, 08 Jan 2021 14:13:26 +0100
+examples/xmlrpc.rb	Fri, 08 Jan 2021 14:12:33 +0100
 gravaty.odp	Wed, 03 Sep 2014 17:27:18 +0200
 gravaty.pdf	Wed, 03 Sep 2014 17:27:18 +0200
-lib/gravaty/application.rb	Wed, 11 Mar 2020 09:07:50 +0100
-lib/gravaty/constants.rb	Mon, 09 Mar 2020 10:40:21 +0100
-lib/gravaty/locales/en.yml	Mon, 09 Mar 2020 14:01:34 +0100
-lib/gravaty/locales/it.yml	Mon, 09 Mar 2020 14:01:34 +0100
-lib/gravaty/locales/ja.yml	Mon, 09 Mar 2020 14:01:34 +0100
-lib/gravaty/parser.rb	Mon, 09 Mar 2020 10:40:21 +0100
-lib/gravaty/parsers/avatar.rb	Mon, 09 Mar 2020 12:37:08 +0100
-lib/gravaty/parsers/callback.rb	Mon, 09 Mar 2020 12:37:08 +0100
-lib/gravaty/parsers/default.rb	Mon, 09 Mar 2020 12:35:56 +0100
-lib/gravaty/parsers/force.rb	Mon, 09 Mar 2020 12:35:26 +0100
-lib/gravaty/parsers/format.rb	Mon, 09 Mar 2020 12:35:02 +0100
-lib/gravaty/parsers/pixelsize.rb	Mon, 09 Mar 2020 12:34:17 +0100
-lib/gravaty/parsers/rating.rb	Mon, 09 Mar 2020 12:34:17 +0100
-lib/gravaty/parsers/secure.rb	Mon, 09 Mar 2020 12:33:50 +0100
-lib/gravaty/parsers/type.rb	Mon, 09 Mar 2020 12:33:50 +0100
-lib/gravaty/utils/downloader.rb	Thu, 12 Mar 2020 09:36:32 +0100
-lib/gravaty/utils/raisers.rb	Mon, 09 Mar 2020 12:32:43 +0100
-lib/gravaty/utils/rfc5322.rb	Mon, 09 Mar 2020 12:32:43 +0100
-lib/gravaty/utils/rpc_connector.rb	Mon, 09 Mar 2020 12:31:27 +0100
-lib/gravaty/version.rb	Mon, 09 Mar 2020 10:39:15 +0100
-lib/gravaty.rb	Wed, 11 Mar 2020 09:07:51 +0100
-test/gravaty/locales/test_locales.rb	Wed, 11 Mar 2020 09:11:22 +0100
-test/gravaty/parsers/test_avatar.rb	Wed, 11 Mar 2020 09:18:12 +0100
-test/gravaty/parsers/test_callback.rb	Wed, 11 Mar 2020 09:18:13 +0100
-test/gravaty/parsers/test_default.rb	Wed, 11 Mar 2020 09:18:12 +0100
-test/gravaty/parsers/test_force.rb	Wed, 11 Mar 2020 09:18:12 +0100
-test/gravaty/parsers/test_format.rb	Wed, 11 Mar 2020 09:18:12 +0100
-test/gravaty/parsers/test_pixelsize.rb	Wed, 11 Mar 2020 09:18:12 +0100
-test/gravaty/parsers/test_rating.rb	Wed, 11 Mar 2020 09:18:12 +0100
-test/gravaty/parsers/test_secure.rb	Wed, 11 Mar 2020 09:18:13 +0100
-test/gravaty/parsers/test_type.rb	Wed, 11 Mar 2020 09:18:12 +0100
-test/gravaty/test_application.rb	Wed, 11 Mar 2020 09:11:22 +0100
-test/gravaty/test_avatar.rb	Wed, 11 Mar 2020 09:11:22 +0100
-test/gravaty/test_parser.rb	Wed, 11 Mar 2020 09:11:22 +0100
-test/gravaty/test_profile.rb	Wed, 11 Mar 2020 09:11:22 +0100
-test/gravaty/utils/test_downloader.rb	Wed, 11 Mar 2020 16:59:17 +0100
-test/gravaty/utils/test_raisers.rb	Wed, 11 Mar 2020 09:18:13 +0100
-test/gravaty/utils/test_rfc5322.rb	Wed, 11 Mar 2020 09:18:12 +0100
-test/gravaty/utils/test_rpc_connector.rb	Wed, 11 Mar 2020 09:18:12 +0100
-test/test_gravaty.rb	Tue, 10 Mar 2020 09:39:25 +0100
-test/test_helper.rb	Mon, 09 Mar 2020 09:02:54 +0100
+lib/gravaty/application.rb	Mon, 11 Jan 2021 11:33:10 +0100
+lib/gravaty/constants.rb	Thu, 07 Jan 2021 17:56:07 +0100
+lib/gravaty/parser.rb	Mon, 11 Jan 2021 11:03:10 +0100
+lib/gravaty/parsers/avatar.rb	Mon, 11 Jan 2021 11:04:00 +0100
+lib/gravaty/parsers/callback.rb	Fri, 08 Jan 2021 17:40:50 +0100
+lib/gravaty/parsers/default.rb	Mon, 11 Jan 2021 11:33:10 +0100
+lib/gravaty/parsers/force.rb	Fri, 08 Jan 2021 17:40:41 +0100
+lib/gravaty/parsers/format.rb	Fri, 08 Jan 2021 17:40:37 +0100
+lib/gravaty/parsers/pixelsize.rb	Fri, 08 Jan 2021 17:40:33 +0100
+lib/gravaty/parsers/rating.rb	Fri, 08 Jan 2021 17:40:30 +0100
+lib/gravaty/parsers/secure.rb	Mon, 11 Jan 2021 10:18:16 +0100
+lib/gravaty/parsers/type.rb	Fri, 08 Jan 2021 17:40:24 +0100
+lib/gravaty/utils/downloader.rb	Tue, 20 Jul 2021 13:37:58 +0200
+lib/gravaty/utils/raisers.rb	Mon, 11 Jan 2021 11:33:10 +0100
+lib/gravaty/utils/rfc5322.rb	Tue, 20 Jul 2021 13:36:47 +0200
+lib/gravaty/utils/rpc_connector.rb	Fri, 08 Jan 2021 15:03:20 +0100
+lib/gravaty/version.rb	Mon, 26 Jul 2021 10:33:01 +0200
+lib/gravaty.rb	Thu, 07 Jan 2021 17:56:07 +0100
+test/gravaty/locales/test_locales.rb	Fri, 08 Jan 2021 14:33:07 +0100
+test/gravaty/parsers/test_avatar.rb	Thu, 07 Jan 2021 17:56:09 +0100
+test/gravaty/parsers/test_callback.rb	Thu, 07 Jan 2021 17:56:09 +0100
+test/gravaty/parsers/test_default.rb	Thu, 07 Jan 2021 17:56:09 +0100
+test/gravaty/parsers/test_force.rb	Thu, 07 Jan 2021 17:56:09 +0100
+test/gravaty/parsers/test_format.rb	Thu, 07 Jan 2021 17:56:09 +0100
+test/gravaty/parsers/test_pixelsize.rb	Thu, 07 Jan 2021 17:56:09 +0100
+test/gravaty/parsers/test_rating.rb	Thu, 07 Jan 2021 17:56:09 +0100
+test/gravaty/parsers/test_secure.rb	Thu, 07 Jan 2021 17:56:09 +0100
+test/gravaty/parsers/test_type.rb	Thu, 07 Jan 2021 17:56:09 +0100
+test/gravaty/test_application.rb	Thu, 07 Jan 2021 17:56:09 +0100
+test/gravaty/test_avatar.rb	Mon, 11 Jan 2021 11:31:34 +0100
+test/gravaty/test_parser.rb	Mon, 11 Jan 2021 11:10:31 +0100
+test/gravaty/test_profile.rb	Mon, 11 Jan 2021 10:35:46 +0100
+test/gravaty/utils/test_downloader.rb	Mon, 11 Jan 2021 11:14:27 +0100
+test/gravaty/utils/test_raisers.rb	Mon, 11 Jan 2021 11:46:35 +0100
+test/gravaty/utils/test_rfc5322.rb	Mon, 11 Jan 2021 11:40:21 +0100
+test/gravaty/utils/test_rpc_connector.rb	Fri, 08 Jan 2021 14:18:46 +0100
+test/test_gravaty.rb	Thu, 07 Jan 2021 17:56:10 +0100
+test/test_helper.rb	Fri, 08 Jan 2021 12:42:56 +0100

data/html/css/rdoc.css

@@ -276,7 +276,7 @@ ul.link-list .type {
   -webkit-border-radius: 5px;
 }
 
-dl.label-list dt {
+dl.note-list dt {
   float: left;
   margin-right: 1em;
 }

data/html/index.html

@@ -4,7 +4,7 @@
 <head>
 <meta charset="UTF-8">
 
-<title>gravaty 10.0.0</title>
+<title>gravaty 11.0.1</title>
 
 <script type="text/javascript">
   var rdoc_rel_prefix = "./";
@@ -21,8 +21,6 @@
 <link href="./css/rdoc.css" rel="stylesheet">
 
 
-
-
 <body id="top" role="document" class="file">
 <nav role="navigation">
   <div id="project-navigation">
@@ -57,31 +55,17 @@
   </div>
 
   <div id="project-metadata">
-    <div id="fileindex-section" class="nav-section">
+    
+<div id="fileindex-section" class="nav-section">
   <h3>Pages</h3>
 
   <ul class="link-list">
-  
     <li><a href="./CHANGELOG.html">CHANGELOG</a>
-  
     <li><a href="./COPYING_md.html">COPYING</a>
-  
     <li><a href="./Gemfile.html">Gemfile</a>
-  
-    <li><a href="./ISSUES_md.html">ISSUES</a>
-  
     <li><a href="./README_md.html">README</a>
-  
     <li><a href="./Rakefile.html">Rakefile</a>
-  
-    <li><a href="./acknowledgements_md.html">acknowledgements</a>
-  
-    <li><a href="./authors_md.html">authors</a>
-  
     <li><a href="./copyright_md.html">copyright</a>
-  
-    <li><a href="./examples/cacert_pem.html">cacert.pem</a>
-  
   </ul>
 </div>
 
@@ -89,51 +73,28 @@
   <h3>Class and Module Index</h3>
 
   <ul class="link-list">
-  
     <li><a href="./Gravaty.html">Gravaty</a>
-  
     <li><a href="./Gravaty/Gravaty.html">Gravaty::Gravaty</a>
-  
     <li><a href="./Gravaty/ParsableDuckType.html">Gravaty::ParsableDuckType</a>
-  
     <li><a href="./Gravaty/Parser.html">Gravaty::Parser</a>
-  
     <li><a href="./Gravaty/Parsers.html">Gravaty::Parsers</a>
-  
     <li><a href="./Gravaty/Parsers/Avatar.html">Gravaty::Parsers::Avatar</a>
-  
     <li><a href="./Gravaty/Parsers/Callback.html">Gravaty::Parsers::Callback</a>
-  
     <li><a href="./Gravaty/Parsers/Default.html">Gravaty::Parsers::Default</a>
-  
     <li><a href="./Gravaty/Parsers/Force.html">Gravaty::Parsers::Force</a>
-  
     <li><a href="./Gravaty/Parsers/Format.html">Gravaty::Parsers::Format</a>
-  
     <li><a href="./Gravaty/Parsers/Pixelsize.html">Gravaty::Parsers::Pixelsize</a>
-  
     <li><a href="./Gravaty/Parsers/Rating.html">Gravaty::Parsers::Rating</a>
-  
     <li><a href="./Gravaty/Parsers/Secure.html">Gravaty::Parsers::Secure</a>
-  
     <li><a href="./Gravaty/Parsers/Type.html">Gravaty::Parsers::Type</a>
-  
     <li><a href="./Gravaty/Utils.html">Gravaty::Utils</a>
-  
     <li><a href="./Gravaty/Utils/Downloader.html">Gravaty::Utils::Downloader</a>
-  
     <li><a href="./Gravaty/Utils/Downloader/Downloader.html">Gravaty::Utils::Downloader::Downloader</a>
-  
     <li><a href="./Gravaty/Utils/Raisers.html">Gravaty::Utils::Raisers</a>
-  
     <li><a href="./Gravaty/Utils/Rfc5322.html">Gravaty::Utils::Rfc5322</a>
-  
     <li><a href="./Gravaty/Utils/RpcConnector.html">Gravaty::Utils::RpcConnector</a>
-  
     <li><a href="./Gravaty/Utils/RpcConnector/RpcConnector.html">Gravaty::Utils::RpcConnector::RpcConnector</a>
-  
     <li><a href="./Object.html">Object</a>
-  
   </ul>
 </div>
 
@@ -145,7 +106,7 @@
 <!--
 gravaty
 
-Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020  Marco Bresciani
+Copyright © 2013-2021  Marco Bresciani
 
 This file is part of gravaty.
 
@@ -161,78 +122,69 @@ more details.
 
 You should have received a copy of the GNU General Public License along
 with gravaty. If not, see <http://www.gnu.org/licenses/>.
+
+SPDX-FileCopyrightText: 2013 Marco Bresciani
+
+SPDX-License-Identifier: GFDL-1.3-or-later
 -->
 <h1 id="label-Gravaty"><a href="Gravaty.html"><code>Gravaty</code></a><span><a href="#label-Gravaty">&para;</a> <a href="#top">&uarr;</a></span></h1>
 
-<p><img src="https://img.shields.io/gem/v/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/dt/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/dtv/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/rt/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/rd/gravaty.svg?style=plastic"> <img src="https://img.shields.io/librariesio/dependent-repos/rubygems/gravaty.svg?style=plastic"></p>
+<p><img src="https://badgen.net/rubygems/n/gravaty"> <img src="https://badgen.net/rubygems/p/gravaty"> <img src="https://badgen.net/rubygems/v/gravaty"> <img src="https://badgen.net/rubygems/v/gravaty/latest"> <img src="https://badgen.net/rubygems/dt/gravaty"> <img src="https://badgen.net/rubygems/dv/gravaty"></p>
 
-<p>Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Marco Bresciani</p>
+<p><img src="https://img.shields.io/gem/rt/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/rd/gravaty.svg?style=plastic"> <img src="https://img.shields.io/librariesio/dependent-repos/rubygems/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/u/MarcoBresciani?style=plastic"> <img src="https://img.shields.io/security-headers?style=plastic&url=https%3A%2F%2Fsavannah.nongnu.org%2Fprojects%2Faamfp"> <img src="https://img.shields.io/hsts/preload/savannah.nongnu.org?style=plastic"> <img src="https://img.shields.io/mozilla-observatory/grade/savannah.nongnu.org?publish&style=plastic"> <img src="https://img.shields.io/website?style=plastic&url=https%3A%2F%2Fsavannah.nongnu.org%2Fprojects%2Faamfp"></p>
 
-<p>This file is part of gravaty.</p>
+<p><img src="https://img.shields.io/security-headers?style=plastic&url=https%3A%2F%2Fsavannah.nongnu.org%2Fprojects%2Faamfp"> <img src="https://img.shields.io/hsts/preload/savannah.nongnu.org?style=plastic"> <img src="https://img.shields.io/mozilla-observatory/grade/savannah.nongnu.org?publish&style=plastic"> <img src="https://img.shields.io/website?style=plastic&url=https%3A%2F%2Fsavannah.nongnu.org%2Fprojects%2Faamfp"></p>
 
-<p>gravaty is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.</p>
-
-<p>gravaty is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p>
-
-<p>You should have received a copy of the GNU General Public License along with gravaty. If not, see <a href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/.</p>
-
-<h2 id="label-Description">Description<span><a href="#label-Description">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<p><a href="https://github.com/RichardLitt/standard-readme"><img src="https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=plastic"></a> <a href="https://github.com/rubocop-hq/rubocop"><img src="https://img.shields.io/badge/code_style-rubocop-brightgreen.svg"></a> <a href="https://rubystyle.guide"><img src="https://img.shields.io/badge/code_style-community-brightgreen.svg"></a> <a href="https://api.reuse.software/info/git.fsfe.org/reuse/api"><img src="https://api.reuse.software/badge/git.fsfe.org/reuse/api"></a></p>
 
 <p>This gem automagically prepares complete URIs for Gravatar, for both avatars and profiles, with all currently supported options, included the XML-RPC API, as of 2019-04-23, starting from a single email address!</p>
 
-<p>It&#39;s my first &#39;real&#39; Ruby gem, hoping it will be useful for someone (let me know if you use it, please!).</p>
+<p>It&#39;s my first Ruby gem, hoping it will be useful for someone (let me know if you use it, please!). GNU GPLv3 license; source code available through anonymous checkout: <code>hg clone http://hg.savannah.nongnu.org/hgweb/gravaty/</code> or write me, and I&#39;ll send it. You can even decide to contribute to this little free software project by registering to Savannah and ask to be part of the <code>gravaty</code> project!</p>
 
-<p>GNU GPLv3 license; source code available through anonymous checkout: <code>hg clone http://hg.savannah.nongnu.org/hgweb/gravaty/</code> or write me and I&#39;ll send it.</p>
-
-<p>You can even decide to contribute to this little free software project by registering to Savannah and ask to be part of the &#39;gravaty&#39; project!</p>
+<h2 id="label-Table+of+Contents">Table of Contents<span><a href="#label-Table+of+Contents">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<ul><li>
+<p><a href="#background">Background</a></p>
+</li><li>
+<p><a href="#install">Install</a></p>
+</li><li>
+<p><a href="#savannah">Savannah</a></p>
+</li><li>
+<p><a href="#rubygems">RubyGems</a></p>
+</li><li>
+<p><a href="#usage">Usage</a></p>
+</li><li>
+<p><a href="#maintainers">Maintainers</a></p>
+</li><li>
+<p><a href="#thanks">Thanks</a></p>
+</li><li>
+<p><a href="#contributing">Contributing</a></p>
+</li><li>
+<p><a href="#license">License</a></p>
+</li></ul>
 
-<p>With great contributions from: 新部裕, Peter R. Marreck, Jon Maken, Łukasz Niemier.</p>
+<h2 id="label-Background">Background<span><a href="#label-Background">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
-<h2 id="label-Documentation">Documentation<span><a href="#label-Documentation">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<p>This gem automagically prepares complete URIs for Gravatar, for both avatars and profiles, with all currently supported options, included the XML-RPC API, as of 2019-04-23, starting from a single email address!</p>
 
-<p><a href="Gravaty.html"><code>Gravaty</code></a> tries to follow semantic versioning (see <a href="http://semver.org">semver.org</a>/). There may be backward incompatible changes each time minor version number changes, but that any tiny version number change should be bug fixes and internal changes only. Be sure to read the <a href="CHANGELOG.html">CHANGELOG</a> each time we cut a new release and lock your gems accordingly.</p>
+<p>It&#39;s my first Ruby gem, hoping it will be useful for someone (let me know if you use it, please!).</p>
 
-<p>RDoc documentation available in the html folder.</p>
+<p>GNU GPLv3 license; source code available through anonymous checkout: <code>hg clone http://hg.savannah.nongnu.org/hgweb/gravaty/</code> or write me, and I&#39;ll send it.</p>
 
-<h3 id="label-Installing+Gravaty">Installing <a href="Gravaty.html"><code>Gravaty</code></a><span><a href="#label-Installing+Gravaty">&para;</a> <a href="#top">&uarr;</a></span></h3>
+<p>You can even decide to contribute to this little free software project by registering to Savannah and ask to be part of the <code>gravaty</code> project!</p>
 
-<p>RubyGems is the preferred easy install method for <a href="Gravaty.html"><code>Gravaty</code></a>. <a href="Gravaty.html"><code>Gravaty</code></a> is intended to be installed via the <a href="http://rubyforge.org/projects/rubygems/">RubyGems</a> system. To get the latest version, simply enter the following into your command prompt: <code>gem install gravaty</code>.</p>
+<p>With great contributions from: 新部裕, Peter R. Marreck, Jon Maken, Łukasz Niemier.</p>
 
-<p><em>NOTE</em>: for both examples and tests, you may need to set a SSL certificate file. In Microsoft Windows environment, the easiest way is as described by the downloader gist. You have to download the certificates from <a href="http://curl.haxx.se/ca/cacert.pem">curl.haxx.se/ca/cacert.pem</a> (for example) and, for example, put the cacert.pem file in the gravaty home directory. Then <code>set SSL_CERT_FILE=</code>{FULL_PATH}<code>\cacert.pem</code> and finally try to run <code>ruby avatar.rb</code> or <code>ruby profiles.rb</code> from the <code>examples</code> directory; both examples should download two files each! The same environment variable would be needed to run the tests against the XML-RPC API.</p>
+<h2 id="label-Install">Install<span><a href="#label-Install">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
-<h3 id="label-Supported+Ruby+Versions+and+Implementations">Supported Ruby Versions and Implementations<span><a href="#label-Supported+Ruby+Versions+and+Implementations">&para;</a> <a href="#top">&uarr;</a></span></h3>
+<p>RubyGems is the preferred easy install method for <a href="Gravaty.html"><code>Gravaty</code></a>. <a href="Gravaty.html"><code>Gravaty</code></a> should be installed via the <a href="http://rubyforge.org/projects/rubygems/">RubyGems</a> system. To get the latest version, simply enter the following into your command prompt: <code>gem install gravaty</code>.</p>
 
 <p>Because <a href="Gravaty.html"><code>Gravaty</code></a> is pure Ruby, it should run pretty much anywhere, including Rubinius, JRuby, MacRuby, etc. Officially the support is for &gt;= 2.7 YARV/KRI.</p>
 
-<h3 id="label-Support">Support<span><a href="#label-Support">&para;</a> <a href="#top">&uarr;</a></span></h3>
-
-<p>The easiest way to get help with <a href="Gravaty.html"><code>Gravaty</code></a> is to post a message to the mailing list: <code>http://lists.nongnu.org/mailman/listinfo/gravaty-users</code>.</p>
-
-<p>Feel free to post any question there, developers are responsive and will be happy to help you figure out how to use <a href="Gravaty.html"><code>Gravaty</code></a>, or help you determine whether it&#39;s the right tool for the task you are working on.</p>
-
-<p>Please make your posts to the list as specific as possible, including code samples and output where relevant. Do not post any information that should not be shared publicly, and be sure to reduce your example code as much as possible so that those who are responding to your question can more easily see what the issue might be.</p>
-
-<h3 id="label-Contributing">Contributing<span><a href="#label-Contributing">&para;</a> <a href="#top">&uarr;</a></span></h3>
-
-<p>If you&#39;ve found a bug, want to submit a patch, or have a feature request, please enter a ticket into our bug tracker: <code>https://savannah.nongnu.org/bugs/?func=additem&group=gravaty</code>.</p>
-
-<p>We strongly encourage bug reports to come with failing tests or at least a reduced example that demonstrates the problem.</p>
-
-<p>Similarly, patches should include tests, API documentation, and an update to the manual where relevant. Feel free to clone early though and participate in the project, if you just want some feedback or a code review before preparing your code to be merged.</p>
-
-<p>If you are unsure about whether or not you&#39;ve found a bug, or want to check to see whether we&#39;d be interested in the feature you want to add before you start working on it, feel free to post to our mailing list.</p>
-
-<h3 id="label-License">License<span><a href="#label-License">&para;</a> <a href="#top">&uarr;</a></span></h3>
-
-<p><a href="Gravaty.html"><code>Gravaty</code></a> is released under GNU GPL v3 license: if you wish to contribute to <a href="Gravaty.html"><code>Gravaty</code></a>, you will retain your own <a href="copyright_md.html">copyright</a> but must agree to license your code under the same terms as the project itself (or any compatible license according to <a href="http://www.gnu.org/licenses/license-list.en.html#GPLCompatibleLicenses">GPL-Compatible Free Software Licenses</a>).</p>
-
-<h3 id="label-Links">Links<span><a href="#label-Links">&para;</a> <a href="#top">&uarr;</a></span></h3>
-
 <h4 id="label-Savannah">Savannah<span><a href="#label-Savannah">&para;</a> <a href="#top">&uarr;</a></span></h4>
 <ul><li>
 <p>Project page: <a href="https://savannah.nongnu.org/projects/gravaty">savannah.nongnu.org/projects/gravaty</a>/</p>
 </li><li>
-<p>Source code (Mercurial) repository:  <a href="http://hg.savannah.gnu.org/hgweb/gravaty">hg.savannah.gnu.org/hgweb/gravaty</a>/</p>
+<p>Source code (Mercurial) repository: <a href="http://hg.savannah.gnu.org/hgweb/gravaty">hg.savannah.gnu.org/hgweb/gravaty</a>/</p>
 </li><li>
 <p>Known Bugs: <a href="https://savannah.nongnu.org/bugs/?group=gravaty">savannah.nongnu.org/bugs/?group=gravaty</a></p>
 </li><li>
@@ -250,42 +202,75 @@ with gravaty. If not, see <http://www.gnu.org/licenses/>.
 <p>Gem updates Atom Feed:  <a href="https://rubygems.org/gems/gravaty/versions.atom">rubygems.org/gems/gravaty/versions.atom</a></p>
 </li></ul>
 
-<h4 id="label-Other+links">Other links<span><a href="#label-Other+links">&para;</a> <a href="#top">&uarr;</a></span></h4>
+<h2 id="label-Usage">Usage<span><a href="#label-Usage">&para;</a> <a href="#top">&uarr;</a></span></h2>
+
+<p>See <code>examples</code> folder. To run the examples just run <code>ruby</code>{EXAMPLE_NAME}<code>.rb</code>.</p>
+
+<blockquote>
+<p><strong>NOTE</strong>: for both examples and tests, you need to set a SSL certificate file. In Microsoft Windows environment, the easiest way is the one described by the downloader gist I&#39;m using: you can download valid certificates from <a href="http://curl.haxx.se/ca/cacert.pem">curl.haxx.se/ca/cacert.pem</a> and put the downloaded file in the gravaty home directory. Then <code>set SSL_CERT_FILE=</code>{FULL FILE PATH HERE}<code>cacert.pem</code> and finally run <code>ruby avatar.rb</code> or <code>ruby profiles.rb</code> from the <code>examples</code> directory; both examples should download two files each! The same environment variable would be needed to run the tests against the XML-RPC API. Running the examples you&#39;ll see both the example description and correct code usage to perform such action.</p>
+</blockquote>
+
+<p>Using this API is pretty simple. First, remember that this API maintains a context, so you can save your preferred configuration of server, dictionary, output formats, … by assigning those value to your object. Get a reference to the <a href="Gravaty.html"><code>Gravaty</code></a> object, through its factory method, with <code>my_gravaty = Gravaty::gravatize your_em@il.address</code> using your email address as parameter. This will save a <a href="Gravaty.html"><code>Gravaty</code></a> instance in your <code>my_gravaty</code> object. At this point the object does contain a default configuration in terms of avatar, profile, …</p>
+
+<p>You can take a look at the current status/configuration of your <code>my_gravaty</code> object using the <code>email</code> method <code>my_gravaty.email</code> that shows the email currently in use, or using the <code>digest</code> method <code>my_gravaty.digest</code> that shows the MD5 digest of the downcased email address in use. Also, <code>to_s</code> method is also available to print the current status of the <code>my_gravaty</code> object and each <code>Gravaty</code> is a Comparable object, based on <code>my_gravaty.email</code> data, your email address in small capital letters.</p>
+
+<p>The <code>avatar</code> method provides the configuration-specific URI for your avatar: <code>my_gravaty.avatar</code> returns <code>https://secure.avatar.com/avatar/HASH</code> (where <code>HASH</code> is your <code>my_gravaty.digest</code> email address MD5 digest) ● The method allows an Hash, with avatar configuration parameters: type, pixel_size, force, secure, rating, default. (see <a href="https://en.gravatar.com/site/implement/images">en.gravatar.com/site/implement/images</a>/ for details) ● The avatar! method saves the provided configuration for your <a href="Gravaty.html"><code>Gravaty</code></a> object&#39;s to_s output.</p>
+
+<p>The profile content feature ● With your <a href="Gravaty.html"><code>Gravaty</code></a> object available, the profile method provides the configuration-specific URI for your ( registered) user: – a_gravaty.profile returns <a href="https://secure.avatar.com/HASH">secure.avatar.com/HASH</a> (where HASH is your a_gravaty.digest email address MD5 digest) ● The method allows an Hash, with profile configuration parameters: format, secure. (see <a href="https://en.gravatar.com/site/implement/profiles">en.gravatar.com/site/implement/profiles</a>/ for details) ● The profile! method saves the provided configuration for your <a href="Gravaty.html"><code>Gravaty</code></a> object&#39;s to_s output.</p>
+
+<p>The XML-RPC API content feature ● With your <a href="Gravaty.html"><code>Gravaty</code></a> object available, the xmlrpc method provides a reference to the remote Gravatar XML-RPC AP, for your (registered) user: – a_gravaty.xmlrpc requires the method name (grav.test, by default), your password and possible method parameters (whether needed) via a Hash. ● In order to increase security, the password is not saved inside the <a href="Gravaty.html"><code>Gravaty</code></a> object but has to be provided for each call; (see <a href="https://en.gravatar.com/site/implement/xmlrpc">en.gravatar.com/site/implement/xmlrpc</a>/ for details) ● Communication happens through SSL: certificate might be required (see gravaty <a href="README_md.html">README.md</a> file).</p>
+
+<p>Additional features (1/2) ● Since QRCode and JSON are becoming popular formats, qr and json methods (together with qr! and json!) allows to directly retrieve the user&#39;s profile data URI, in QRCode or JSON format, with format-specific parameters. Examples: – a_gravaty.qr pixel_size: 42 – a_gravaty.json! callback: &#39;my_method&#39; ● The qr! and json! methods save the provided configuration for your <a href="Gravaty.html"><code>Gravaty</code></a> object&#39;s to_s output. ● a_gravaty.qr corresponds to a_gravaty.profile format: &#39;qr&#39; while a_gravaty.json corresponds to a_gravaty.profile format: &#39; json&#39; and they both filtered the allowed parameters according to the output type.</p>
+
+<p>Additional features (2/2) ● When using the &#39;banged&#39; (!) methods (avatar! or profile!, same for qr! and json!), the built URI is saved inside the <a href="Gravaty.html"><code>Gravaty</code></a> object and is read-only available through to_s. ● The download method, simply specifying a filename as parameter, retrieves whatever resource is indicate by such internal status and saves its content in the specified file. Example: – a_gravaty.qr! – a_gravaty.download &#39;myQr.png&#39; ● The reset method clears the internal status restoring the email address output of to_s.</p>
+
+<h2 id="label-Maintainers">Maintainers<span><a href="#label-Maintainers">&para;</a> <a href="#top">&uarr;</a></span></h2>
 <ul><li>
-<p>Gravatar: <a href="https://www.gravatar.com">www.gravatar.com</a>.</p>
-</li><li>
-<p>FSIJ (フリーソフトウェアイニシアティブ, Free Software Initiative of  Japan): <a href="http://www.fsij.org">www.fsij.org</a>.</p>
+<p><a href="https://savannah.nongnu.org/users/marcobresciani">Marco Bresciani</a></p>
+</li></ul>
+
+<h2 id="label-Thanks">Thanks<span><a href="#label-Thanks">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<ul><li>
+<p>*  Contributor*: <a href="http://www.csse.monash.edu.au/~jwb/index.html">Jim Breen</a></p>
 </li><li>
-<p>“RFC 5322 Email Validation Regex in Ruby Regular Expressions” gist by  Peter R. Marreck: <a href="https://gist.github.com/pmarreck/4626713">gist.github.com/pmarreck/4626713</a>.</p>
+<p><em>Author</em>: <a href="lumbergh@gmail.com">Peter R. Marreck</a>, <a href="https://gist.github.com/pmarreck/4626713">RFC 5322 Email Validation Regex in Ruby Regular Expressions</a>.  About <em>RFC 5322 Email Validation Regex in Ruby Regular Expressions</em>,  please note that “This work is released under the BSD 3-Clause  License”.  This license is GNU GPLv3 compatible according to  <a href="http://www.gnu.org/licenses/license-list.en.html#ModifiedBSD">www.gnu.org/licenses/license-list.en.html#ModifiedBSD</a>.</p>
 </li><li>
-<p>“An HTTP/HTTPS/FTP file downloader library/CLI based upon  MiniPortile&#39;s HTTP implementation.” gist by Jon Maken:  <a href="https://gist.github.com/jonforums/2202048">gist.github.com/jonforums/2202048</a>.</p>
+<p><em>Author</em>: <a href="mailto:jon.forums@gmail.com">Jon Maken</a>, <a href="https://gist.github.com/jonforums/2202048">An HTTP/HTTPS/FTP file downloader library/CLI based upon MiniPortile’s HTTP implementation.</a>.  About <em>An HTTP/HTTPS/FTP file downloader library/CLI based upon  MiniPortile&#39;s HTTP implementation</em>, please note that “License:  3-clause BSD”.  This license is GNU GPLv3 compatible according to  <a href="http://www.gnu.org/licenses/license-list.en.html#ModifiedBSD">www.gnu.org/licenses/license-list.en.html#ModifiedBSD</a>.</p>
 </li></ul>
 
-<h3 id="label-Usage+Examples">Usage Examples<span><a href="#label-Usage+Examples">&para;</a> <a href="#top">&uarr;</a></span></h3>
+<p>FSIJ理事会の理事長、<a href="mailto:gniibe@fsij.org">新部裕</a>さんの日本語の翻訳。 Japanese translation by <a href="mailto:gniibe@fsij.org">Yutaka Niibe</a>, President of Free Software Initiative of Japan.</p>
+
+<p>Thanks to <a href="https://za.linkedin.com/in/marcheiligers/">Marc Heiligers</a> for the note about Peter R. Marreck&#39;s gist.</p>
+
+<p>Thanks to <a href="http://lukasz.niemier.pl/">Łukasz Niemier</a> for his suggestions on possible improvements.</p>
+
+<h2 id="label-Contributing">Contributing<span><a href="#label-Contributing">&para;</a> <a href="#top">&uarr;</a></span></h2>
+
+<p><a href="Gravaty.html"><code>Gravaty</code></a> tries to follow semantic versioning (see <a href="http://semver.org">semver.org</a>/). There may be backward incompatible changes each time minor version number changes, but that any tiny version number change should be bug fixes and internal changes only. Be sure to read the <code>CHANGELOG</code> each time we cut a new release and lock your gems accordingly.</p>
 
-<p>See <code>examples</code> folder. To run the examples just type go into the <code>examples</code> directory and run <code>ruby</code>{EXAMPLE_NAME}<code>.rb</code>. Running the examples you&#39;ll see both the example description and correct code usage to perform such action. Here below are listed the currently available examples: * The <code>basics.rb</code> example (run <code>ruby basics.rb</code>) shows how to initialize  and use a <a href="Gravaty.html"><code>Gravaty</code></a> object through the <code>gravatize</code> factory method; * The <code>avatar.rb</code> example (run <code>ruby avatar.rb</code>) shows how to ask for an  avatar image through Gravatar (free) service, with all available  options and configurations.  It will also show how to download such images; * The <code>profile.rb</code> example (run <code>ruby profile.rb</code>) shows how to ask for  profile data through Gravatar (free) service, with all available  options and configurations.  It will also show how to download such data. * The <code>xmlrpc.rb</code> example (run <code>ruby xmlrpc.rb</code>) shows how to use the  XML-RPC API through Gravatar (free) service, with all available  options and configurations.  This need a valid username and password to work properly.</p>
+<p>RDoc documentation available in the <code>html</code> folder.</p>
 
-<h2 id="label-Gravatar+Terms+of+Service">Gravatar Terms of Service<span><a href="#label-Gravatar+Terms+of+Service">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<p>The easiest way to get help with <a href="Gravaty.html"><code>Gravaty</code></a> is to post a message to the mailing list: <code>http://lists.nongnu.org/mailman/listinfo/gravaty-users</code>.</p>
+
+<p>Feel free to post any question there, developers are responsive and will be happy to help you figure out how to use <a href="Gravaty.html"><code>Gravaty</code></a>, or help you determine whether it&#39;s the right tool for the task you are working on.</p>
+
+<p>Please make your posts to the list as specific as possible, including code samples and output where relevant. Do not post any information that should not be shared publicly, and be sure to reduce your example code as much as possible so that those who are responding to your question can more easily see what the issue might be.</p>
 
-<p><em>Here follows the unmodified 2020-03-12 09:22 CEST version of Gravatar site terms of service, titled “Gravatar Terms of Use”. For the most updated version, please refer to <a href="https://secure.gravatar.com/site/terms-of-service">secure.gravatar.com/site/terms-of-service</a> in order to know how to properly use computer gravatars.</em></p>
+<p>If you&#39;ve found a bug, want to submit a patch, or have a feature request, please enter a ticket into our bug tracker: <code>https://savannah.nongnu.org/bugs/?func=additem&group=gravaty</code>.</p>
 
-<p>Gravatar Terms of Use</p>
+<p>We strongly encourage adding bug reports with failing tests or at least a reduced example that demonstrates the problem.</p>
 
-<p>PLEASE READ THESE GRAVATAR TERMS OF USE (“GRAVATAR TERMS”) CAREFULLY BEFORE ACCESSING OR USING ANY PART OF THE SERVICES OR WEBSITE. BY USING THE SERVICES OR WEBSITE IN ANY MANNER, YOU AGREE THAT YOU HAVE READ AND AGREE TO BECOME BOUND BY THE GRAVATAR TERMS. IF THE GRAVATAR TERMS ARE CONSIDERED AN OFFER, ACCEPTANCE IS EXPRESSLY LIMITED TO SUCH TERMS. IF YOU DO NOT UNCONDITIONALLY AGREE TO ALL THE TERMS AND CONDITIONS OF THE GRAVATAR TERMS, YOU HAVE NO RIGHT TO USE ANY PORTION OF THE SERVICES OR WEBSITE.</p>
+<p>Similarly, patches should include tests, API documentation, and an update to the manual where relevant. Feel free to clone early though and participate in the project, if you just want some feedback, or a code review before preparing your code to be merged.</p>
 
-<p>The Gravatar Terms govern the terms and conditions under which you may use the website located at <a href="www.gravatar.com">www.gravatar.com</a> and related services by Automattic, including without limitation, the user accounts, profiles, avatars, technology, and other content and materials offered on or through that website (collectively, “Services”, and each of which shall be deemed a “Website” for purposes of the Terms of Service (defined below)). The Gravatar Terms supplement the Terms of Service located at <a href="http://wordpress.com/tos">wordpress.com/tos</a>/ (the “Terms of Service”), including without limitation, the Responsibilities of Website Visitors, all warranty disclaimers, limitations of liability, and dispute resolution provisions therein, which shall apply to the subject matter of these Gravatar Terms, and which are incorporated herein by this reference. If there is any conflict between the Gravatar Terms and the Terms of Service, the Gravatar Terms will govern. All capitalized terms that are not defined herein have the meaning specified in the Terms of Service.&#39;);</p>
+<p>If you are unsure about whether you&#39;ve found a bug, or want to check to see whether we&#39;d be interested in the feature you want to add before you start working on it, feel free to post to our mailing list.</p>
 
-<p>Automattic may update the Gravatar Terms from time to time. Your continued use of the Services following notification of such updates constitutes your acceptance of those changes.</p>
-<ol><li>
-<p>User Submissions.  The Services may provide you with the ability to create, upload,  distribute or post (“Submit(ting)”) data, photographs, avatars,  software, graphics, profile and other information to the Services  (collectively, the “User Submissions”).  By Submitting User Submissions, you acknowledge that you are  publishing that User Submission, and that you may be identified  publicly by your avatar and other User Submissions (e.g., in  connection with your blogs, comments and/or email address) by  Automattic, third party Gravatar-enabled websites (as that term in  defined below), and others.  More specifically, you hereby do and shall grant to Automattic a  worldwide, perpetual, irrevocable, royalty-free and fully-paid,  transferable (including rights to sublicense) right to perform the  Services (e.g., to use, modify, reproduce, distribute, prepare  derivative works of, display, perform, and otherwise fully exercise  and exploit all intellectual property, publicity, and moral rights  with respect to any User Submissions, and to allow others to do so).</p>
-</li></ol>
+<h2 id="label-License">License<span><a href="#label-License">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
-<p>By Submitting, you agree to be solely responsible for the User  Submissions and release Automattic from any liability related to  your use of the Services.  You warrant, represent and agree that you will not Submit any User  Submissions or otherwise use the Services in a manner that (i)  infringes the intellectual property or proprietary rights, or rights  of publicity or privacy, of any third party; (ii) violates any law,  statute, ordinance or regulation; or (iii) is harmful, threatening,  abusive, harassing, tortuous, defamatory, vulgar, obscene, libelous,  or otherwise objectionable.  You understand that Automattic shall not be responsible or liable for  controlling or editing any User Submission, for any errors or  omissions in any User Submission, for any damage or loss caused or  alleged to be caused by or in connection with the use of or reliance  on any User Submission; nor can Automattic ensure prompt removal of  inappropriate or unlawful content or guarantee the identity of any  other users or websites with whom you may interact in the course of  using the Services. 2. Use of the Services by Third Party Websites.  Third party websites may enable the use of the Services on their  respective websites as expressly authorized by Automattic (e.g., API  calls into Gravatar: <a href="http://en.gravatar.com/site/implement">en.gravatar.com/site/implement</a>); provided  that they (i) do not copy, store or modify User Submissions; (ii) do  not distribute, display, perform, use or otherwise exercise or  exploit any User Submission or other user information for any purpose  other than as necessary to perform the Services for the applicable  user; (iii) have a privacy policy in effect and posted on such  website that complies with all applicable laws and regulations and  that notifies such user that it will only use personally identifiable  information as set forth in (ii) above; and (iv) agree to be bound by  and comply with all the terms, conditions, and limitations set forth  in the Terms of Service (“Gravatar-enabled website”).</p>
-<hr>
+<p>SPDX-FileCopyrightText: 2013 Marco Bresciani</p>
 
-<p>gravaty</p>
+<p>SPDX-License-Identifier: GFDL-1.3-or-later</p>
 
-<p>Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Marco Bresciani</p>
+<p>Copyright © 2013-2021 Marco Bresciani</p>
 
 <p>This file is part of gravaty.</p>
 
@@ -295,14 +280,12 @@ with gravaty. If not, see <http://www.gnu.org/licenses/>.
 
 <p>You should have received a copy of the GNU General Public License along with gravaty. If not, see <a href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/.</p>
 
-
 </main>
 
 
-
 <footer id="validator-badges" role="contentinfo">
   <p><a href="https://validator.w3.org/check/referer">Validate</a>
-  <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.1.
+  <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.3.0.
   <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
 </footer>