Merge pull request #618 from cjakeman/manual-firewall

added web-server firewall to Manual

Author: cjakeman

Source/Documentation/Manual/images/firewall.png

@@ -142,6 +142,8 @@ Disable TCS scripts
 This option disables the train control system scripts for locomotives where
 these have been implemented.
 
+.. _options-web-server-port:
+
 Web server port
 -----------------
 

Source/Documentation/Manual/options.rst

@@ -35,7 +35,8 @@ MonoGame is an open source implementation of the Microsoft XNA 4 Framework and p
 Frames per Second (FPS) Performance
 ===================================
 
-FPS rate is as default not linked to the sync rate of the monitor. However, with :ref:`this option <options-vsync>` FPS rate may be set at the value of the monitor refresh rate.
+FPS rate is as default not linked to the sync rate of the monitor. 
+However, with :ref:`this option <options-vsync>` FPS rate may be set at the value of the monitor refresh rate.
 
 Game Clock and Internal Clock
 =============================
@@ -101,15 +102,26 @@ the software will contribute to better overall performance -- potentially
 allowing high polygon models with densely populated routes at acceptable 
 frame rates.
 
+.. _web-server:
+
 Web Server
 ==========
 
 .. _sample-web-pages:
 
+The game uses a built-in web-server to deliver standard and custom web-pages
+to any browser. This can be running on the same PC as Open Rails or another PC 
+or other device which is connected to your local network.
+
+The simplest way to access these samples is to start the game and then launch
+a browser on the same PC. Then enter "localhost:2150" into your browser address bar. 
+(2150 is the default port number set in :ref:`Menu > Options > General <options-web-server-port>`)
+
 Sample Web Pages
 ----------------
 
-These pages give examples of what can be done with the APIs.
+A number of web-pages are included in the Open Rails installation as examples of 
+what can be done with the APIs.
 
 Some of these sample pages repeat data from the in-game panels to provide a more convenient display.
 

Source/Documentation/Manual/software-platform.rst

@@ -180,6 +180,22 @@ Now, click on ``Start``, and OR will start loading the data needed for your
 game. When loading completes you will be within the cab of your 
 locomotive! You can read further in the chapter :ref:`Driving a Train <driving>`.
 
+Firewall
+========
+
+The game uses a built-in web-server to deliver standard and custom  web-pages
+to any browser - see :ref:`Web Server <web-server>`.
+
+
+When the game runs for the first time, the web-server will try to use a
+port on your PC to serve any browser that you might want to run. 
+The Windows OS will detect this and pop up a prompt to ask permission for this.
+
+.. image:: images/firewall.png
+
+We recommend that you grant permission as a private network even if you
+don't plan to use a browser straight away.
+
 Multiplayer Mode
 ----------------