[Darshan-commits] [Git][darshan/darshan][dev-modular] small darshan-runtime documentation changes

[Shane Snyder]

Shane Snyder pushed to branch dev-modular at darshan / darshan


Commits:
d7c2e81c by Shane Snyder at 2016-01-21T16:15:41Z
small darshan-runtime documentation changes

- - - - -


1 changed file:

- darshan-runtime/doc/darshan-runtime.txt


Changes:

=====================================
darshan-runtime/doc/darshan-runtime.txt
=====================================
--- a/darshan-runtime/doc/darshan-runtime.txt
+++ b/darshan-runtime/doc/darshan-runtime.txt
@@ -483,20 +483,17 @@ runtime environment variables] are equally applicable to both versions.
 However, we do provide some suggestions and expectations for system administrators to keep in
 mind when upgrading to Darshan 3.x:
 
-* Log file compatibility was broken in the upgrade, and thus 3.x log utilities do not
-work directly with logs generated by 2.x versions of Darshan (and vice versa).
-    - There is currently no tool for converting 2.x logs into the 3.x log format.
-    - The `darshan-logutils` library will provide error messages to indicate whether a given
+* Darshan 2.x and Darshan 3.x produce incompatible log file formats
+    ** log files named *.darshan.gz or *.darshan.bz2: Darshan 2.x format
+    ** log files named *.darshan: Darshan 3.x format
+        *** a field in the log file header indicates underlying compression method in 3.x logs
+    ** There is currently no tool for converting 2.x logs into the 3.x log format.
+    ** The `darshan-logutils` library will provide error messages to indicate whether a given
 log file is incompatible with the correspnonding library version. 
 
-* The darshan log file extension has been changed from `.darshan.gz` (or `.darshan.bz2` for
-log files converted to use bzip2 compression) to `.darshan`.
-    - A field in the Darshan log header is used to indicate whether a log is compressed using
-libz or bzip2 compression.
-
 * We encourage administrators to use the same log file directory for version 3.x as had been
 used for version 2.x.
-    - Within this directory, the determination on which set of log utilities (version 2.x
+    ** Within this directory, the determination on which set of log utilities (version 2.x
 or version 3.x) to use can be based on the file extension for a given log (as explained
 above).
 



View it on GitLab: https://xgitlab.cels.anl.gov/darshan/darshan/commit/d7c2e81c1bd8f5c84bc564d9b61a1da95fa4a8e1
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/darshan-commits/attachments/20160121/39163984/attachment.html>