[Dart-dev] [6572] DART/trunk/utilities: document a namelist item (write_nml) that has been in the

[nancy at ucar.edu]

Revision: 6572
Author:   nancy
Date:     2013-11-05 11:07:22 -0700 (Tue, 05 Nov 2013)
Log Message:
-----------
document a namelist item (write_nml) that has been in the
code for a while now and was apparently never in the nml file
nor the documentation.

Modified Paths:
--------------
    DART/trunk/utilities/utilities_mod.html
    DART/trunk/utilities/utilities_mod.nml

-------------- next part --------------
Modified: DART/trunk/utilities/utilities_mod.html
===================================================================
--- DART/trunk/utilities/utilities_mod.html	2013-11-05 16:23:22 UTC (rev 6571)
+++ DART/trunk/utilities/utilities_mod.html	2013-11-05 18:07:22 UTC (rev 6572)
@@ -65,7 +65,8 @@
    logfilename    = 'dart_log.out',
    nmlfilename    = 'dart_log.nml',
    module_details = .true.,
-   print_debug    = .false.
+   print_debug    = .false.,
+   write_nml      = 'file'
 /
 </pre>
 </div>
@@ -120,6 +121,17 @@
 can be very verbose and by default are turned off.
 </TD></TR>
 
+<TR><TD>write_nml</TD>
+    <TD>character(len=32)</TD>
+    <TD>String which controls where to write the namelist values that
+are being used for this execution. 
+Valid values are:  'none', 'file', 'terminal', 'both'.  'none' turns
+off this write.  'file' writes a copy only to the <em class=code>nmlfilename</em>.
+Writes are always in append mode, so the most recent information will be
+at the end of an existing file.  'terminal' will write to the job's standard
+output.  'both' will write both to the nml file and the standard output unit.
+</TD></TR>
+
 </TBODY> 
 </TABLE>
 </div>

Modified: DART/trunk/utilities/utilities_mod.nml
===================================================================
--- DART/trunk/utilities/utilities_mod.nml	2013-11-05 16:23:22 UTC (rev 6571)
+++ DART/trunk/utilities/utilities_mod.nml	2013-11-05 18:07:22 UTC (rev 6572)
@@ -3,6 +3,7 @@
    logfilename    = 'dart_log.out',
    nmlfilename    = 'dart_log.nml',
    module_details = .true.,
-   print_debug    = .false.
+   print_debug    = .false.,
+   write_nml      = 'file'
 /