[Swift-commit] r6478 - trunk/docs/designs

[davidk at ci.uchicago.edu]

Author: davidk
Date: 2013-04-18 12:46:54 -0500 (Thu, 18 Apr 2013)
New Revision: 6478

Modified:
   trunk/docs/designs/swiftrun.txt
Log:
Updtes to swiftrun doc


Modified: trunk/docs/designs/swiftrun.txt
===================================================================
--- trunk/docs/designs/swiftrun.txt	2013-04-18 17:46:12 UTC (rev 6477)
+++ trunk/docs/designs/swiftrun.txt	2013-04-18 17:46:54 UTC (rev 6478)
@@ -52,6 +52,8 @@
 4. $HOME/.swift/swift.properties
 5. One or both of $PWD/swift.properties and $PWD/.swift/swift.properties (to
    be determined)
+6. Command line options. Swift will accept parameters on the command line, in
+   the format of -Dexecution.retries=5.
 
 Settings are accumulative. Every swift.properties files that is found is read
 and values are set, with values from the most recent file taking precedence.
@@ -169,6 +171,17 @@
 site.beagle.jobsPerNode=12
 -----
 
+Defining sites in swift.properties
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+We may also want to talk about the ability to define sites directly in
+swift.properties using the existing XML format. The program that parses the
+properties file can attempt to find pool entries there.
+
+NOTE: This came up in discussions, but I think we should try to avoid this
+one. We should be able to shape a sites file using only x.y.z=foo properties. 
+In cases where a user wants to use XML directly, I think they should
+use the -sites.file option.
+
 Run directories and logs
 ------------------------
 Every time Swift runs, it should create a directory called called