deploy: 9fc1e27

Author: PLeVasseur

_static/fls_links.css

@@ -17,3 +17,14 @@ a.fls-id:hover {
     border-bottom: 1px dashed #cc0000;
     color: #cc0000;
 }
+
+/* Styling for std library reference links */
+a.std-ref code.docutils.literal.notranslate {
+    border-bottom: 1px dotted #0078d7;
+    text-decoration: none;
+}
+a.std-ref:hover code.docutils.literal.notranslate {
+    background-color: rgba(0, 120, 215, 0.1);
+    border-bottom-style: solid;
+    border-bottom-color: #0078d7;
+}

coding-guidelines/associated-items/index.html

@@ -121,7 +121,7 @@
 
   <section id="associated-items">
 <h1>Associated Items<a class="headerlink" href="#associated-items" title="Link to this heading"></a></h1>
-<div class="need_container docutils container" id="SNCB-aa3b01dd">
+<div class="need_container docutils container" id="SNCB-511103c6">
 <table class="need needs_grid_simple needs_layout_clean needs_style_none needs_type_guideline docutils align-default" id="gui_ot2Zt3dd6of1">
 <tbody>
 <tr class="need head row-odd"><td class="need head"><div class="needs_head line-block">
@@ -138,13 +138,13 @@ <h1>Associated Items<a class="headerlink" href="#associated-items" title="Link t
 <div class="line"><span class="needs_scope"><span class="needs_label">scope: </span><span class="needs_data">system</span></span></div>
 <div class="line"><span class="needs_release"><span class="needs_label">release: </span><span class="needs_data">1.3.0-latest</span></span></div>
 </span></span></div>
-<div class="line"><span><div class="line">child needs: <span class="parent_needs"><span><a class="reference internal" href="#rat_gvoKeVSKK8fD" title="gui_ot2Zt3dd6of1">rat_gvoKeVSKK8fD</a>, <a class="reference internal" href="#non_compl_ex_MxqhjfkStJJy" title="gui_ot2Zt3dd6of1">non_compl_ex_MxqhjfkStJJy</a>, <a class="reference internal" href="#compl_ex_9pK3h65rfceO" title="gui_ot2Zt3dd6of1">compl_ex_9pK3h65rfceO</a></span></span></div>
+<div class="line"><span><div class="line">child needs: <span class="parent_needs"><span><a class="reference internal" href="#rat_gvoKeVSKK8fD" title="gui_ot2Zt3dd6of1">rat_gvoKeVSKK8fD</a>, <a class="reference internal" href="#non_compl_ex_MxqhjfkStJJy" title="gui_ot2Zt3dd6of1">non_compl_ex_MxqhjfkStJJy</a>, <a class="reference internal" href="#compl_ex_9pK3h65rfceO" title="gui_ot2Zt3dd6of1">compl_ex_9pK3h65rfceO</a>, <a class="reference internal" href="#bib_ot2Zt3dd6of1" title="gui_ot2Zt3dd6of1">bib_ot2Zt3dd6of1</a></span></span></div>
 </span></div>
 </div>
 </td>
 </tr>
 <tr class="need content row-odd"><td class="need content" colspan="1"><p>Any function shall not call itself directly or indirectly</p>
-<div class="need_container docutils container" id="SNCB-7fa2f52d">
+<div class="need_container docutils container" id="SNCB-860d5671">
 <table class="need needs_grid_simple needs_layout_clean needs_style_none needs_type_rationale docutils align-default" id="rat_gvoKeVSKK8fD">
 <tbody>
 <tr class="need head row-odd"><td class="need head"><div class="needs_head line-block">
@@ -160,12 +160,12 @@ <h1>Associated Items<a class="headerlink" href="#associated-items" title="Link t
 </div>
 </td>
 </tr>
-<tr class="need content row-odd"><td class="need content" colspan="1"><p>Recursive functions can easily cause stack overflows, which may result in exceptions or, in some cases, undefined behavior (typically some embedded systems). Although the Rust compiler supports <a class="reference external" href="https://en.wikipedia.org/wiki/Tail_call">tail call optimization</a>, this optimization is not guaranteed and depends on the specific implementation and function structure. There is an <a class="reference external" href="https://github.com/phi-go/rfcs/blob/guaranteed-tco/text/0000-explicit-tail-calls.md">open RFC to guarantee tail call optimization in the Rust compiler</a>, but this feature has not yet been stabilized. Until tail call optimization is guaranteed and stabilized, developers should avoid using recursive functions to prevent potential stack overflows and ensure program reliability.</p></td>
+<tr class="need content row-odd"><td class="need content" colspan="1"><p>Recursive functions can easily cause stack overflows, which may result in exceptions or, in some cases, undefined behavior (typically some embedded systems). Although the Rust compiler supports tail call optimization <a class="citation-ref reference internal" href="#cite-gui_ot2Zt3dd6of1-WIKI-TAIL-CALL">[WIKI-TAIL-CALL]</a>, this optimization is not guaranteed and depends on the specific implementation and function structure. There is an open RFC to guarantee tail call optimization in the Rust compiler <a class="citation-ref reference internal" href="#cite-gui_ot2Zt3dd6of1-PROPOSED-RFC-EXPLICIT-TAIL-CALLS">[PROPOSED-RFC-EXPLICIT-TAIL-CALLS]</a>, but this feature has not yet been stabilized. Until tail call optimization is guaranteed and stabilized, developers should avoid using recursive functions to prevent potential stack overflows and ensure program reliability.</p></td>
 </tr>
 </tbody>
 </table>
 </div>
-<div class="need_container docutils container" id="SNCB-616d0982">
+<div class="need_container docutils container" id="SNCB-1461d542">
 <table class="need needs_grid_simple needs_layout_clean needs_style_none needs_type_non_compliant_example docutils align-default" id="non_compl_ex_MxqhjfkStJJy">
 <tbody>
 <tr class="need head row-odd"><td class="need head"><div class="needs_head line-block">
@@ -210,7 +210,7 @@ <h1>Associated Items<a class="headerlink" href="#associated-items" title="Link t
 </tbody>
 </table>
 </div>
-<div class="need_container docutils container" id="SNCB-1be746d6">
+<div class="need_container docutils container" id="SNCB-0d798e52">
 <table class="need needs_grid_simple needs_layout_clean needs_style_none needs_type_compliant_example docutils align-default" id="compl_ex_9pK3h65rfceO">
 <tbody>
 <tr class="need head row-odd"><td class="need head"><div class="needs_head line-block">
@@ -270,6 +270,37 @@ <h1>Associated Items<a class="headerlink" href="#associated-items" title="Link t
 </tbody>
 </table>
 </div>
+<div class="need_container docutils container" id="SNCB-47475714">
+<table class="need needs_grid_simple needs_layout_clean needs_style_none needs_type_bibliography docutils align-default" id="bib_ot2Zt3dd6of1">
+<tbody>
+<tr class="need head row-odd"><td class="need head"><div class="needs_head line-block">
+<div class="line"><span><span class="needs_type_name"><span class="needs_data">Bibliography</span></span>: </span><strong><span></span></strong><span> <span class="needs-id"><a class="reference internal" href="#bib_ot2Zt3dd6of1" title="bib_ot2Zt3dd6of1">bib_ot2Zt3dd6of1</a></span>  <span class="needs needs_collapse" id="target__show__meta"><span class="needs collapsed"><svg xmlns="http://www.w3.org/2000/svg" width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-arrow-down-circle"><circle cx="12" cy="12" r="10"></circle><polyline points="8 12 12 16 16 12"></polyline><line x1="12" y1="8" x2="12" y2="16"></line></svg></span><span class="needs visible collapse_is_hidden"><svg xmlns="http://www.w3.org/2000/svg" width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-arrow-right-circle"><circle cx="12" cy="12" r="10"></circle><polyline points="12 16 16 12 12 8"></polyline><line x1="8" y1="12" x2="16" y2="12"></line></svg></span></span> </span></div>
+</div>
+</td>
+</tr>
+<tr class="need meta row-even"><td class="need meta"><div class="needs_meta line-block">
+<div class="line"><span><span><div class="line"><span class="needs_status"><span class="needs_label">status: </span><span class="needs_data">draft</span></span></div>
+</span></span></div>
+<div class="line"><span><div class="line">parent needs: <span class="parent_needs"><span><a class="reference internal" href="#gui_ot2Zt3dd6of1" title="bib_ot2Zt3dd6of1">gui_ot2Zt3dd6of1</a></span></span></div>
+</span></div>
+</div>
+</td>
+</tr>
+<tr class="need content row-odd"><td class="need content" colspan="1"><table class="bibliography-table docutils align-default">
+<tbody>
+<tr class="row-odd"><td><p><span class="target" id="cite-gui_ot2Zt3dd6of1-WIKI-TAIL-CALL"></span><strong class="bibentry-key">[WIKI-TAIL-CALL]</strong><a href="javascript:void(0)" onclick="citationGoBack('cite-gui_ot2Zt3dd6of1-WIKI-TAIL-CALL')" class="bibentry-back" title="Return to citation">↩</a></p></td>
+<td><p>Wikipedia. “Tail call.” <a class="reference external" href="https://en.wikipedia.org/wiki/Tail_call">https://en.wikipedia.org/wiki/Tail_call</a></p></td>
+</tr>
+<tr class="row-even"><td><p><span class="target" id="cite-gui_ot2Zt3dd6of1-PROPOSED-RFC-EXPLICIT-TAIL-CALLS"></span><strong class="bibentry-key">[PROPOSED-RFC-EXPLICIT-TAIL-CALLS]</strong><a href="javascript:void(0)" onclick="citationGoBack('cite-gui_ot2Zt3dd6of1-PROPOSED-RFC-EXPLICIT-TAIL-CALLS')" class="bibentry-back" title="Return to citation">↩</a></p></td>
+<td><p>Philipp Görz. “Open RFC - explicit_tail_calls.” <a class="reference external" href="https://github.com/phi-go/rfcs/blob/guaranteed-tco/text/0000-explicit-tail-calls.md">https://github.com/phi-go/rfcs/blob/guaranteed-tco/text/0000-explicit-tail-calls.md</a></p></td>
+</tr>
+</tbody>
+</table>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
 </td>
 </tr>
 </tbody>