[sdpb] 186/233: Moved Win instructions to a separate file

Thu Mar 9 04:06:37 UTC 2017

This is an automated email from the git hooks/post-receive script.

thansen pushed a commit to branch master
in repository sdpb.

commit 9660d090d418d78f6478a1db96c9a7f4ea574688
Author: pkravchuk <pkravchuk at users.noreply.github.com>
Date:   Wed Oct 21 16:45:59 2015 -0400

    Moved Win instructions to a separate file
---
 Readme_Win.md | 80 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)

diff --git a/Readme_Win.md b/Readme_Win.md
new file mode 100644
index 0000000..a7a3281
--- /dev/null
+++ b/Readme_Win.md
@@ -0,0 +1,80 @@
+
+The following instructions have been tested on Windows 8.1 using Boost 1.59.0, GMP 6.0.0, Cygwin DLL ver. 2.2.1. These are written to be accessible to people with no Unix experience by a person with little Unix experience, so suggestions to improve are appreciated.
+
+Below are the steps to build SDPB executable on your machine. These steps use Cygwin to provide POSIX environment for SDPB and its dependecies. To simplify the process, it is assumed that you do not intend to use Boost or GMP installations for a purpose other than building SDPB. The goal here was not to follow the best practices of Unix, but to make the installation process as quick as possible.
+
+It is not required to have any specific directory structure for the installation. However, to be concrete, it is assumed in the instructions that you have created a directory `C:\SDPB`, where you are going to store files related to SDPB. The filenames used in the instructions are suitable for Boost 1.59.0 and GMP 6.0.0a. If you are using newer versions, you will have to use the appropriate file and directory names.
+
+1. Download and install Cygwin from [the Cygwin installation webpage](http://cygwin.com/install.html). Choose the appropriate version (32-bit or 64-bit) and run the dowloaded executable file (`setup-x86.exe` or `setup-x86_64.exe`). 
+  1. Choose `Install from Internet`.
+  2. Choose the installation directory and the directory for storing the downloaded packages.
+  3. Choose appropriate proxy settings. If you don't know what it is, try `Direct Connection` or `Use Internet Explorer Proxy Settings`.
+  4. Choose a download site. Any choice should work.
+  5. Choose the packages for installation. You will need
+    * All the `Base` packages (choosen by defaul, no action should be required).
+    * `bzip2` and `lzip` in `Archive`.
+    * `gcc-core`, `gcc-g++` and `make` under `Devel`
+    * `m4` under `Interpreters`
+    * If in further steps some required tools are found to be missing, they can be installed by re-running this installer.
+  6. Continue and accept any package dependencies.
+  7. (optional) When the installation is finished, add the `\bin` subdirectory of the Cygwin installation directory to your system `Path` variable.
+2. Download and build Boost from [the Boost website](http://www.boost.org). You should get the Unix variant. Put the downloaded file in `C:\SDPB`.
+  1. Run the Cygwin terminal. Navigate to `C:\SDPB` by typing
+
+           cd /cygdrive/c/SDPB
+
+     and pressing Enter key. Note that the paths are case-sensitive, but the drive letter has to be lowercase.
+  2. Unpack the Boost archive by typing
+
+           tar --bzip2 -xf boost_1_59_0.tar.bz2
+
+  3. Navigate to Boost directory and build the required Boost libraries. For this, type
+
+           cd boost_1_59_0/
+           ./bootstrap.sh --with-libraries=filesystem,serialization,program_options,date_time,timer
+           ./b2 stage
+           
+     Note: Using `stage` target instead of `install` can save a lot of time by skipping the copying of Boost header files, which is done more efficiently by Windows methods.
+           
+3. Dowload and build GMP from [the GMP website](https://gmplib.org). Download the latest version, and put the file in `C:\SDPB`.
+  1. In Cygwin terminal, navigate to `C:\SDPB` and upack the archive. For this, type
+
+           cd /cygdrive/c/SDPB
+           tar --lzip -xf gmp-6.0.0a.tar.lz
+           
+  2. Build GMP libraries. For this, type
+
+           mkdir installation
+           cd gmp-6.0.0
+           ./configure --enable-cxx --prefix=/cygdrive/c/SDPB/installation
+           make install
+           
+  3. Run GMP tests to make sure that everything is in order
+
+           make check
+           
+4. Collect the header and lib files in one place
+  1. Move `C:\SDPB\boost_1_59_0\boost` directory into `C:\SDPB\installation\include` (so you will now have `C:\SDPB\installation\include\boost` directory).
+  2. Copy the contents of `C:\SDPB\boost_1_59_0\stage\lib` directory into `C:\SDPB\installation\lib`.
+  3. (optional) Add `C:\SDPB\installation\lib` to your system `Path` variable.
+
+5. Download and build SDPB. Obtain the latest SDPB sources from github, for example, by dowloading the zip of the repository and unpacking the contents into `C:\SDPB`. As the result you should have the contents of the repository in `C:\SDPB\sdpb-master`.
+  1. Use any text-editing software to open `C:\SDPB\sdpb-master\Makefile`
+    * Follow the instructions in the file to locate the variables `GMPINCLUDEDIR` and `BOOSTINCLUDEDIR` as well as `LIBDIR`, which should be edited on a **Windows** system.
+    * Edit the appropriate lines to look as follows
+
+                      GMPINCLUDEDIR = /cygdrive/c/SDPB/installation/include
+                      BOOSTINCLUDEDIR = /cygdrive/c/SDPB/installation/include/boost
+                      LIBDIR = /cygdrive/c/SDPB/installation/lib
+
+    * Save the file and exit
+  2. In Cygwin terminal, navigate to `C:\SDPB\sdpb-master` and build SDPB
+  
+           cd /cygdrive/c/SDPB/sdpb-master
+           make
+
+    After the process finishes, `sdpb.exe` should appear in `C:\SDPB\sdpb-master`
+
+6. If you have added all the suggested locations to your system `Path` variable, then you should be able to run sdpb.exe. If you have not, then you need to either modify `Path` variable or put copies of the `.dll` files from `C:\SDPB\installation\lib` and a copy of `cygwin1.dll` from `\bin` subdirectory of Cygwin installation in the directory where you would like to keep `sdpb.exe`. You then might want to add this directory to `Path` variable.
+
+

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-science/packages/sdpb.git

