From b671b086cec9c24f17c6affcedfcc890209253fb Mon Sep 17 00:00:00 2001 From: Jeff Parsons Date: Wed, 21 Jun 2017 16:55:12 -0700 Subject: [PATCH] Website README updates --- disks/README.md | 10 +++++++--- disks/pcx86/README.md | 17 ++++++++++------- 2 files changed, 17 insertions(+), 10 deletions(-) diff --git a/disks/README.md b/disks/README.md index 518f0f958..2a4d7e242 100644 --- a/disks/README.md +++ b/disks/README.md @@ -21,14 +21,18 @@ Additional selected software is available in the PCjs [Software Archives](/apps/ ### PCx86 Disk Image Formats -PCx86 works best with disk images in a **JSON** format, to save conversion time, so that's the -only disk format you'll find in the [PCjs Project](https://github.com/jeffpar/pcjs). +PCx86 works best with disk images in a **JSON** format, so that's the only disk format you'll +find in the [PCjs Project](https://github.com/jeffpar/pcjs). There are several ways you can convert a PCjs **JSON** disk image back into a binary **IMG** file: -- Load the desired disk into a PCjs machine and click the **Save** button +- Load the disk into a PCjs machine and click the **Save** button - Use the [DiskDump API](/api/v1/dump) (available only in the [PCjs Node Web Server](/server.js)) +Note that whenever you **Save** a disk inside a PCjs machine, it is saved exactly as it exists +at that point in time. So, if you made any changes to the disk, those changes will be preserved +in your saved copy. Otherwise, the disk image should be an exact copy of the original PCjs disk. + When using the [DiskDump API](/api/v1/dump), set the *format* parameter set to `img` instead of `json`. For example: diff --git a/disks/pcx86/README.md b/disks/pcx86/README.md index 26c0b7eac..0c9592b46 100644 --- a/disks/pcx86/README.md +++ b/disks/pcx86/README.md @@ -9,14 +9,17 @@ IBM PC Disk Library Our [IBM PC Disk Library](/disks/pcx86/library.xml) lists all the [Disk Manifests](#disk-manifests) in the [PCjs Project](/docs/about/) and makes those disks available to any [IBM PC Machine](/devices/pcx86/machine/) -in the project that uses the library. Note that most machines use the *[compiled](/disks/pcx86/compiled/library.xml)* -form of the library, to reduce machine load time. +in the project that uses the library. -The summary below is not a complete list of everything in the library, just highlights. -For some of the disks, we have provided more information about the software, and in some cases, -machines that automatically run the software. Ideally, everything in the library would also be listed below, -and linked to a page that describes the software in more detail, along with a live demonstration of the software, -but that's not yet a reality. +Whenever possible, PCjs archives copies of original distribution diskettes. Exceptions include the application +"Demo Disks" that we've created for our [IBM PC Application Demos](/apps/pcx86/). PCjs may also make minor changes +to a disk's boot sector, to ensure that all PCjs disk images can be mounted in modern operating systems. This is +documented, for example, in the description of the [PC-DOS 0.90](/disks/pcx86/dos/ibm/0.90/) disk. + +The summary below is not a complete list of everything in the library, just highlights. For some of the disks, +we have provided more information about the software, and in some cases, machines that automatically run the software. +Ideally, everything in the library would also be listed below, and linked to a page that describes the software in +more detail, along with a live demonstration of the software, but that's not yet a reality. ### Operating Systems