Update User Guide

Author: actions-user

changelogs/v4.7.3.html

@@ -316,8 +316,8 @@ <h2><a class="toc-backref" href="#id2" role="doc-backlink">Message Changes</a><a
 <h2><a class="toc-backref" href="#id3" role="doc-backlink">Changes</a><a class="headerlink" href="#changes" title="Link to this heading"></a></h2>
 <ul class="simple">
 <li><dl class="simple">
-<dt><strong>Commands:</strong> The <code class="docutils literal notranslate"><span class="pre">-h</span></code> option for the <code class="docutils literal notranslate"><span class="pre">routes</span></code> command is renamed to <code class="docutils literal notranslate"><span class="pre">--handler</span></code> to avoid conflict with the common use of <code class="docutils literal notranslate"><span class="pre">-h</span></code> as a shortcut for <code class="docutils literal notranslate"><span class="pre">--help</span></code>.</dt><dd><p>The old <code class="docutils literal notranslate"><span class="pre">-h</span></code> option will continue to work until v4.8.0, at which point it will be removed and repurposed as a shortcut for <code class="docutils literal notranslate"><span class="pre">--help</span></code>.
-A warning message is displayed when using the old <code class="docutils literal notranslate"><span class="pre">-h</span></code> option to encourage users to switch to the new <code class="docutils literal notranslate"><span class="pre">--handler</span></code> option.</p>
+<dt><strong>Commands:</strong> The <code class="docutils literal notranslate"><span class="pre">-h</span></code> option for the <code class="docutils literal notranslate"><span class="pre">routes</span></code> command is renamed to <code class="docutils literal notranslate"><span class="pre">--sort-by-handler</span></code> to avoid conflict with the common use of <code class="docutils literal notranslate"><span class="pre">-h</span></code> as a shortcut for <code class="docutils literal notranslate"><span class="pre">--help</span></code>.</dt><dd><p>The old <code class="docutils literal notranslate"><span class="pre">-h</span></code> option will continue to work until v4.8.0, at which point it will be removed and repurposed as a shortcut for <code class="docutils literal notranslate"><span class="pre">--help</span></code>.
+A warning message is displayed when using the old <code class="docutils literal notranslate"><span class="pre">-h</span></code> option to encourage users to switch to the new <code class="docutils literal notranslate"><span class="pre">--sort-by-handler</span></code> option.</p>
 </dd>
 </dl>
 </li>

incoming/routing.html

@@ -1694,8 +1694,8 @@ <h4><a class="toc-backref" href="#id70" role="doc-backlink">Auto Routing (Legacy
 <div class="versionadded">
 <p><span class="versionmodified added">Added in version 4.3.0.</span></p>
 </div>
-<p>You can sort the routes by <em>Handler</em>:</p>
-<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">php spark routes -h</span>
+<p>You can sort the routes by <em>handler</em>:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">php spark routes --sort-by-handler</span>
 </pre></div>
 </div>
 </section>