rel notes: ruby version

CHANGELOG.md

@@ -13,7 +13,7 @@
   * Breaking Changes:
     * **global** : Options `transpose_single` and `multi_table` replaced with single option `multi_single` and values: `no`, `yes`, `single`.
     * **global** : Column name for single object is now `field` instead of `key`.
-    * **global** : Ruby minimum versions is now 2.7 instead of 2.6 (that removes macOS default ruby support)
+    * **global** : Ruby minimum versions is now 2.7 (2.6 previously, that removes macOS default ruby support, but newer ruby version can be installed on macOS)
 
 * 4.20.0
 

README.md

@@ -322,15 +322,17 @@ rubyinstaller-devkit-3.2.2-1-x64.exe /silent /currentuser /noicons /dir=C:\asper
 
 #### macOS: `brew`
 
-**macOS** come with Ruby.
-Nevertheless, [Apple has deprecated it](https://developer.apple.com/documentation/macos-release-notes/macos-catalina-10_15-release-notes), and it will be removed in the future, so better not to rely on it.
+**macOS** comes with Ruby.
+Nevertheless, it is an old unsupported version and [Apple has deprecated it](https://developer.apple.com/documentation/macos-release-notes/macos-catalina-10_15-release-notes), and it will be removed in the future, so better not to rely on it.
 
-The recommended way is to either user `RVM` or use [Homebrew](https://brew.sh/).
+The recommended way is to either use [Homebrew](https://brew.sh/) or [RVM](https://rvm.io/).
 
 ```bash
 brew install ruby
 ```
 
+This installs a recent ruby suitable for `ascli`.
+
 #### Linux: Package
 
 If your Linux distribution provides a standard Ruby package, you can use it provided that the version supported.

docs/Manual.html

@@ -323,14 +323,17 @@ <h3 data-number="3.1.2" id="windows-installer"><span
 class="sourceCode bat"><code class="sourceCode dosbat"><span id="cb21-1"><a href="#cb21-1" aria-hidden="true" tabindex="-1"></a>rubyinstaller-devkit-3.2.2-1-x64.exe <span class="at">/silent</span> <span class="at">/currentuser</span> <span class="at">/noicons</span> <span class="at">/dir</span>=C:\aspera-cli</span></code></pre></div>
 <h3 data-number="3.1.3" id="macos-brew"><span
 class="header-section-number">3.1.3</span> macOS: <code>brew</code></h3>
-<p><strong>macOS</strong> come with Ruby. Nevertheless, <a
+<p><strong>macOS</strong> comes with Ruby. Nevertheless, it is an old
+unsupported version and <a
 href="https://developer.apple.com/documentation/macos-release-notes/macos-catalina-10_15-release-notes">Apple
 has deprecated it</a>, and it will be removed in the future, so better
 not to rely on it.</p>
-<p>The recommended way is to either user <code>RVM</code> or use <a
-href="https://brew.sh/">Homebrew</a>.</p>
+<p>The recommended way is to either use <a
+href="https://brew.sh/">Homebrew</a> or <a
+href="https://rvm.io/">RVM</a>.</p>
 <div class="sourceCode" id="cb22"><pre
 class="sourceCode bash"><code class="sourceCode bash"><span id="cb22-1"><a href="#cb22-1" aria-hidden="true" tabindex="-1"></a><span class="ex">brew</span> install ruby</span></code></pre></div>
+<p>This installs a recent ruby suitable for <code>ascli</code>.</p>
 <h3 data-number="3.1.4" id="linux-package"><span
 class="header-section-number">3.1.4</span> Linux: Package</h3>
 <p>If your Linux distribution provides a standard Ruby package, you can

docs/README.erb.md

@@ -316,15 +316,17 @@ rubyinstaller-devkit-3.2.2-1-x64.exe /silent /currentuser /noicons /dir=C:\asper
 
 #### macOS: `brew`
 
-**macOS** come with Ruby.
-Nevertheless, [Apple has deprecated it](https://developer.apple.com/documentation/macos-release-notes/macos-catalina-10_15-release-notes), and it will be removed in the future, so better not to rely on it.
+**macOS** comes with Ruby.
+Nevertheless, it is an old unsupported version and [Apple has deprecated it](https://developer.apple.com/documentation/macos-release-notes/macos-catalina-10_15-release-notes), and it will be removed in the future, so better not to rely on it.
 
-The recommended way is to either user `RVM` or use [Homebrew](https://brew.sh/).
+The recommended way is to either use [Homebrew](https://brew.sh/) or [RVM](https://rvm.io/).
 
 ```bash
 brew install ruby
 ```
 
+This installs a recent ruby suitable for <%=tool%>.
+
 #### Linux: Package
 
 If your Linux distribution provides a standard Ruby package, you can use it provided that the version supported.