Move case sensitivity to fs api page

This commit is contained in:
Lupus590 2022-06-09 07:45:52 +01:00
parent 8eb463b6ae
commit 19e2afc6a6
2 changed files with 9 additions and 8 deletions

View File

@ -16,15 +16,8 @@ ## The magic names
startup
startup.lua
```
`startup` may be a file or a folder, the behaviour of it changes depending on which it is but we'll cover that in a bit. `startup.lua` has to be a file.
`startup` may be a file or a folder, the behaviour of it changes depending on which it is but we'll cover that in a bit. `startup.lua` has to be a file. Note that these are all lower case, case matters sometimes so keep to the correct one - more info in a note on the @{fs} API page.
:::note Case sensitivity
Startup file names are all lowercase.
CC inherits the case sensitivity of the real world OS that the Minecraft server is running on, so if you are used to Microsoft Windows' case insensitivity (e.g. `startup.lua` and `StartUp.Lua` are considered the same when used as file names) and play on a server (which will likely be running Linux which is case sensitive) then you should keep in mind that programs which work on your machine in singleplayer may not work correctly on the server if you are inconsistent with the case that you use for file names.
To reiterate, startup file names are all lowercase. CC is looking for `startup` and `startup.lua` not `Startup` or any other capitalisations.
:::
## Searching drives for startup files
If `shell.allow_disk_startup` is true (which it is by default), then the CC computer will look for disk drives that have at least one startup file, it only uses the first disk that fulfils these criteria. Disk drives are searched in the order they are found via `peripheral.getNames()`. It then runs the found startup files as described below.

View File

@ -61,6 +61,14 @@
* an incredibly large file) will fail. You can see a mount's capacity with {@link #getCapacity} and the remaining
* space with {@link #getFreeSpace}.
*
* :::note Case sensitivity
* CC inherits the case sensitivity of the real world OS that the Minecraft server is running on, so if you are used to
* Microsoft Windows' case insensitivity (e.g. `startup.lua` and `StartUp.Lua` are considered the same when used as
* file names) and play on a server (which will likely be running Linux which is case sensitive) then you should keep
* in mind that programs which work on your machine in singleplayer may not work correctly on the server if you are
* inconsistent with the case that you use for file names.
* :::
*
* @cc.module fs
*/
public class FSAPI implements ILuaAPI