[Dart-dev] DART/branches Revision: 11333

[dart at ucar.edu]

hendric at ucar.edu
2017-03-15 11:35:19 -0600 (Wed, 15 Mar 2017)
35
updating notes for current users.




Modified: DART/branches/rma_trunk/documentation/html/Manhattan_release.html
===================================================================
--- DART/branches/rma_trunk/documentation/html/Manhattan_release.html	2017-03-15 17:34:35 UTC (rev 11332)
+++ DART/branches/rma_trunk/documentation/html/Manhattan_release.html	2017-03-15 17:35:19 UTC (rev 11333)
@@ -116,6 +116,8 @@
 <a href="Manhattan_getting_started.html">Getting Started</a> 
 </p>
 
+<!--==================================================================-->
+
 <a name="CurrentUsers"></a>
 <div class="top">[<a href="#">top</a>]</div><hr />
 <h2>Notes for Current Users</h2>
@@ -122,21 +124,39 @@
 
 <p>
 If you have been updating from the development branch of the DART subversion
-repository you will not notice much difference between that
-and the Manhattan release.  If you are still running the Kodiak
-release there are many new models, new observation types,
-capabilities in the assimilation tools, new diagnostics, and
-new utilities.  There is a short list of non-backwards
-compatible changes
+repository you will notice that the code tree has been simplified to be more
+intuitive for users. The new top level directory structure looks like :
+
+  <ul><li> <em class=file>README</em>            </li>
+      <li> <em class=file>COPYRIGHT</em>         </li>
+      <li> <em class=dir >assimilation_code</em> </li>
+      <li> <em class=dir >build_templates</em>   </li>
+      <li> <em class=dir >diagnostics</em>       </li>
+      <li> <em class=dir >documentation</em>     </li>
+      <li> <em class=dir >models</em>            </li>
+      <li> <em class=dir >observations</em>      </li>
+  </ul>
+
+if you do try to do an 'svn update' on an existing directory, you will
+encounter many 'tree conflicts'.
+
+<p>
+We suggest that current users checkout a fresh version of Manhattan.
+to see which files need to be moved to the new location you can use
+'svn status'.  Anything with an M or ? in the first column needs to be moved
+to the new location in the new tree.  Please contact DART if you have any
+issues migrating your existing code to the new tree structure.
+</p>
+
+<p>
+There is a short list of non-backwards compatible changes
 (<a href="#Nonbackward">see below</a>), and then a long list
 of new options and functions.
 </p>
 
+
 <p>
-In the near future we will be making substantial changes to
-the internal structure of DART to accomodate both larger
-models and machines with thousands of processors.  We will
-continue to maintain the Manhattan release with bug fixes, but
+We will continue to maintain the Manhattan release with bug fixes, but
 we will be updating the subversion trunk with new and
 non-backwards-compatible code.
 Checking out the Manhattan release branch and running 'svn update'
@@ -151,9 +171,9 @@
 <h2>Non-backwards Compatible Changes</h2>
 
 <p>
-Changes in the Manhattan release (13 Dec 2013)
+Changes in the Manhattan release (15 May 2015)
 which are <em>not</em> backwards compatible
-with the Kodiak release (30 June 2011):
+with the Lanai release (13 Dec 2013):
 </p>
 
 <ol>
@@ -278,7 +298,7 @@
         that enables a call to a subroutine at the end of the filter.f90 source file.
         That subroutine can be customized by the user to do any computation required.
         See the filter namelist documentation 
-        <a href="https://svn-dares-dart.cgd.ucar.edu/DART/trunk/filter/filter.html#Namelist">
+        <a href="https://svn-dares-dart.cgd.ucar.edu/DART/branches/rma_trunk/assimilation_code/programs/filter/filter.html#Namelist">
         Website</a> or <a href="../../assimilation_code/programs/filter.html#Namelist">local file</a>
         for more details.</li></ul>
 </li>
@@ -290,8 +310,8 @@
         'read inflation values from a file' option set to .true. for all steps instead of
         having to change the namelist after the first cycle.
         See the documentation
-        <a href="https://svn-dares-dart.cgd.ucar.edu/DART/trunk/adaptive_inflate/fill_inflation_restart.html">Website</a> 
-        or <a href="../../assimilation_code/programs/fill_inflation_restart.html">local file</a>
+        <a href="https://svn-dares-dart.cgd.ucar.edu/DART/branches/rma_trunk/assimilation_code/programs/fill_inflation_restart/fill_inflation_restart.html">Website</a> 
+        or <a href="../../assimilation_code/programs/fill_inflation_restart/fill_inflation_restart.html">local file</a>
         for more details.</li></ul>
 </li>
 <br /> 
@@ -306,8 +326,8 @@
         <li>2D annulus coordinate system</li>
         </ul>
         See the documentation
-        <a href="https://svn-dares-dart.cgd.ucar.edu/DART/trunk/location/location_mod.html">Website</a> 
-        or <a href="../../location/location_mod.html">local file</a>