db4a52faff9e158040f0dea8bd0fddf010f9056a
[debian/openrocket] / core / doc / properties.txt
1
2 System properties used by OpenRocket:
3 =====================================
4
5 General options
6 ---------------
7
8 openrocket.locale
9         Select the default locale to be used, for example "en_US".
10         If set to "xx", the logical keys will be displayed instead of the translated strings.
11
12
13
14 Logging options
15 ---------------
16
17 Possible values are ERROR, WARN, USER, INFO, DEBUG and ALL.
18
19
20 openrocket.log.stderr
21         Defines from which log level upwards log events are written to STDERR.  Defaults to no output.
22
23 openrocket.log.stdout
24         Defines from which log level upwards log events are written to STDOUT.  Defaults to no output.
25
26 openrocket.log.tracelevel
27         Defines from which log level upwards the logging position is stored along with the log line.
28         Defaults to INFO.
29
30
31
32
33 Debugging options
34 -----------------
35
36 openrocket.debug
37         Turns on various options useful for debugging purposes.  The parameters defined are:
38                 openrocket.log.stdout=VBOSE
39                 openrocket.log.tracelevel=VBOSE
40                 openrocket.debug.menu=true
41                 openrocket.debug.motordigest=true
42                 openrocket.debug.mutexlocation=true
43
44
45 openrocket.debug.menu
46         If defined the "Debug" menu will be displayed in the main application window.
47
48 openrocket.debug.prefs
49         If defined a new, clean set of preferences will be used (does not overwrite the existing preferences).
50
51 openrocket.debug.mutexlocation
52         Store a stack trace of the location where safety mutexes are locked.  This slows down usage of the
53         mutexes a bit.
54
55 openrocket.debug.bugurl
56         URL used for sending bug reports.
57
58 openrocket.debug.updateurl
59         URL used for retrieving update notifications.
60
61 openrocket.debug.motordigest
62         If defined the motor digest will be displayed in the selection dialog.
63
64 openrocket.debug.coordinatecount
65         If defined, the number of instantiations of the Coordinate class are counted and reported
66         every 1M instantiations, or as often as defined by this parameter.
67
68 openrocket.debug.quaternioncount
69         If defined, the number of instantiations of the Quaternion class are counted and reported
70         every 1M instantiations, or as often as defined by this parameter.
71
72 openrocket.debug.safetycheck
73         If defined (and not "false" or "off") then additional safety checks will be performed
74         in the code to prevent e.g. unsafe concurrent access to objects.  Currently disabled by
75         default, this will later be enabled by default.
76
77