Update README

3 files changed, 20 insertions, 33 deletions

diff --git a/README b/README
index 9b1774a7f..82f72e5a8 100644
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-Please see README.win32 for Windows-specific info.
+Please see README.md for Windows-specific info.
 Please see the LICENSE file for details on copying and usage.
 Please refer to the INSTALL file for instructions on how to build.
 
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..1ef735a74
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+### Status
+
+This port is used in production at Tigress.  Things may work for you, or may not.  Things may never work because of huge differences between Linux and Windows.  Or things may work in future, if you report the problem to https://github.com/rmyorston/busybox-w32.
+
+### Building
+
+You need a MinGW compiler and a POSIX environment (so that `make menuconfig` works).  I cross compile from Linux, but MSYS or Cygwin should be OK.
+
+To start, run `make mingw32_defconfig`.  You can then customize your build with `make menuconfig`.
+
+In particular you may need to adjust the compiler by going to Busybox Settings -> Build Options -> Cross Compiler Prefix
+
+Then just `make`.
+
+### Limitations
+
+ - Use forward slashes in paths:  Windows doesn't mind and the shell will be happier.
+ - Don't do wild things with Windows drive or UNC notation.
+ - tar doesn't support seamless compression/decompression:  use a pipeline to a compressor/decompressor.
diff --git a/README.win32 b/README.win32
deleted file mode 100644
index 9e9c8f39f..000000000
--- a/README.win32
+++ /dev/null
@@ -1,32 +0,0 @@
-Status
-======
-
-I would consider this port experimental. Things may work, or may not.
-Things may never work because of huge differences between Linux and
-Windows. Or things may work in future, if you report the faults to
-https://github.com/rmyorston/busybox-w32, especially with patches.
-
-Building
-========
-
-You need MinGW compiler and a POSIX environment (so that "make
-menuconfig" works).  I cross compile from Linux, but MSYS or Cygwin
-should be OK.
-
-To start, run "make mingw32_defconfig".  You can then customize your
-build with "make menuconfig".
-
-In particular you may need to adjust the compiler by going to Busybox
-Settings -> Build Options -> Cross Compiler Prefix
-
-Then just "make".
-
-Attempts to make it work with MS Visual Studio are appreciated. You
-can start with porting kconfig ;-)
-
-Limitation
-==========
-
- - Use forward slashes. Backslash support is very limited.
- - Do not do wild things with Windows drive notation, like archiving a
-   whole drive. If you want it, tell us, preferably with patches.