Add documentation for new parameters

Author: cesarBLG

Source/Documentation/Manual/physics.rst

@@ -2300,6 +2300,10 @@ pressure rises above the auxiliary reservoir pressure, the brake
 cylinder pressure is released completely at a rate determined by the
 retainer setting.
 
+BrakeEquipmentType() can also contain a "Distributing_Valve" instead of a
+"triple_valve" or a "distributor", for locomotives fitted with the
+Westinghouse ET-6 distributing valve or similar equipment.
+
 Selecting :ref:`Graduated Release Air Brakes <options-general>` in *Menu >
 Options* will force self-lapping notches in the brake controller to have
 graduated release. It will also force graduated release of brakes in triple
@@ -2352,6 +2356,7 @@ The following notch positions can be defined for the train brake at ``Engine(Eng
    single: TrainBrakesControllerSlowServiceStart
    single: TrainBrakesControllerFullServiceStart
    single: TrainBrakesControllerHoldStart
+   single: TrainBrakesControllerHoldEngineStart
    single: TrainBrakesControllerEPHoldStart
    single: TrainBrakesControllerSelfLapStart
    single: TrainBrakesControllerRunningStart
@@ -2371,6 +2376,7 @@ The following notch positions can be defined for the train brake at ``Engine(Eng
    single: ORTSTrainBrakesControllerMaxOverchargePressure
    single: ORTSTrainBrakesControllerOverchargeEliminationRate
    single: ORTSTrainBrakesControllerSlowApplicationRate
+   single: EngineBrakesControllerBailOffStart
 
 **RELEASE and RUNNING tokens**
 
@@ -2430,6 +2436,15 @@ Brake Token:   ``TrainBrakesControllerReleaseStart``
 
                     - Connects brake pipe to ejector(s) and/or vacuum pump. Brakes may be released by operating large or small ejector.  
 
+Brake Token:   ``EngineBrakesControllerBailOffStart``
+
+- Operation:     Air, EP, Vacuum
+- Brake Systems: Air single pipe, Air twin pipe, EP, Vacuum single pipe
+- Description:   
+   
+                - Engine brake: bail off engine brakes
+                - Train brake: no change
+
 **LAP, HOLDING and NEUTRAL tokens**
 
 Brake Token:   ``TrainBrakesControllerRunningStart``
@@ -2504,6 +2519,15 @@ Brake Token:   ``TrainBrakesControllerNeutralHandleOffStart``
                 - Air brakes: Train pipe pressure is held without compensation for leakage.
                 - EP brakes: Brake application is held at any value.
                 - Vacuum brakes: Train pipe vacuum is held without compensation for leakage.  
+                
+Brake Token:   ``TrainBrakesControllerHoldEngineStart``
+
+- Operation:     Air, EP, Vacuum
+- Brake Systems: Air single pipe, Air twin pipe, EP, Vacuum single pipe
+- Description:   HOLD ENGINE
+
+                - Engine brakes: engine brake cylinder pressure is held at current value.
+                - Train brakes: same as RELEASE/RUNNING
 
 
 **SELF LAPPING APPLY tokens**
@@ -2875,6 +2899,23 @@ defined in a DynamicBrakeForceCurves table that works like the
 DynamicBrakeForceCurves defined in the ENG file, than one is created
 based on the MSTS parameter values.
 
+It is possible to use dynamic brakes as a replacement for air brakes
+when they are available (dynamic brake blending). During blending operation,
+the following parameters will adjust the behaviour of air brakes:
+
+.. index::
+   single: DynamicBrakeHasAutoBailOff
+   single: ORTSDynamicBrakesHasPartialBailOff
+   
+- ``Engine(DynamicBrakeHasAutoBailOff`` -- Set to 1 if brake cylinders are
+  emptied while dynamic brake is active
+- ``Engine(ORTSDynamicBrakesHasPartialBailOff`` -- Only used if the parameter
+  above is set to 1. When ORTSDynamicBrakesHasPartialBailOff is set to 0 (default),
+  air brakes will be fully released when dynamic brake is providing at least the 85%
+  of the total train brake demand. When set to 1, only part of the air from the brake
+  cylinder is released, so the total air+dynamic brake force equals the total brake demand.
+
+
 Native Open Rails Braking Parameters
 ------------------------------------
 
@@ -2898,6 +2939,8 @@ MaxAuxilaryChargingRate and EmergencyResChargingRate.
    single: ORTSBrakeServiceTimeFactor
    single: ORTSBrakeEmergencyTimeFactor
    single: ORTSBrakePipeTimeFactor
+   single: ORTSEPBrakeControlsBrakePipe
+   single: ORTSCompressorIsMuControlled
 
 - ``Wagon(BrakePipeVolume`` -- Volume of car's brake pipe in cubic feet
   (default .5).
@@ -2919,6 +2962,8 @@ MaxAuxilaryChargingRate and EmergencyResChargingRate.
   for twin pipe systems, if the main reservoir pipe is used for charging the auxiliary
   reservoirs. If set to false, the main reservoir pipe will not be used
   by the brake system.
+- ``Wagon(ORTSEPBrakeControlsBrakePipe`` -- Set to 1 for UIC EP brake: brake pipe
+  pressure is electrically controlled at every fitted car.
 - ``Engine(ORTSMainResChargingRate`` -- Rate of main reservoir pressure change
   in psi per second when the compressor is on (default .4).
 - ``Engine(ORTSEngineBrakeReleaseRate`` -- Rate of engine brake pressure
@@ -2942,6 +2987,8 @@ MaxAuxilaryChargingRate and EmergencyResChargingRate.
   (default .003).
 - ``Engine(AirBrakeMaxMainResPipePressure`` -- Pressure in Main Reservoir 
   Pipe for twin pipe braking systems (default = Main Reservoir Pressure).
+- ``Engine(ORTSCompressorIsMuControlled`` -- Set to 1 if compressors from
+  all locomotives are synchronized.
 
 .. _physics-retainers: