Browse Source

Document that ConfigFiles can use any file extension

The file extension given to a ConfigFile has no impact on its
formatting or behavior.

(cherry picked from commit 9c6ae95cb2a44dcc3235b896252c7dadabfe533d)
Hugo Locurcio 4 years ago
parent
commit
348152b3c9
1 changed files with 1 additions and 0 deletions
  1. 1 0
      doc/classes/ConfigFile.xml

+ 1 - 0
doc/classes/ConfigFile.xml

@@ -47,6 +47,7 @@
 		[/codeblock]
 		Keep in mind that section and property names can't contain spaces. Anything after a space will be ignored on save and on load.
 		ConfigFiles can also contain manually written comment lines starting with a semicolon ([code];[/code]). Those lines will be ignored when parsing the file. Note that comments will be lost when saving the ConfigFile. This can still be useful for dedicated server configuration files, which are typically never overwritten without explicit user action.
+		[b]Note:[/b] The file extension given to a ConfigFile does not have any impact on its formatting or behavior. By convention, the [code].cfg[/code] extension is used here, but any other extension such as [code].ini[/code] is also valid. Since neither [code].cfg[/code] nor [code].ini[/code] are standardized, Godot's ConfigFile formatting may differ from files written by other programs.
 	</description>
 	<tutorials>
 	</tutorials>