Changeset 297:9d1f71a9de51 for src/mlx/checks.py

Timestamp:

07/21/12 10:50:57 (12 years ago)

Author:

István Váradi <ivaradi@…>

Branch:

default

Phase:

public

Message:

Added some further documentation

File:

• src/mlx/checks.py (modified) (2 diffs)

src/mlx/checks.py

@@ -1 @@
-# The various checks that may be performed during flight
+## @package mlx.checks
+#
+# The classes that check the state of the aircraft.
+#
+# During the flight the program periodically queries various data from the
+# simulator. This data is returned in instances of the \ref
+# mlx.fs.AircraftState class and passed to the various "checkers",
+# i.e. instances of subclasses of the \ref StateChecker class. These checkers
+# perform various checks to see if the aircraft's parameters are within the
+# expected limits, or some of them just logs something.
+#
+# There are a few special ones, such as \ref StageChecker which computes the
+# transitions from one stage of the flight to the next one. Or \ref ACARSSender
+# which sends the ACARS periodically
 
 #---------------------------------------------------------------------------------------
@@ -94 +107 @@
     It sends the ACARS every 3 minutes to the MAVA website."""
 
-    # The interval at which ACARS is sent
+    ## The interval at which the ACARS are sent
     INTERVAL = 3*60.0