Browse Source

Merge pull request #37297 from dalexeev/doc_file

Improve the `File.store_{8,16,32,64}()` documentation
Rémi Verschelde 5 years ago
parent
commit
c52beb6adb
1 changed files with 4 additions and 0 deletions
  1. 4 0
      doc/classes/File.xml

+ 4 - 0
doc/classes/File.xml

@@ -297,6 +297,7 @@
 			</argument>
 			</argument>
 			<description>
 			<description>
 				Stores an integer as 16 bits in the file.
 				Stores an integer as 16 bits in the file.
+				[b]Note:[/b] The [code]value[/code] should lie in the interval [code][0, 2^16 - 1][/code].
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="store_32">
 		<method name="store_32">
@@ -306,6 +307,7 @@
 			</argument>
 			</argument>
 			<description>
 			<description>
 				Stores an integer as 32 bits in the file.
 				Stores an integer as 32 bits in the file.
+				[b]Note:[/b] The [code]value[/code] should lie in the interval [code][0, 2^32 - 1][/code].
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="store_64">
 		<method name="store_64">
@@ -315,6 +317,7 @@
 			</argument>
 			</argument>
 			<description>
 			<description>
 				Stores an integer as 64 bits in the file.
 				Stores an integer as 64 bits in the file.
+				[b]Note:[/b] The [code]value[/code] must lie in the interval [code][-2^63, 2^63 - 1][/code] (i.e. be a valid [int] value).
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="store_8">
 		<method name="store_8">
@@ -324,6 +327,7 @@
 			</argument>
 			</argument>
 			<description>
 			<description>
 				Stores an integer as 8 bits in the file.
 				Stores an integer as 8 bits in the file.
+				[b]Note:[/b] The [code]value[/code] should lie in the interval [code][0, 255][/code].
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="store_buffer">
 		<method name="store_buffer">