# HG changeset patch
# User Maxim Dounin <mdounin@mdounin.ru>
# Date 1508252256 -10800
# Node ID 237b67ef69a65bb92e0986aa7ce5558fe6186199
# Parent  18d876538eee13e0476550d8b0767995ef77ec10
Improved win32 build instructions.

Added "--with-openssl-opt=no-asm" argument which is required since
OpenSSL 1.0.2, as OpenSSL started to use assembler by default in 1.0.0 and
then broke builds with MASM in OpenSSL 1.0.2 (ticket #1396).

While here, added "--with-debug", added missing "--http-scgi-temp-path" and
"--http-uwsgi-temp-path", updated OpenSSL to 1.0.2l, switched to slightly
more readable one-argument-per-line style in configure example, added
indentation to continuation lines, removed useless "--builddir=objs" argument
("objs" is the default), and removed useless "-f objs/Makefile" argument
in nmake (nginx generates appropriate Makefile in the current directory).

diff -r 18d876538eee -r 237b67ef69a6 xml/en/docs/howto_build_on_win32.xml
--- a/xml/en/docs/howto_build_on_win32.xml	Tue Oct 17 16:25:41 2017 +0300
+++ b/xml/en/docs/howto_build_on_win32.xml	Tue Oct 17 17:57:36 2017 +0300
@@ -9,7 +9,7 @@
 <article name="Building nginx on the Win32 platform with Visual C"
          link="/en/docs/howto_build_on_win32.html"
          lang="en"
-         rev="8">
+         rev="9">
 
 <section name="Prerequisites">
 
@@ -81,29 +81,41 @@
 cd objs/lib
 tar -xzf ../../pcre-8.41.tar.gz
 tar -xzf ../../zlib-1.2.11.tar.gz
-tar -xzf ../../openssl-1.0.2k.tar.gz
+tar -xzf ../../openssl-1.0.2l.tar.gz
 </programlisting>
 </listitem>
 
 <listitem>
 Run configure script:
 <programlisting>
-auto/configure --with-cc=cl --builddir=objs --prefix= \
---conf-path=conf/nginx.conf --pid-path=logs/nginx.pid \
---http-log-path=logs/access.log --error-log-path=logs/error.log \
---sbin-path=nginx.exe --http-client-body-temp-path=temp/client_body_temp \
---http-proxy-temp-path=temp/proxy_temp \
---http-fastcgi-temp-path=temp/fastcgi_temp \
---with-cc-opt=-DFD_SETSIZE=1024 --with-pcre=objs/lib/pcre-8.41 \
---with-zlib=objs/lib/zlib-1.2.11 --with-openssl=objs/lib/openssl-1.0.2k \
---with-select_module --with-http_ssl_module
+auto/configure \
+    --with-cc=cl \
+    --with-debug \
+    --prefix= \
+    --conf-path=conf/nginx.conf \
+    --pid-path=logs/nginx.pid \
+    --http-log-path=logs/access.log \
+    --error-log-path=logs/error.log \
+    --sbin-path=nginx.exe \
+    --http-client-body-temp-path=temp/client_body_temp \
+    --http-proxy-temp-path=temp/proxy_temp \
+    --http-fastcgi-temp-path=temp/fastcgi_temp \
+    --http-scgi-temp-path=temp/scgi_temp \
+    --http-uwsgi-temp-path=temp/uwsgi_temp \
+    --with-cc-opt=-DFD_SETSIZE=1024 \
+    --with-pcre=objs/lib/pcre-8.41 \
+    --with-zlib=objs/lib/zlib-1.2.11 \
+    --with-openssl=objs/lib/openssl-1.0.2l \
+    --with-openssl-opt=no-asm \
+    --with-select_module \
+    --with-http_ssl_module
 </programlisting>
 </listitem>
 
 <listitem>
 Run make:
 <programlisting>
-nmake -f objs/Makefile
+nmake
 </programlisting>
 </listitem>