Merge pull request #67 from swift-nav/fixes

docs: added new warnings page

Author: scottswift

doc/Makefile

@@ -1,4 +1,4 @@
-PAGES := index.html reference.html guide.html tutorials.html
+PAGES := index.html reference.html guide.html tutorials.html warnings.html
 
 index.html: index.rst template.txt
 	rst2html.py $< $@ --math-output=MathJax --template=template.txt --stylesheet=stylesheets/normalize.css,stylesheets/pygment_trac.css,stylesheets/style.css --no-toc-backlinks --section-numbering

doc/guide.html

@@ -1249,6 +1249,7 @@ <h1 class="title">Plover User Guide</h1>
       <li><a href="guide.html">Guide</a></li>
       <li><a href="tutorials.html">Tutorials</a></li>
       <li><a href="reference.html">Reference</a></li>
+      <li><a href="warnings.html">Warnings</a></li>
     </ul>
   </header>
 </div>

doc/index.html

@@ -1236,6 +1236,7 @@ <h2 class="subtitle" id="high-level-embedded-linear-algebra-programming">High-le
       <li><a href="guide.html">Guide</a></li>
       <li><a href="tutorials.html">Tutorials</a></li>
       <li><a href="reference.html">Reference</a></li>
+      <li><a href="warnings.html">Warnings</a></li>
     </ul>
   </header>
 </div>
@@ -1261,6 +1262,8 @@ <h1>Documentation</h1>
 programming algorithms and applications in Plover.</li>
 <li>The <a class="reference external" href="reference.html">Plover Language Reference</a> gives a more
 in-depth treatment of the language itself.</li>
+<li><a class="reference external" href="warnings.html">Notable Differences</a> enumerates some notable differences
+from related languages and corner cases to be aware of.</li>
 </ul>
 </div>
 <div class="section" id="in-the-real-world">

doc/index.rst

@@ -31,6 +31,8 @@ The Plover documentation is split into the following parts:
   programming algorithms and applications in Plover.
 - The `Plover Language Reference <reference.html>`_ gives a more
   in-depth treatment of the language itself.
+- `Notable Differences <warnings.html>`_ enumerates some notable differences
+  from related languages and corner cases to be aware of.
 
 
 In the real world

doc/reference.html

@@ -1250,6 +1250,7 @@ <h1 class="title">Plover Language Reference</h1>
       <li><a href="guide.html">Guide</a></li>
       <li><a href="tutorials.html">Tutorials</a></li>
       <li><a href="reference.html">Reference</a></li>
+      <li><a href="warnings.html">Warnings</a></li>
     </ul>
   </header>
 </div>
@@ -2471,7 +2472,7 @@ <h1>Language Proposals</h1>
 <tr><th class="docinfo-name">Authors:</th>
 <td>Scott Kovach
 <br />Kyle Miller</td></tr>
-<tr class="field"><th class="docinfo-name">Modified:</th><td class="field-body">August 2015</td>
+<tr class="field"><th class="docinfo-name">Modified:</th><td class="field-body">June 2016</td>
 </tr>
 </tbody>
 </table>

doc/reference.rst

@@ -3,7 +3,7 @@
 ===========================
 
 :Authors:  Scott Kovach, Kyle Miller
-:Modified: August 2015
+:Modified: June 2016
 
 Overview
 ========

doc/template.txt

@@ -43,6 +43,7 @@ id: '{\\mathrm{id}}'
       <li><a href="guide.html">Guide</a></li>
       <li><a href="tutorials.html">Tutorials</a></li>
       <li><a href="reference.html">Reference</a></li>
+      <li><a href="warnings.html">Warnings</a></li>
     </ul>
   </header>
 </div>

doc/tutorials.html

@@ -1250,6 +1250,7 @@ <h1 class="title">Plover Tutorials</h1>
       <li><a href="guide.html">Guide</a></li>
       <li><a href="tutorials.html">Tutorials</a></li>
       <li><a href="reference.html">Reference</a></li>
+      <li><a href="warnings.html">Warnings</a></li>
     </ul>
   </header>
 </div>