From bea37baec5d4988cca0cc1ab75dabeb764578900 Mon Sep 17 00:00:00 2001
From: J0anJosep <juanjo.ng.83@gmail.com>
Date: Mon, 12 Jul 2021 16:59:02 +0200
Subject: [PATCH] Doc: Changes in the landscape grid due to extended depots.

---
 docs/landscape.html      | 21 ++++++++++-
 docs/landscape_grid.html | 81 ++++++++++++++++++++++++----------------
 2 files changed, 69 insertions(+), 33 deletions(-)

diff --git a/docs/landscape.html b/docs/landscape.html
index e3957a279f4c9..df4ecef578775 100644
--- a/docs/landscape.html
+++ b/docs/landscape.html
@@ -547,6 +547,11 @@ <h3><a name="Landscape">Landscape</a></h3>
         </table>
        </li>
        <li>m5 bit 4: pbs reservation state</li>
+       <li>m5 bit 5 clear: standard depot</li>
+       <li>m5 bit 5 set: extended depot
+        <ul>
+         <li>m4 bits 6..7: depot reservation state</li>
+        </ul>
       </ul>
      </li>
     </ul>
@@ -666,7 +671,7 @@ <h3><a name="Landscape">Landscape</a></h3>
       <ul>
        <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a> of the depot</li>
        <li>m2: Depot index</li>
-       <li>m5 bits 1..0: exit towards:
+       <li>m6 bits 6..7: exit towards:
         <table>
          <tr>
           <td><tt>0</tt>&nbsp; </td>
@@ -689,6 +694,15 @@ <h3><a name="Landscape">Landscape</a></h3>
          </tr>
         </table>
        </li>
+       <li>m3 bits 0..3: road layout road type 1 (tram)</li>
+       <li>m5 bits 0..3: road layout road type 0 (normal road)</li>
+       <li>m5 bit 5 clear: standard depot</li>
+       <li>m5 bit 5 set: extended depot
+        <ul>
+         <li>m4 bits 6..7: depot reservation state towards north direction</li>
+         <li>m6 bits 4..5: depot reservation state towards south direction</li>
+        </ul>
+       </li>
        <li>m7 bits 4..0: <a href="#OwnershipInfo">owner</a> of the road type 0 (normal road)</li>
       </ul>
      </li>
@@ -1108,6 +1122,11 @@ <h3><a name="Landscape">Landscape</a></h3>
        </tr>
       </table>
      </li>
+     <li>m5 bit 5 clear: standard depot (for depots only)</li>
+     <li>m5 bit 5 set: extended depot
+      <ul>
+       <li>m4 bits 6..7: depot reservation state (for depots only)</li>
+      </ul>
     </ul>
    </td>
   </tr>
diff --git a/docs/landscape_grid.html b/docs/landscape_grid.html
index 8efac81bfa3eb..057821cd8e5c1 100644
--- a/docs/landscape_grid.html
+++ b/docs/landscape_grid.html
@@ -79,8 +79,8 @@ <h3 style="font-weight: bold;">Landscape</h3>
     <tr>
       <td rowspan="2">0</td>
       <td class="caption">ground</td>
-      <td class="bits" rowspan=27><span class="used" title="Tile type">XXXX</span> <span class="used" title="Presence and direction of bridge above">XX</span> <span class="used" title="Tropic Zone: only meaningful in tropic climate. It contains the definition of the available zones">XX</span></td>
-      <td class="bits" rowspan=27><span class="used" title="Tile height">XXXX XXXX</span></td>
+      <td class="bits" rowspan=30><span class="used" title="Tile type">XXXX</span> <span class="used" title="Presence and direction of bridge above">XX</span> <span class="used" title="Tropic Zone: only meaningful in tropic climate. It contains the definition of the available zones">XX</span></td>
+      <td class="bits" rowspan=30><span class="used" title="Tile height">XXXX XXXX</span></td>
       <td class="bits" rowspan=2><span class="free">OOO</span><span class="usable" title="Owner (always OWNER_NONE)">1 OOOO</span></td>
       <td class="bits"><span class="free">OOOO OOOO OOOO OOOO</span></td>
       <td class="bits"><span class="used" title="Type of hedge on NE border">XXX</span> <span class="used" title="Snow presence">X</span><span class="free">OOOO</span></td>
@@ -95,16 +95,16 @@ <h3 style="font-weight: bold;">Landscape</h3>
       <td class="bits"><span class="used" title="Type of hedge on NE border">XXX</span> <span class="used" title="Field production stage">XXXXX</span></td>
     </tr>
     <tr>
-      <td rowspan=3>1</td>
+      <td rowspan=4>1</td>
       <td class="caption">rail</td>
-      <td class="bits" rowspan=3><span class="used" title="Ship docking tile status (for half-tile with water)">X</span><span class="free">OO</span><span class="used" title="Owner">X XXXX</span></td>
+      <td class="bits" rowspan=4><span class="used" title="Ship docking tile status (for half-tile with water)">X</span><span class="free">OO</span><span class="used" title="Owner">X XXXX</span></td>
       <td class="bits"><span class="free">OOOO</span> <span class="used" title="Reserved tracks">XXXX</span> <span class="free">OOOO OOOO</span></td>
       <td class="bits"><span class="free">OOOO OOOO</span> </td>
       <td class="bits"><span class="free">OOOO</span> <span class="used" title="Ground type: fences, snow, desert">XXXX</span></td>
       <td class="bits"><span class="used" title="Rail tile type: rail, rail with signals, depot">OO</span> <span class="used" title="Track pieces">XXXXXX</span></td>
-      <td class="bits" rowspan=3><span class="free">OOOO OOOO</span></td>
-      <td class="bits" rowspan=3><span class="free">OOOO OOOO</span></td>
-      <td class="bits" rowspan=3><span class="free">OOOO OOOO OO</span><span class="used" title="Railway type">XX XXXX</span></td>
+      <td class="bits" rowspan=4><span class="free">OOOO OOOO</span></td>
+      <td class="bits" rowspan=4><span class="free">OOOO OOOO</span></td>
+      <td class="bits" rowspan=4><span class="free">OOOO OOOO OO</span><span class="used" title="Railway type">XX XXXX</span></td>
     </tr>
     <tr>
       <td class="caption">rail with signals</td>
@@ -114,22 +114,27 @@ <h3 style="font-weight: bold;">Landscape</h3>
       <td class="bits"><span class="used" title="Rail tile type: rail, rail with signals, depot">O1</span> <span class="used" title="Track pieces">XXXXXX</span></td>
     </tr>
     <tr>
-      <td class="caption">depot</td>
-      <td class="bits"><span class="pool" title="Depot index on pool">XXXX XXXX XXXX XXXX</span></td>
-      <td class="bits"><span class="free">OOOO</span> <span class="free">OOOO</span></td>
+      <td class="caption">standard rail depot</td>
+      <td class="bits" rowspan=2><span class="pool" title="Depot index on pool">XXXX XXXX XXXX XXXX</span></td>
+      <td class="bits" rowspan=2><span class="free">OOOO</span> <span class="free">OOOO</span></td>
       <td class="bits"><span class="free">OOOO</span> <span class="used" title="Ground type: fences, snow, desert (fences on depot are not valid)">XXXX</span></td>
-      <td class="bits"><span class="used" title="Rail tile type: rail, rail with signals, depot">1O</span><span class="free">O</span><span class="used" title="PBS reservation">X</span> <span class="free">OO</span><span class="used" title="Depot exit direction">XX</span></td>
+      <td class="bits"><span class="used" title="Rail tile type: rail, rail with signals, depot">1O</span><span class="patch" title="Big/Small depot">O</span><span class="used" title="PBS reservation">X</span> <span class="free">OO</span><span class="used" title="Depot exit direction">XX</span></td>
+    </tr>
+    <tr>
+      <td class="caption"><span class="patch">extended rail depot</span></td>
+      <td class="bits"><span class="patch" title="Type of reservation in this depot">XX</span><span class="free">OO</span> <span class="used" title="Ground type: fences, snow, desert (fences on depot are not valid)">XXXX</span></td>
+      <td class="bits"><span class="used" title="Rail tile type: rail, rail with signals, depot">1O</span><span class="patch" title="Big/Small depot">1</span><span class="used" title="PBS reservation">X</span> <span class="free">OO</span><span class="used" title="Depot exit direction">XX</span></td>
     </tr>
     <tr>
-      <td rowspan=3>2</td>
+      <td rowspan=4>2</td>
       <td class="caption">road</td>
       <td class="bits"><span class="free">OOO</span><span class="used" title="Owner of road">X XXXX</span></td>
       <td class="bits" rowspan=2><span class="pool" title="Town index on pool">XXXX XXXX XXXX XXXX</span></td>
       <td class="bits"><span class="used" title="Owner of tram">XXXX</span> <span class="used" title="Tram pieces">XXXX</span></td>
-      <td class="bits" rowspan=3><span class="free">OO</span><span class="used" title="Road type">XX XXXX</span></td>
+      <td class="bits" rowspan=3><span class="free">OO</span> <span class="used" title="Road type">XXXXXX</span></td>
       <td class="bits"><span class="used" title="Tile type: simple road (00), level crossing (01), road depot (10)">OO</span> <span class="used" title="Disallow vehicles to go a specific direction">XX</span> <span class="used" title="Road pieces">XXXX</span></td>
-      <td class="bits"><span class="free">OO</span> <span class="used" title="Pavement type">XXX</span><span class="free">OOO</span></td>
-      <td class="bits"><span class="free">OO</span><span class="used" title="Snow/desert present">X</span> <span class="free">O</span><span class="used" title="Roadworks counter">XXXX</span></td>
+      <td class="bits"><span class="free">OO</span><span class="used" title="Pavement type">XX X</span><span class="free">OOO</span></td>
+      <td class="bits"><span class="free">OO</span><span class="used" title="Snow/desert present">X</span><span class="free">O</span> <span class="used" title="Roadworks counter">XXXX</span></td>
       <td class="bits" rowspan=1><span class="free">OOOO</span> <span class="used" title="Tram type">XXXX XX<span class="free">OO OOOO</span></td>
     </tr>
     <tr>
@@ -137,20 +142,27 @@ <h3 style="font-weight: bold;">Landscape</h3>
       <td class="bits"><span class="free">OOO</span><span class="used" title="Owner of rail track">X XXXX</span></td>
       <td class="bits"><span class="used" title="Owner of tram">XXXX</span> <span class="free">OOOO</span></td>
       <td class="bits"><span class="used" title="Tile type: simple road (00), level crossing (01), road depot (10)">O1</span> <span class="used" title="Lights are on">X</span> <span class="used" title="PBS reservation">X</span><span class="free">OOO</span><span class="used" title="Direction of the rail and roads">X</span></td>
-      <td class="bits"><span class="free">OO</span> <span class="used" title="Pavement type">XXX</span><span class="free">OOO</span></td>
+      <td class="bits"><span class="free">OO</span><span class="used" title="Pavement type">XX X</span><span class="free">OOO</span></td>
       <td class="bits"><span class="free">OO</span><span class="used" title="Snow/desert present">X</span> <span class="used" title="Owner of road">XXXXX</span></td>
       <td class="bits" rowspan=1><span class="free">OOOO</span> <span class="used" title="Tram type">XXXX XX</span> <span class="used" title="Railway type">XXXXXX</span></td>
     </tr>
     <tr>
-      <td class="caption">road depot</td>
-      <td class="bits"><span class="free">OOO</span><span class="used" title="Owner of the depot">X XXXX</span></td>
-      <td class="bits"><span class="pool" title="Depot index on pool">XXXX XXXX XXXX XXXX</span></td>
-      <td class="bits"><span class="usable" title="Owner of tram depot">XXXX</span> <span class="free">OOOO</span></td>
-      <td class="bits"><span class="used" title="Tile type: simple road (00), level crossing (01), road depot (10)">1O</span><span class="free">OO OO</span><span class="used" title="Depot exit direction">XX</span></td>
-      <td class="bits"><span class="free">OOOO OOOO</span></td>
-      <td class="bits"><span class="free">OO</span><span class="used" title="Snow/desert present">X</span> <span class="usable" title="Owner of road depot">XXXXX</span></td>
-      <td class="bits" rowspan=1><span class="free">OOOO</span> <span class="used" title="Tram type">XXXX XX</span><span class="free">OO OOOO</span></td>
+      <td class="caption">standard road depot</td>
+      <td class="bits" rowspan=2><span class="free">OOO</span><span class="used" title="Owner of the depot">X XXXX</span></td>
+      <td class="bits" rowspan=2><span class="pool" title="Depot index on pool">XXXX XXXX XXXX XXXX</span></td>
+      <td class="bits" rowspan=2><span class="usable" title="Owner of tram depot. The owner in .m1 is enough">XXXX</span> <span class="patch" title="Tram pieces">XXXX</span></td>
+      <td class="bits"><span class="used" title="Tile type: simple road (00), level crossing (01), road depot (10)">1O</span><span class="patch" title="Big/Small depot">O</span><span class="free">O</span> <span class="patch" title="Road pieces">XXXX</span></td>
+      <td class="bits"><span class="used" title="Depot exit direction">XX</span><span class="free">OO OOOO</span></td>
+      <td class="bits" rowspan=2><span class="free">OO</span><span class="used" title="Snow/desert present">X</span> <span class="usable" title="Owner of road depot. The owner in .m1 is enough">XXXXX</span></td>
+      <td class="bits" rowspan=2><span class="free">OOOO</span> <span class="used" title="Tram type">XXXX XX</span><span class="free">OO OOOO</span></td>
     </tr>
+    <tr>
+      <td class="caption"><span class="patch">extended road depot</span></td>
+      <td class="bits" rowspan=1><span class="patch" title="Type of reservation in this depot towards north direction">XX</span> <span class="used" title="Road type">XXXXXX</span></td>
+      <td class="bits"><span class="used" title="Tile type: simple road (00), level crossing (01), road depot (10)">1O</span><span class="patch" title="Big/Small depot">1</span><span class="free">O</span> <span class="patch" title="Road pieces">XXXX</span></td>
+      <td class="bits"><span class="used" title="Depot exit direction">XX</span> <span class="patch" title="Type of reservation in this depot towards south direction">XX</span><span class="free">OOOO</span></td>
+
+      </tr>
     <tr>
       <td rowspan=2>3</td>
       <td class="caption">finished house</td>
@@ -235,16 +247,16 @@ <h3 style="font-weight: bold;">Landscape</h3>
       <td class="bits"><span class="free">OOOO OOOO</span></td>
     </tr>
     <tr>
-      <td rowspan=4>6</td>
+      <td rowspan=5>6</td>
       <td class="caption">sea, shore</td>
-      <td class="bits" rowspan=4><span class="used" title="Ship docking tile status">X</span> <span class="used" title="Water class">XX</span> <span class="used" title="Owner">XXXXX</span></td>
+      <td class="bits" rowspan=5><span class="used" title="Ship docking tile status">X</span> <span class="used" title="Water class">XX</span> <span class="used" title="Owner">XXXXX</span></td>
       <td class="bits" rowspan=3><span class="free">OOOO OOOO OOOO OOOO</span></td>
-      <td class="bits" rowspan=4><span class="free">OOOO OOOO</span></td>
+      <td class="bits" rowspan=5><span class="free">OOOO OOOO</span></td>
       <td class="bits"><span class="free">OOOO OOOO</span></td>
       <td class="bits"><span class="used" title="Water tile type: coast or water (00), lock (01), depot (10)">OO</span><span class="free">OO OOO</span><span class="used" title="Sea shore flag">X</span></td>
-      <td class="bits" rowspan=4><span class="free">OOOO OOOO</span></td>
-      <td class="bits" rowspan=4><span class="free">OOOO OOOO</td>
-      <td class="bits" rowspan=4><span class="free">OOOO OOOO OOOO OOOO</span></td>
+      <td class="bits" rowspan=5><span class="free">OOOO OOOO</span></td>
+      <td class="bits" rowspan=5><span class="free">OOOO OOOO</td>
+      <td class="bits" rowspan=5><span class="free">OOOO OOOO OOOO OOOO</span></td>
     </tr>
     <tr>
       <td class="caption">canal, river</td>
@@ -257,11 +269,16 @@ <h3 style="font-weight: bold;">Landscape</h3>
       <td class="bits"><span class="used" title="Water tile type: coast or water (00), lock (01), depot (10)">O1</span><span class="free">OO</span><span class="used" title="Lock part">XX</span> <span class="used" title="Lock orientation m5[1..0]">XX</span></td>
     </tr>
     <tr>
-      <td class="caption">shipdepot</td>
-      <td class="bits"><span class="pool" title="Depot index on pool">XXXX XXXX XXXX XXXX</span></td>
+      <td class="caption">standard ship depot</td>
+      <td class="bits" rowspan=2><span class="pool" title="Depot index on pool">XXXX XXXX XXXX XXXX</span></td>
       <td class="bits"><span class="free">OOOO OOOO</span></td>
       <td class="bits"><span class="used" title="Water tile type: coast or water (00), lock (01), depot (10)">1O</span><span class="free">OOOO</span><span class="used" title="Depot axis">X</span> <span class="used" title="Depot part">X</span></td>
     </tr>
+    <tr>
+      <td class="caption"><span class="patch">extended ship depot</span></td>
+      <td class="bits"><span class="patch" title="Type of reservation in this depot">XX</span><span class="free">OO</span> <span class="free">OOOO</span></td>
+      <td class="bits"><span class="used" title="Water tile type: coast or water (00), lock (01), depot (10)">1O</span><span class="patch" title="Big/Small depot">1</span><span class="free">OOO</span><span class="used" title="Depot axis">X</span> <span class="used" title="Depot part">X</span></td>
+      </tr>
     <tr>
       <td rowspan=2>8</td>
       <td class="caption">finished industry</td>