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

+ +

Compiling Windows NetCDF 4.2.1.1 from Source

+
    +
  1. Install the latest MSYS/MinGW environment for your Windows machine:
  2. + + +
  3. Download the latest NetCDF source code (4.2.1.1).
  4. +
  5. Install the NetCDF dependencies (as needed):
  6. + These libraries are optional, and are only required if you want the functionality they provide. + + +
  7. Configure & Build NetCDF:
  8. + +
  9. The final libraries are located in [NetCDF Root]/liblib/.libs
  10. + 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:

+ + + + + +*/