From 8ec94b6f617dc1314221f0ebf6b01467c62950e3 Mon Sep 17 00:00:00 2001 From: Ron Yorston Date: Wed, 7 Jan 2015 10:33:03 +0000 Subject: Update README --- README | 2 +- README.md | 19 +++++++++++++++++++ README.win32 | 32 -------------------------------- 3 files changed, 20 insertions(+), 33 deletions(-) create mode 100644 README.md delete mode 100644 README.win32 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. -- cgit v1.2.3-55-g6feb