rebuild docs post recent chnages

Author: Phillyclause89

docs/.doctrees/_autosummary/play.doctree

@@ -196,6 +196,32 @@
 </dl>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="play.PlayChessApp.add_eval_comments_to_mainline">
+<span class="sig-name descname"><span class="pre">add_eval_comments_to_mainline</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">game</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Game</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">None</span></span></span><a class="headerlink" href="#play.PlayChessApp.add_eval_comments_to_mainline" title="Permalink to this definition">¶</a></dt>
+<dd><p>Annotate each half-move in the Game’s main line with the corresponding eval score.</p>
+<p>This mutates <cite>game</cite> in place by setting <cite>node.comment = “{eval=…}”</cite> on
+each <cite>ChildNode</cite> in <cite>game.mainline()</cite>.</p>
+<p><strong>Alignment requirement</strong>
+It is the caller’s responsibility to ensure that:</p>
+<blockquote>
+<div><ul class="simple">
+<li><p><cite>self.game_line</cite> has exactly one dummy pick at index 0 (for the “illegal” move), and</p></li>
+<li><p><cite>len(self.game_line) - 1 == number of half-moves in game.mainline()</cite>.</p></li>
+</ul>
+</div></blockquote>
+<p>If those are out of sync, the for-loop will silently stop at the shorter of the two,
+so any mis-alignment should be checked <em>before</em> calling this method.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><dl class="simple">
+<dt><strong>game</strong><span class="classifier">chess.pgn.Game</span></dt><dd><p>A PGN <cite>Game</cite> whose main-line nodes you want to annotate with eval comments sourced from <cite>self.game_line</cite>.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd></dl>
+
 <dl class="py method">
 <dt class="sig sig-object py" id="play.PlayChessApp.add_options">
 <span class="sig-name descname"><span class="pre">add_options</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">menu_bar</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Menu</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">None</span></span></span><a class="headerlink" href="#play.PlayChessApp.add_options" title="Permalink to this definition">¶</a></dt>
@@ -1427,7 +1453,7 @@
 
 <dl class="py attribute">
 <dt class="sig sig-object py" id="play.PlayChessApp.start_time">
-<span class="sig-name descname"><span class="pre">start_time</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">datetime</span></em><em class="property"><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="pre">datetime.datetime(2025,</span> <span class="pre">5,</span> <span class="pre">7,</span> <span class="pre">20,</span> <span class="pre">18,</span> <span class="pre">34,</span> <span class="pre">503074,</span> <span class="pre">tzinfo=datetime.timezone(datetime.timedelta(days=-1,</span> <span class="pre">seconds=61200),</span> <span class="pre">'Pacific</span> <span class="pre">Daylight</span> <span class="pre">Time'))</span></em><a class="headerlink" href="#play.PlayChessApp.start_time" title="Permalink to this definition">¶</a></dt>
+<span class="sig-name descname"><span class="pre">start_time</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">datetime</span></em><em class="property"><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="pre">datetime.datetime(2025,</span> <span class="pre">5,</span> <span class="pre">13,</span> <span class="pre">8,</span> <span class="pre">55,</span> <span class="pre">31,</span> <span class="pre">593242,</span> <span class="pre">tzinfo=datetime.timezone(datetime.timedelta(days=-1,</span> <span class="pre">seconds=61200),</span> <span class="pre">'Pacific</span> <span class="pre">Daylight</span> <span class="pre">Time'))</span></em><a class="headerlink" href="#play.PlayChessApp.start_time" title="Permalink to this definition">¶</a></dt>
 <dd></dd></dl>
 
 <dl class="py method">

docs/.doctrees/environment.pickle

@@ -64,6 +64,8 @@ <h2 id="A">A</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="_autosummary/play.html#play.PlayChessApp.activate_piece">activate_piece() (play.PlayChessApp method)</a>
+</li>
+      <li><a href="_autosummary/play.html#play.PlayChessApp.add_eval_comments_to_mainline">add_eval_comments_to_mainline() (play.PlayChessApp method)</a>
 </li>
       <li><a href="_autosummary/chmutils.base_chess_tk_app.html#chmutils.base_chess_tk_app.BaseChessTkApp.add_options">add_options() (chmutils.base_chess_tk_app.BaseChessTkApp method)</a>