diff --git a/man4/Doxyfile.in b/man4/Doxyfile.in
index 67d41211f..967a04061 100644
--- a/man4/Doxyfile.in
+++ b/man4/Doxyfile.in
@@ -573,6 +573,7 @@ INPUT = \
@abs_top_srcdir@/man4/tutorial.doc \
@abs_top_srcdir@/man4/install.doc \
@abs_top_srcdir@/man4/dispatch.doc \
+ @abs_top_srcdir@/man4/win_netcdf.doc \
@abs_top_srcdir@/man4/guide.doc \
@abs_top_srcdir@/man4/types.doc \
@abs_top_srcdir@/man4/notes.doc \
diff --git a/man4/mainpage.doc b/man4/mainpage.doc
index 7379a9893..f7463e8c3 100644
--- a/man4/mainpage.doc
+++ b/man4/mainpage.doc
@@ -19,6 +19,7 @@ Hartnett, and Dennis Heimbigner
Learn more about netCDF:
- \ref getting
- \ref building
+- \ref windows
- \ref tutorial
- \ref user_guide
diff --git a/man4/win_netcdf.doc b/man4/win_netcdf.doc
new file mode 100644
index 000000000..6180cf65e
--- /dev/null
+++ b/man4/win_netcdf.doc
@@ -0,0 +1,133 @@
+/** \file
+Instructions for building NetCDF on Windows.
+
+\page windows NetCDF on Windows
+
+
+
+
NetCDF for Windows (Current Release: 4.2.1.1)
+
+
+
+
+Overview
+
+Starting with the NetCDF 4.2.1 release, we are happy to provide official Windows and Visual Studio support. Please note that while our goal is full functionality, there will undoubtedly be a number of fixes required as the Windows version begins to see wider adoption. We provide binary downloads for shared and static Windows libraries, as well as instructions for compiling libraries using the MSYS/MinGW environment.
+
+The current NetCDF build for Windows supports NetCDF Classic, NetCDF-4, HDF5, DAP and Diskless functionality.
+
+Currently, Visual-Studio based builds are not supported, but CMake support is being actively developed. Cygwin builds are also supported; for Cygwin environments, follow the MSYS/MinGW instrunctions.
+
+
+Getting NetCDF Libraries for Windows
+
+These libraries can be used with Visual Studio projects. The libraries themselves were tested with Visual Studio 2010. These downloads contain the libraries, the dependent libraries which they were built against, the netcdf utilities (ncgen, ncdump).
+Windows NetCDF 4.2.1.1 Binaries
+
+ - Windows libraries (shared and static):
+
+
+ |
+ 32-bit libraries |
+ 64-bit libraries |
+
+
+ Static (.a, .lib) Libraries |
+
+
+ NetCDF 2/3 Only, No DAP |
+ nc3_32_static.zip |
+ nc3_64_static.zip |
+
+
+ NetCDF-4, HDF5, No DAP |
+ nc4_32_static.zip |
+ nc4_64_static.zip |
+
+
+ NetCDF-4, HDF5, DAP |
+ nc4_dap_32_static.zip |
+ nc4_dap_64_static.zip |
+
+
+
+ Dynamic (.dll) Libraries |
+
+
+ NetCDF 2/3 Only, No DAP |
+ nc3_32_dll.zip |
+ nc3_64_dll.zip |
+
+
+ NetCDF-4, HDF5, No DAP |
+ nc4_32_dll.zip |
+ nc4_64_dll.zip |
+
+
+ NetCDF-4, HDF5, DAP |
+ nc4_dap_32_dll.zip |
+ nc4_dap_64_dll.zip |
+
+
+
+
+
+Compiling Windows NetCDF 4.2.1.1 from Source
+
+ - Install the latest MSYS/MinGW environment for your Windows machine:
+
+
+ - Download the latest NetCDF source code (4.2.1.1).
+ - Install the NetCDF dependencies (as needed):
+ These libraries are optional, and are only required if you want the functionality they provide.
+
+
+ - Configure & Build NetCDF:
+
+ - './configure --[desired options] \
CFLAGS="-fno-stack-check -fno-stack-protector -mno-stack-arg-probe -I[path to dependency include files] " \
LDFLAGS="-L[path to dependency library files]"'
+ Note that the first 3 'CFLAGS' arguments are used to prevent 'unresolved external symbol' errors when using the resulting libnetcdf with Visual Studio.
+ - 'make'
+ - 'make check'
+
+ - The final libraries are located in [NetCDF Root]/liblib/.libs
+ Note: To use static libraries in Visual Studio, you may rename the .a files as .lib files. For Visual Studio 2010 (and possibly previous versions), this is not strictly necessary.
+
+
+Compilation Notes and Gotchas
+
+Building Visual Studio compatible NetCDF under Windows is a fairly complex process. We will eventually mitigate this complexity by integrating CMake-based builds into NetCDF. For the time being, we recommend you download our binary packages. If, for whatever reason, these binaries will not work for you, please be aware of the following when building NetCDF for Windows:
+
+
+- Two versions of any dependency libraries may be required:
+
+ - MSYS/MinGW compatible version, linked against at libnetcdf compile time.
+ These are not necessary if using the libraries downloaded above.
+ - Visual Studio compatible version, used at compile/runtime for your Visual Studio project.
+
+- As outlined above, you must use the following CFLAGS when configuring NetCDF:
+
+ - -fno-stack-check
+ - -fno-stack-protector
+ - -mno-stack-arg-probe
+
+
+
+
+
+*/