-/** Propeller modeling class.
- FGPropeller models a propeller given the tabular data for Ct and Cp
- indexed by advance ratio "J". The data for the propeller is
- stored in a config file named "prop_name.xml". The propeller config file
- is referenced from the main aircraft config file in the "Propulsion" section.
- See the constructor for FGPropeller to see what is read in and what should
- be stored in the config file.<br>
+/** FGPropeller models a propeller given the tabular data for Ct and Cp,
+ indexed by the advance ratio "J".
+
+<h3>Configuration File Format:</h3>
+@code
+<propeller name="{string}">
+ <ixx> {number} </ixx>
+ <diameter unit="IN"> {number} </diameter>
+ <numblades> {number} </numblades>
+ <gearratio> {number} </gearratio>
+ <minpitch> {number} </minpitch>
+ <maxpitch> {number} </maxpitch>
+ <minrpm> {number} </minrpm>
+ <maxrpm> {number} </maxrpm>
+ <constspeed> {number} </constspeed>
+ <reversepitch> {number} </reversepitch>
+ <sense> {1 | -1} </sense>
+ <p_factor> {number} </p_factor>
+ <ct_factor> {number} </ct_factor>
+ <cp_factor> {number} </cp_factor>
+
+ <table name="C_THRUST" type="internal">
+ <tableData>
+ {numbers}
+ </tableData>
+ </table>
+
+ <table name="C_POWER" type="internal">
+ <tableData>
+ {numbers}
+ </tableData>
+ </table>
+
+ <table name="CT_MACH" type="internal">
+ <tableData>
+ {numbers}
+ </tableData>
+ </table>
+
+ <table name="CP_MACH" type="internal">
+ <tableData>
+ {numbers}
+ </tableData>
+ </table>
+
+
+</propeller>
+@endcode
+
+<h3>Configuration Parameters:</h3>
+<pre>
+ \<ixx> - Propeller rotational inertia.
+ \<diameter> - Propeller disk diameter.
+ \<numblades> - Number of blades.
+ \<gearratio> - Ratio of (engine rpm) / (prop rpm).
+ \<minpitch> - Minimum blade pitch angle.
+ \<maxpitch> - Maximum blade pitch angle.
+ \<minrpm> - Minimum rpm target for constant speed propeller.
+ \<maxrpm> - Maximum rpm target for constant speed propeller.
+ \<constspeed> - 1 = constant speed mode, 0 = manual pitch mode.
+ \<reversepitch> - Blade pitch angle for reverse.
+ \<sense> - Direction of rotation (1=clockwise as viewed from cockpit,
+ -1=anti-clockwise as viewed from cockpit).
+ \<p_factor> - P factor.
+ \<ct_factor> - A multiplier for the coefficients of thrust.
+ \<cp_factor> - A multiplier for the coefficients of power.
+</pre>
+
+ Two tables are needed. One for coefficient of thrust (Ct) and one for
+ coefficient of power (Cp).
+
+ Two tables are optional. They apply a factor to Ct and Cp based on the
+ helical tip Mach.
+ <br>
+