summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPatric Stout <truebrain@openttd.org>2021-05-29 11:08:58 +0200
committerPatric Stout <github@truebrain.nl>2021-05-29 11:27:00 +0200
commitb0f44d7eb1cfac13a5ede8b7154664f5fb455775 (patch)
treee4344a0a4bffd74089047223773b1274c5b5394e
parente58046c9477d52470ebb50e2dbd1ccc1af9dae25 (diff)
downloadopenttd-b0f44d7eb1cfac13a5ede8b7154664f5fb455775.tar.xz
Doc: describe what each settings-file is about
-rw-r--r--src/table/settings/company_settings.ini3
-rw-r--r--src/table/settings/currency_settings.ini2
-rw-r--r--src/table/settings/gameopt_settings.ini9
-rw-r--r--src/table/settings/misc_settings.ini3
-rw-r--r--src/table/settings/settings.ini3
-rw-r--r--src/table/settings/win32_settings.ini3
-rw-r--r--src/table/settings/window_settings.ini3
7 files changed, 26 insertions, 0 deletions
diff --git a/src/table/settings/company_settings.ini b/src/table/settings/company_settings.ini
index bb104adeb..576710065 100644
--- a/src/table/settings/company_settings.ini
+++ b/src/table/settings/company_settings.ini
@@ -4,6 +4,9 @@
; See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
;
+; These are settings that are company-wide. Meaning that if 1 player in a
+; company changes them, it changes for all players.
+
[pre-amble]
static void UpdateServiceInterval(int32 new_value);
static bool CanUpdateServiceInterval(VehicleType type, int32 &new_value);
diff --git a/src/table/settings/currency_settings.ini b/src/table/settings/currency_settings.ini
index ce0213758..a10583150 100644
--- a/src/table/settings/currency_settings.ini
+++ b/src/table/settings/currency_settings.ini
@@ -4,6 +4,8 @@
; See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
;
+; Settings for the in-game custom currency.
+
[pre-amble]
static const SettingTable _currency_settings{
[post-amble]
diff --git a/src/table/settings/gameopt_settings.ini b/src/table/settings/gameopt_settings.ini
index b3b7ec651..849c731b6 100644
--- a/src/table/settings/gameopt_settings.ini
+++ b/src/table/settings/gameopt_settings.ini
@@ -4,6 +4,15 @@
; See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
;
+; Settings that used to be saved in the savegame under the OPTS chunk and
+; under "gameopts" in the configuration file, but no longer are. Most of these
+; are now moved to other places.
+;
+; For backwards compatability, this file dictates how both were saved. When
+; a configuration files contains these entries, they are read once, and removed
+; from the configuration file afterwards. Those that are still supported will
+; be saved in their new place.
+
[pre-amble]
static const uint GAME_DIFFICULTY_NUM = 18;
static uint16 _old_diff_custom[GAME_DIFFICULTY_NUM];
diff --git a/src/table/settings/misc_settings.ini b/src/table/settings/misc_settings.ini
index 1b633a65a..bafdf2369 100644
--- a/src/table/settings/misc_settings.ini
+++ b/src/table/settings/misc_settings.ini
@@ -4,6 +4,9 @@
; See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
;
+; Various of settings that are stored in global variables. They are all
+; located under "misc" in the configuration files.
+
[pre-amble]
extern std::string _config_language_file;
diff --git a/src/table/settings/settings.ini b/src/table/settings/settings.ini
index 3c22ec4c1..51481e1c7 100644
--- a/src/table/settings/settings.ini
+++ b/src/table/settings/settings.ini
@@ -4,6 +4,9 @@
; See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
;
+; Settings as stored in the main configuration file ("openttd.cfg") and in the
+; savegame PATS chunk (if not flagged not to).
+
[pre-amble]
/* Begin - Callback Functions for the various settings */
static void v_PositionMainToolbar(int32 new_value);
diff --git a/src/table/settings/win32_settings.ini b/src/table/settings/win32_settings.ini
index 6b7d5276d..7a3fb9a5c 100644
--- a/src/table/settings/win32_settings.ini
+++ b/src/table/settings/win32_settings.ini
@@ -4,6 +4,9 @@
; See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
;
+; Windows specific settings that are stored in global variables. They are all
+; located under "win32" in the configuration files.
+
[pre-amble]
/* win32_v.cpp only settings */
#if defined(_WIN32) && !defined(DEDICATED)
diff --git a/src/table/settings/window_settings.ini b/src/table/settings/window_settings.ini
index 560a197ab..17596a4d5 100644
--- a/src/table/settings/window_settings.ini
+++ b/src/table/settings/window_settings.ini
@@ -4,6 +4,9 @@
; See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
;
+; The windows configuration file ("windows.cfg") defines various of properties
+; of all windows.
+
[pre-amble]
static const SettingTable _window_settings{