Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
[Doc] Updated deployment description file.
authorChristian Heinrich <franz-christian.heinrich@inria.fr>
Sat, 12 Sep 2015 18:09:44 +0000 (20:09 +0200)
committerChristian Heinrich <franz-christian.heinrich@inria.fr>
Sat, 12 Sep 2015 18:09:44 +0000 (20:09 +0200)
doc/doxygen/deployment.doc

index 460b2a4..06602e3 100644 (file)
@@ -22,7 +22,9 @@ order in which the \c argument tags are given is important and depends on the ap
 
 #### Attribute list ####
 
-There are optional attributes to the process tag, here is a list of all attributes of this tag:
+As already written above, the \c process tag is the tag that defines which host
+executes which function (from your application). Hence, the \c host and \c function
+attributes are mandatory; however, there are some optional attributes to the process tag. Here is a list of all attributes of this tag:
 
 | Attribute name  | Mandatory | Values                 | Description                                                                                                               |
 | --------------- | --------- | ---------------------- | -----------                                                                                                               |
@@ -32,10 +34,34 @@ There are optional attributes to the process tag, here is a list of all attribut
 | kill_time       | no        | int (Default: -1.0)    | The simulated time when this function will end to be computed. By default, it stops only when it's done.                  |
 | on_failure      | no        | DIE\|RESTART (Default: "DIE")   | What should be done when the process fails.                  |
 
-### An example ###
+#### An example ####
 
 A complete example including a \ref MSG_ext_ms_application "deployment file" can be found 
 in the Section \ref MSG_ex_basics "MSG basics".
 
+See also files such as \c examples/msg/masterslave/deployment_masterslave.xml.
+
+### The argument tag ###
+
+This tag must always be contained by a \c process tag - it doesn't make sense
+without it.
+
+The way this works is that the order of arguments must be pre-defined <i>by the user</i>:
+It is totally up to you what <i>your</i> code expects as arguments and in which
+order. The arguments will be passed to your code (that is: to the function 
+executed by this process) in the order you declare them.
+
+#### Attribute list ####
+
+| Attribute name  | Mandatory | Values                 | Description                                                                                                               |
+| --------------- | --------- | ---------------------- | -----------                                                                                                               |
+| value           | yes       | String                 | Contains the value for this parameter |
+
+#### An example ####
+
+A complete example including a \ref MSG_ext_ms_application "deployment file" can be found 
+in the Section \ref MSG_ex_basics "MSG basics".
+
+See also files such as \c examples/msg/masterslave/deployment_masterslave.xml.
 
 */