v2.1 beta 1

All the changes and fixes of v2.0.5 beta 1 and more:

* Addied the license file and the Markdown documentation.

* Fix #3: RDBLK can't read files with read-only attribute

* Change in boot keys: now the key to request one single drive per driver is the 5 key, and CTRL is simply passed to MSX-DOS kernels as when booting with MSX-DOS.

* Added the "User is requesting reduced drive count" flag to the input of the DRV_INIT routine and the DRV_CONFIG routine.

.gitignore

@@ -1,5 +1,6 @@
 syntax: glob
 
+.vs/
 bin/**
 *.sym
 *.SYM
@@ -22,25 +23,26 @@ dos250ba.dat
 kernel.dat
 nextor2.rom
 info/*.pdf
-source/msxdos25/bank*/**.inc
-source/msxdos25/drivers/**.inc
-source/msxdos25/bank5/**.dat
-source/msxdos25/bank5/**.asm
-source/command25/msxdos/**.inc
-source/command25/msxdos/codes.mac
-source/command25/msxdos/data.mac
+source/kernel/bank*/*.inc
+source/kernel/drivers/*.inc
+source/kernel/drivers/**/*.inc
+source/kernel/drivers/**/*.lst
+!source/kernel/drivers/MegaFlashRomSD/*.bin
+source/kernel/drivers/**/*.rom
+source/kernel/drivers/**/*.ROM
+source/kernel/bank5/*.dat
+source/kernel/bank5/*.asm
+source/command/msxdos/*.inc
+source/command/msxdos/codes.mac
+source/command/msxdos/data.mac
 source/tools/**.inc
 source/tools/**.asm
 source/tools/**.com
 source/tools/**.COM
 source/tools/codes.mac
 source/tools/data.mac
-source\tools\C\*.asm
-source\tools\C\*.com
 *conflicto*.*
 *.sln
 *.suo
 NEXTOR.SYS
 NEXTORK.SYS
-
-

LICENSE.md

@@ -0,0 +1,16 @@
+MSX-DOS is (c) 2018 The MSX Licensing Corporation
+Nextor is (c) 2018 Nestor Soriano Vilchez
+
+Nextor is a fork of MSX-DOS and as such it makes extensive use of the MSX-DOS source code. The MSX Licensing Corporation authorizes this usage under the following terms:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish and/or distribute the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+- The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+- Commercial usage of the Software is not allowed without explicit permission from the copyright holders. "Commercial usage" means selling copies of the Software, either in source code form or in binary form.
+
+- Producing and distributing hardware that includes the Software in ROM (or in an equivalent built-in storage media) is allowed as long as no fee is charged for the Software itself. That is, the selling price of the hardware must be the same it would be if it didn't include the Software.
+
+- Derivative works are not allowed without explicit permission from the copyright holders. "Derivative works" means independent projects that are created as forks of the original source code for the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -1,7 +1,60 @@
 # Nextor
 
-This branch is a bit outdated, it needs some cleanup and syncrhonization work. In the mean time please see:
+Nextor is a disk operating system for MSX computers. It is built on top of the source code of MSX-DOS 2.31, released in 1991.
 
-* The README.md file for the `v.2.0` branch
+The source code of Nextor is published with permission from the MSX Licensing Corporation under certain terms. **Please take a moment to read [the license terms](LICENSE.md) for details**.
 
-* The `Nextor-2.1-alpha-1.txt` and `Nextor-2.1-alpha-2.txt` files in the `info` folder of this branch
+Please visit [the Nextor section in Konamiman's MSX page](https://www.konamiman.com/msx/msx-e.html#nextor) for binaries.
+
+## Repository structure
+
+Note that there is no `master` branch, but branches for each major version of Nextor (v2.0 and v2.1 currently).
+
+* [**source**](/source): The source code of Nextor itself.
+
+    * [**kernel**](source/kernel): The kernel ROM, includes the FDISK tool.
+
+    * [**command**](source/command): `NEXTOR.SYS`, `COMMAND2.COM` and the command line tools that were originally supplied with MSX-DOS.
+
+    * [**tools**](source/tools): The new command line tools created for Nextor.
+
+* [**wintools**](/wintools): Windows tools needed for building Nextor. Includes the source for two custom made tools: [`mknexrom`](/wintools/mknexrom.c) (C) and [`SymToEqus`](/wintools/SymToEqus.cs) (C#).
+
+* [**docs**](/docs): Documentation for both users and developers.
+
+## How to build Nextor
+
+You need:
+
+1. A Windows machine (if you don't have one see ["No Windows?"](#no-windows) below)
+2. SDCC ([http://sdcc.sourceforge.net](http://sdcc.sourceforge.net)), targetting the Z80 processor, to build FDISK.
+3. .NET Framework 2.0 or higher (for the `SymToEqus` tool in the `wintools` folder)
+4. The `wintools` folder must be added to the `PATH` environment variable
+
+### To build the Nextor kernel
+
+Run the `compile.bat` script located in the `source\kernel` folder. If the FDISK tool has not been compiled already (the `fdisk.dat` and `fdisk2.dat` files do not exist in the `bank5` folder), they will be compiled on the fly.
+
+The generated kernel base file and the complete ROM files will be generated in the `bin\kernels` folder. One ROM file will be generated for each folder existing in the `source\kernel\drivers` folder.
+
+### To build the FDISK tool only
+
+If you make a change in the FDISK tool, you can compile it without having to compile the full kernel again. Just run the `compile.bat` script in the `source\kernel\bank5` folder (do NOT run `compfdsk.bat`). The ROM files in `bin\kernels` will be appropriately updated.
+
+### To build the command line tools
+
+Run the `compile.bat` script in the `source\tools` folder. The tools will be generated in the `bin\tools` folder.
+
+### To build `NEXTOR.SYS`
+
+Run the `compile.bat` script in the `source\command\msxdos` folder. The file will be generated in the `bin\tools` folder.
+
+### To build `COMMAND2.COM`
+
+Run the `compile.bat` script in the `source\command\command` folder. The file will be generated in the `bin\tools` folder.
+
+At this time there's no specific script (other than the original makefile) for building the original MSX-DOS command line tools.
+
+### No Windows?
+
+If your machine doesn't run Windows you can still build Nextor by using Xesco's [Nextor builder](https://github.com/xesco/NextorBuilder).