From baa3ca897683b0d131e986b832ff540acc5cb186 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Florian=20N=C3=BCcke?= Date: Mon, 14 Feb 2022 00:32:35 +0100 Subject: [PATCH] Reword disk drive docs a bit, to hopefully make it more clear on how to use it. Closes #118. --- .../assets/oc2/doc/en_us/block/disk_drive.md | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/src/main/resources/assets/oc2/doc/en_us/block/disk_drive.md b/src/main/resources/assets/oc2/doc/en_us/block/disk_drive.md index 379c7146..e655359a 100644 --- a/src/main/resources/assets/oc2/doc/en_us/block/disk_drive.md +++ b/src/main/resources/assets/oc2/doc/en_us/block/disk_drive.md @@ -1,13 +1,20 @@ # Disk Drive ![Taking it for a spin](block:oc2:disk_drive) -The disk drive provides an option for quick media exchange. [Floppy disks](../item/floppy.md) can be added and removed at runtime, unlike [hard drives](../item/hard_drive.md). +The disk drive provides an option for quick media exchange. [Floppy disks](../item/floppy.md) can be added and removed +at runtime, unlike [hard drives](../item/hard_drive.md). Note that it is highly advisable to explicitly unmount your floppy before removing it from the drive to avoid data loss. -On a Linux system, disk drives will typically appear as `/dev/vdX` devices, following any installed hard drives. On the default Linux distribution, the following commands may be useful: -- `mke2fs /dev/vdX` to format a floppy disk. -- `mount /dev/vdX ` to mount a floppy disk. -- `umount ` to unmount a floppy disk. +On a Linux system, disk drives will typically appear as `/dev/vdX` devices, following any installed hard drives. They +are not automatically formatted or mounted, but will only appear as raw block devices. To use them, you'll need to +configure them, first. For example, on the default Linux distribution, the following commands will be useful: -Computers *have to be shut down* before installing or removing this component. Installing it while the computer is running will have no effect, removing it may lead to system errors. \ No newline at end of file +- `mke2fs /dev/vdX` to format a floppy disk. Run this when first installing the disk. *Will erase data on floppy!* +- `mount /dev/vdX ` to mount a floppy disk after formatting it. Make sure the directory you want to + mount it to exists and is empty. +- `umount ` to unmount a floppy disk. Make sure to run this before removing the floppy from the disk + drive, to avoid data loss. + +Computers *have to be shut down* before installing or removing this component. Installing it while the computer is +running will have no effect, removing it may lead to system errors.