From 0cd99e576cac6b4548036f9e9d5f53b62ab7f721 Mon Sep 17 00:00:00 2001
From: Jonathan G Rennison <j.g.rennison@gmail.com>
Date: Sun, 5 Feb 2017 18:27:59 +0000
Subject: [PATCH] Custom bridge heads: Document landscape array use.

---
 docs/landscape.html      | 30 ++++++++++++++++++++++++++++++
 docs/landscape_grid.html |  4 +++-
 2 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/docs/landscape.html b/docs/landscape.html
index f60e859fc3..86d0b8057d 100644
--- a/docs/landscape.html
+++ b/docs/landscape.html
@@ -1443,6 +1443,36 @@
    <td>
     <ul>
      <li>m1 bits 4..0: <a href="#OwnershipInfo">owner</a></li>
+     <li style="color: blue">m2 bits 7..0: custom road bridge heads (flat bridge heads only)<br>
+      Road/tram bits below are XORed with the axial bridge direction road bits.<br>
+      A non-custom bridge head configuration will have a value of 0.
+      <ul>
+       <li>m2 bits 7..4: Road bits<br>
+           Valid only if m7 bit 6 is set
+       </li>
+       <li>m2 bits 3..0: Tram bits<br>
+           Valid only if m7 bit 7 is set
+       </li>
+      </ul>
+      <table style="color: blue">
+       <tr>
+        <td align=left>bit 0: </td>
+        <td>NW piece</td>
+       </tr>
+       <tr>
+        <td align=left>bit 1: </td>
+        <td>SW piece</td>
+       </tr>
+       <tr>
+        <td align=left>bit 2: </td>
+        <td>SE piece</td>
+       </tr>
+       <tr>
+        <td align=left>bit 3: </td>
+        <td>NE piece</td>
+       </tr>
+      </table>
+     </li>
      <li>m3 bits 7..4: <a href="#OwnershipInfo">owner</a> of tram</li>
      <li>m3 bits 3..0: <a href="#TrackType">track type</a> for railway</li>
      <li>m5 bit 4: pbs reservation state for railway</li>
diff --git a/docs/landscape_grid.html b/docs/landscape_grid.html
index d34fe9840c..3ba984d5d8 100644
--- a/docs/landscape_grid.html
+++ b/docs/landscape_grid.html
@@ -9,6 +9,7 @@
     span.option{ font-family: "Courier New", Courier, mono; background-color: rgb(255,255, 30); }
     span.free  { font-family: "Courier New", Courier, mono; background-color: rgb(30, 178, 54); }
     span.used  { font-family: "Courier New", Courier, mono; }
+    span.used_p{ font-family: "Courier New", Courier, mono; background-color: cyan; }
     td.bits    { white-space: nowrap; text-align: center; font-family: "Courier New", Courier, mono; }
     td.caption { white-space: nowrap; text-align: left; }
     td li      { white-space: nowrap; text-align: left; }
@@ -23,6 +24,7 @@ the array so you can quickly see what is used and what is not.
 <ul>
   <li><span style="font-weight: bold;"><span class="free">O</span></span> - bit is free</li>
   <li><span style="font-weight: bold;"><span class="used">X</span></span> - bit is used</li>
+  <li><span style="font-weight: bold;"><span class="used_p">P</span></span> - bit is used by patch feature</li>
   <li><span style="font-weight: bold;"><span class="abuse">&nbsp;</span></span> - bit of attribute is abused for different purposes, i.e. other bits define the actual meaning.</li>
   <li><span style="font-weight: bold;"><span class="option">~</span></span> - bit is accessed, but does not really have a meaning (e.g. owner of clear land is always OWNER_NONE)</li>
 </ul>
@@ -343,7 +345,7 @@ the array so you can quickly see what is used and what is not.
       <td class="bits">-inherit-</td>
       <td class="bits">-inherit-</td>
       <td class="bits">-inherit-</td>
-      <td class="bits">-inherit-</td>
+      <td class="bits"><span class="free">OOOO OOOO</span> <span class="used_p">PPPP PPPP</span></td>
       <td class="bits">-inherit-</td>
       <td class="bits">-inherit-</td>
       <td class="bits">-inherit-</td>