update

index.html

@@ -966,7 +966,7 @@ <h2 id="usage"><a class="link" href="#usage">Usage</a></h2>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre>Babashka v1.3.179
+<pre>Babashka v1.3.181
 
 Usage: bb [svm-opts] [global-opts] [eval opts] [cmdline args]
 or:    bb [svm-opts] [global-opts] file [cmdline args]
@@ -2198,6 +2198,9 @@ <h3 id="_task_local_options"><a class="link" href="#_task_local_options">Task-lo
 <li>
 <p><code>:enter</code>, <code>:leave</code>: override the global <code>:enter</code>/<code>:leave</code> hook.</p>
 </li>
+<li>
+<p><code>:override-builtin</code>: override the name of a built-in babashka command.</p>
+</li>
 </ul>
 </div>
 </div>
@@ -2875,6 +2878,24 @@ <h4 id="_conflicting_file_task_subcommand_names"><a class="link" href="#_conflic
 </li>
 </ul>
 </div>
+<div class="paragraph">
+<p>When choosing a task name that overrides a babashka builtin subcommand, you have
+to provide the <code>:override-builtin</code> option to get rid of the warning that appears
+when running babashka:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="rouge highlight"><code data-lang="clojure"><span class="n">$</span><span class="w"> </span><span class="n">bb</span><span class="w"> </span><span class="n">-Sdeps</span><span class="w"> </span><span class="o">'</span><span class="p">{</span><span class="no">:tasks</span><span class="w"> </span><span class="p">{</span><span class="n">help</span><span class="w"> </span><span class="p">{</span><span class="no">:task</span><span class="w"> </span><span class="p">(</span><span class="nb">prn</span><span class="w"> </span><span class="no">:help</span><span class="p">)}}}</span><span class="o">'</span><span class="w"> </span><span class="n">help</span><span class="w">
+</span><span class="p">[</span><span class="n">babashka</span><span class="p">]</span><span class="w"> </span><span class="n">WARNING</span><span class="err">:</span><span class="w"> </span><span class="n">task</span><span class="p">(</span><span class="nf">s</span><span class="p">)</span><span class="w"> </span><span class="ss">'help</span><span class="o">'</span><span class="w"> </span><span class="n">override</span><span class="w"> </span><span class="n">built-in</span><span class="w"> </span><span class="n">command</span><span class="p">(</span><span class="nf">s</span><span class="p">)</span><span class="nb">.</span><span class="w">
+</span><span class="no">:help</span></code></pre>
+</div>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="rouge highlight"><code data-lang="clojure"><span class="n">$</span><span class="w"> </span><span class="n">bb</span><span class="w"> </span><span class="n">-Sdeps</span><span class="w"> </span><span class="o">'</span><span class="p">{</span><span class="no">:tasks</span><span class="w"> </span><span class="p">{</span><span class="n">help</span><span class="w"> </span><span class="p">{</span><span class="no">:task</span><span class="w"> </span><span class="p">(</span><span class="nb">prn</span><span class="w"> </span><span class="no">:help</span><span class="p">)</span><span class="w"> </span><span class="no">:override-builtin</span><span class="w"> </span><span class="n">true</span><span class="p">}}}</span><span class="o">'</span><span class="w"> </span><span class="n">help</span><span class="w">
+</span><span class="no">:help</span></code></pre>
+</div>
+</div>
 </div>
 <div class="sect3">
 <h4 id="_conflicting_task_and_clojure_core_var_names"><a class="link" href="#_conflicting_task_and_clojure_core_var_names">Conflicting task and clojure.core var names</a></h4>