[svn-r10934] Purpose:

Add html document for windows users Description: Solution: Platforms tested: Misc. update:
author: Fang Guo <fangguo@ncsa.uiuc.edu> 2005-06-17 17:08:41 (GMT)
committer: Fang Guo <fangguo@ncsa.uiuc.edu> 2005-06-17 17:08:41 (GMT)
commit: b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7 (patch)
tree: 9992d6f33de825f2a0940eb40a48d4f48d378bac /release_docs/INSTALL_Windows_Short_Net.htm
parent: 8896b0239429757f52bc129dbc9d2755ab5b4ccc (diff)
download: hdf5-b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7.zip
hdf5-b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7.tar.gz
hdf5-b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7.tar.bz2
1 files changed, 280 insertions, 0 deletions
diff --git a/release_docs/INSTALL_Windows_Short_Net.htm b/release_docs/INSTALL_Windows_Short_Net.htm
new file mode 100755
index 0000000..be766fc
--- /dev/null
+++ b/release_docs/INSTALL_Windows_Short_Net.htm
@@ -0,0 +1,280 @@
+<HTML>
+<HEAD>
+<META NAME="GENERATOR" Content="Microsoft Visual Studio 6.0">
+<TITLE>HDF5 Build and Install Instructions for Windows XP with MSVS .NET 2003</TITLE>
+<style type="text/css">
+
+h1 {
+   font-family:font-family:times, arial, 'lucida console', sans-serif;
+   font-size: 180%;
+   font-style:bold;
+   color:#0000FF;
+   text-align:center;
+   text-transform:capitalize;
+   }
+h2 {
+   font-family:font-family:times, arial, 'lucida console', sans-serif;
+   font-size: 160%;
+   font-style:bold;
+   color:#0000FF;
+   text-align:center;
+   text-transform:capitalize;
+   
+   }
+h3 {
+   font-family:font-family:times, arial, 'lucida console', sans-serif;
+   font-size: 140%;
+   font-style:bold;
+   color:#0000FF;
+   text-transform:capitalize;
+   }
+h4 {
+   font-family:font-family:times, arial, 'lucida console', sans-serif;
+   font-size: 120%;
+   font-style:bold;
+   color:#0000FF;
+   }
+h5 {
+   font-family:font-family:times, arial, 'lucida console', sans-serif;
+   font-size: 110%;
+   font-style:bold;
+   color:#0000FF;
+   }
+
+p.right{text-align:right;color:#A52A2A;}
+p {
+   font-family:font-family:times, arial, 'lucida console', sans-serif;
+   font-size: 110%;
+   text-align:left;
+   
+  }
+p.note{
+   font-family:font-family:times, arial, 'lucida console', sans-serif;
+   font-size: 110%;
+   text-align:left;
+   color:#FF0000
+  }
+  
+ul.normal
+{
+margin-left:10%;
+list-style-type:none;
+margin-bottom:15px;
+}
+ul.intable
+{
+text-align: left;
+list-style-type:none;
+}
+td {font-family:font-family:times, arial, 'lucida console', sans-serif;
+   font-size: 110%;
+   text-align:left;
+	padding:10;
+	}
+a {text-decoration:none}
+a:link {color:#0000FF;}
+a:visited {color:purple;}
+a:hover {background-color:#FAEBD7;}
+table {
+      font-family:font-family:times, arial, 'lucida console', sans-serif;
+      font-size: 100%;
+      text-align:left;
+      border:thin solid blue;
+      }
+      
+body {
+     margin-left:5%;
+     margin-right:5%
+     }
+hr.first {color:#0000FF; height:4px;width:100%;magin-top:10px;margin-bottom:10px;border:thick double blue;}
+hr.second{color:#0000FF;height:2px; width:100%;magin-top:5px;margin-bottom:5px;border:thin dotted;}
+
+</style>
+</HEAD>
+<BODY>
+<h1>HDF5 Build and Install Instructions for Windows XP with MSVS .NET 2003</h1>
+<p style="TEXT-ALIGN: center">(Short Version)</p>
+<hr class="first" >
+<p class="note">Notes:</p>
+
+	  <p>1. This short instruction is written for users who want to quickly
+      build HDF5 library and tools from the HDF5 source code package
+      with Microsoft Visual Studio .NET 2003 but do not want to know HDF5 
+      building and installation details on Windows XP.</p>
+      <P>2. For detailed HDF5 build and install information, or if you have
+      trouble following any steps in the instructions, please refer to
+      INSTALL_Windows.html for further information.</P>
+      <p>3. For users who would like to build and test HDF5 package from the
+      command line, please refer to
+      INSATLL_Windows_From_Command_Line.txt.</p>
+      <p class="note">Warnings: Please read CAREFULLY about HDF5 build and install preconditions and 
+notes in INSTALL_Windows.html before starting below procedures.</p>
+
+<hr class="second" >
+<h2>Preconditions:</h2>
+<hr class="second" >
+
+<h3>a. Setup path Visual Studio .Net 2003 Compiler. </h3>
+<p>  Open "System" in Control Panel.</p>
+<p>On the "Advanced" tab, click "Environment Variables", click 
+   "Path" in the "System variables" box, then click "Edit" and 
+   add your Visual C++ .Net path (For example, 
+   C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\IDE)
+   into "Variable Value" and click "OK". </p>
+   <h3>b. Set up path for external libraries and headers</h3>
+   <p>Skip this part if you don't want to use ANY compression features     
+    provided by HDF5. Read <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#section5" target=_blank>Section V in INSTALL_WINDOWS.html</A>.
+    </p>
+    <p>You have to read this part even if you want to only use Zlib         
+    or Szip.  You also need to read <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#section5" target=_blank>Section V in INSTALL_WINDOWS.html</A> . </p><p>Invoke Microsoft Visual C++ .Net and go to "Tools" and select             
+    "Options". In the left pane of  "Option" window poped up,
+    choose and extend "Projects", Click on "VC++ Directories".
+    In the right pane, Find the box "Show directories for", choose                          
+    "Include files", if you can not find your Zlib and Szip              
+    header path                                                          
+    (for example, c:\zlib122\include, c:\szip\include)                   
+    from the directory list, add the header path                         
+    (c:\zlib122\include, c:\szip\include) to the                         
+    included directories.  </p><p>Find the box "Show directories for", choose "Library files",         
+    If you cannot find your Zlib and Szip library path                   
+    (for example, c:\zlib122\lib, c:\szip\dll)                           
+    from the directory list, add the library path                        
+    (c:\zlib122\lib, c:\szip\dll) to the library directories. </p>         
+<hr class="second" >
+<h2>STEP 1: Building HDF5 Libraries and Tools</h2>
+<hr class="second" >
+<h3>1. Open all.dsw workspace</h3><p class="note">Notes:</p><p>Notes: all.sln is for command use only. Please open all.dsw not all.sln.</p><p>Invoke Microsoft Visual C++ .Net 2003.  From the main        
+   menu, go to "File" and select "Open Solution". In            
+   the "Open Solution" window, Change "Files of type" to        
+   "All Project Files". Choose "all.dsw" under the directory    
+   c:\MyHDFstuff\hdf5\windows\proj\all. In the pop up window,   
+   chooise "Yes To All" to convert all project files to Visual  
+   C++ .Net project format.</p>                          
+   
+<h3>2. Building HDF5 C and C++ Libraries </h3><p>Users can choose the desirable libraries to be built according
+   to the following describtion.</p>   <ul class="intable">		<li><h4>2.1 If you don't want to build HDF5 C++ Libraries</h4>			<p>Go to "Build" and select "Configuration Manager". Choose "Release"      
+				or "Debug" under "Active Solution Configuration"</p>			<p>Disable the following projects:</p>				<ul class="normal">						
+							<li>dsets_cpp 
+      						<li>dsets_cppdll 
+      						<li>hdf5_cpp 
+      						<li>hdf5_cppdll 
+      						<li>testhdf5_cpp 
+      						<li>testhdf5_cppdll 
+      						<li>hdf5_hl_cpp 
+      						<li>hl_test_table_cpp</li>
+      			</ul>      		<p>Click on "OK", From the main menu, choose "Build"-&gt; "Build" or  
+				"Rebuild ALL" to build both release and debug version of HDF5 
+				Libraries. 			</p>				<li><h4>2.2 If you don't want to build HDF5 Fortran Libraries</h4>			<p>Go to "Build" and select "Configuration Manager". Choose "Release"      
+			   or "Debug" under "Active Solution Configuration"			</p>						<p>Disable the following projects:</p>					<ul class="normal">						
+							<li>flush1_fortran 
+      						<li>flush1_fortrandll 
+      						<li> flush2_fortran 
+      						<li>flush2_fortrandll 
+      						<li>hdf5_f90cstub 
+      						<li>hdf5_f90cstubdll 
+      						<li>hdf5_fortran 
+      						<li>hdf5_fortrandll 
+      						<li>hdf5_hl_fortran 
+      						<li>hl_test_image_fortran 
+      						<li>hl_test_lite_fortran 
+      						<li>hl_test_table_fortran 
+      						<li>libtest_cstubdll 
+      						<li>libtest_fortran 
+      						<li>libtest_fortrandll 
+      						<li>testhdf5_fortran 
+      						<li>testhdf5_fortrandll</li>					
+      				</ul>      		<p>Click on "OK", From the main menu, choose "Build"-&gt; "Build" or  
+				"Rebuild ALL" to build both release and debug version of HDF5   
+				Libraries. 			</p>		<li><h4>2.3 If you don't want to build HDF5 High-Level Libraries</h4>			<P>Go to "Build" and select "Configuration Manager". Choose "Release"      
+				or "Debug" under "Active Solution Configuration"			</P>			<p>Disable the following projects:</p>				<ul class="normal">					<li>hdf5_hl 
+    					<li>hl_test_image 
+    					<li>hl_test_lite 
+    
+					<li>hl_test_table 
+    					<li>hl_test_ds 
+    					<li>hl_test_packet</li>
+				</ul>			<p>Click on "OK", From the main menu, choose "Build"-&gt; "Build" or  
+				"Rebuild ALL" to build both release and debug version of HDF5   
+				Libraries. 			</p>		<li><h4>2.4 If you don't want to build HDF5 C++ High-Level&nbsp;Libraries</h4>			<p>Go to "Build" and select "Configuration Manager".        
+				Choose "Release" or "Debug" under "Active Solution Configuration"			</p>  
+				                                                                        
+			<p>Disable the following projects:</p>				<ul class="normal">						<li>hdf5_hl_cpp 
+    						<li>hl_test_table_cpp</li>				</ul>			<p>Click on "OK", From the main menu, choose "Build"-&gt; "Build" or  
+				"Rebuild ALL" to build both release and debug version of HDF5   
+				Libraries.			</p>		<li><h4>2.5 If you don't want to build HDF5 Fortran High-Level Libraries</h4>			<p>Go to "Build" and select "Configuration Manager". Choose "Release" or "Debug" under "Active Solution Configuration".</p>			<p>Disable the following projects:</p>				<ul class="normal">					<li>hdf5_hl_fortran 
+    					<li>hl_test_image_fortran 
+    					<li>hl_test_lite_fortran 
+    					<li>hl_test_table_fortran</li>				</ul>			<p>Click on "OK", From the main menu, choose "Build"-&gt; "Build" or 
+				"Rebuild ALL" to build both release and debug version of HDF5
+				Libraries.			</p>		</li>	</ul><hr class="second" >
+
+<h2> STEP 2: Testing HDF5 Libraries and Tools </h2><hr class="second" >
+
+<p>HDF5 libraries and tools should be tested to make sure that they were
+built correctly.</p><p>HDF5 libraries and tools can be tested with hdf5check.bat batch file 
+in c:\MyHDFstuff\hdf5 directory.</p><p>hdf5check.bat has four options:</p>
+
+   <div style="TEXT-ALIGN: center">
+       		<table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid">
+		 		<tr>
+		 			<th>Options</th>
+		 			<th>Illustration</th>
+		 		</tr>
+		 		<tr>
+		 			<td><p>hdf5check</p></td>
+		 			<td><p>test HDF5 C library and tools only</p></td>
+		 		</tr>
+		 		<tr>
+		 			<td><p>hdf5check enablecpp</p></td>
+		 			<td><p>test HDF5 C/C++ libraries and tools.</p>
+		 			</td>
+		 		</tr>
+		 		<tr>
+		 		<td><p>hdf5check enablefortran</p></td>
+		 		<td><p>test HDF5 C/FORTRAN libraries and tools</p>
+		 		</td>
+    	 		</tr>
+		 		<tr>
+		 		<td><p>hdf5check enableall</p></td>
+		 		<td><p>test HDF5 C/C++/FORTRAN libraries and tools</p>
+		 		</td>
+		 	</tr>
+		 </table>
+	</div>
+   
+  <p>Invoke a command prompt window and run hdf5check with appropriate
+	options.</p>
+  <p>Test results are saved into file:</p>
+  <ul class="normal">
+	<li>c:\MyHDFstuff\hdf5\check_results.txt</li>
+  </ul>
+  <p>Check check_results.txt and there should be no failures at all.</p>
+  <p>If you want to test HDF5 libraries and tools one by one, please refer to
+	<A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#step2_section2" target=_blank>Section II, step 2 in INSTALL_Windows.html</A>.</p>
+<hr class="second" >
+
+<p>Check check_results.txt and there should be no failures at all.</p>
+  <p>If you want to test HDF5 libraries and tools one by one, please refer to
+	<A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#step2_section2" target=_blank>Section II, step 2 in INSTALL_Windows.html</A>.</p>
+<hr class="second" >
+<h2>STEP 3: Installing HDF5 Libraries</h2>
+<hr class="second" >
+
+<p>Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install 
+all HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory.</p>
+<hr class="second" >
+<h2>STEP 4: Building HDF5 Examples (Optional)</h2>
+<hr class="second" >
+<p>Please read <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#step4_section2" target=_blank>section II, step 4 in INSTALL_Windows.html.</A></p>
+
+<h4 style="COLOR: white; BACKGROUND-COLOR: green">Thank you for using Hierarchical Data Format (HDF). For users who need further assistance, please
+send email to <A href="mailto:hdfhelp@ncsa.uiuc.edu">hdfhelp@ncsa.uiuc.edu</A></h4>
+<p>&nbsp;</p>
+<p>&nbsp;</p>
+
+
+       
+
+
+</BODY>
+</HTML>
author	Fang Guo <fangguo@ncsa.uiuc.edu>	2005-06-17 17:08:41 (GMT)
committer	Fang Guo <fangguo@ncsa.uiuc.edu>	2005-06-17 17:08:41 (GMT)
commit	b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7 (patch)
tree	9992d6f33de825f2a0940eb40a48d4f48d378bac /release_docs/INSTALL_Windows_Short_Net.htm
parent	8896b0239429757f52bc129dbc9d2755ab5b4ccc (diff)
download	hdf5-b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7.zip hdf5-b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7.tar.gz hdf5-b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7.tar.bz2